Sourcefabric Manuals

 English |  Español |  Français |  Italiano |  Português |  Русский |  Shqip

Booktype 2.1 for Authors and Publishers

Automated install on Debian or Ubuntu GNU/Linux

Ready-made packages of Booktype are available for Debian and Ubuntu GNU/Linux via secure apt. This is the recommended installation method for Booktype, because it offers automatic updates and resolution of package dependencies.

You should follow the chapters Setting up the database and (optionally) Installing a PDF renderer before you install Booktype. This guide assumes that you have sudo or root powers on the target server - if not, you need to ask your system administrator to install Booktype for you.

Setting up the secure apt repository

To add the repository that contains Sourcefabric software, including Booktype, open the sources.list file in the nano editor with:

sudo nano /etc/apt/sources.list

Type your password, and the sources.list file will open. For Debian jessie, scroll to the end of this document and add the following lines:

# Booktype
deb http://apt.sourcefabric.org/ jessie main

For Ubuntu 14.04 LTS 'Trusty', substitute trusty in place of jessie. Press Ctrl+O to write out the sources.list file, and Ctrl-X to quit the nano editor.

You now need to update your sources. Type:

sudo apt-get update

You will probably see an error message about a missing public key. To fix this system error, you need to install the sourcefabric-keyring package, which contains the package signing key. This encryption key is a security measure which helps ensure that the Booktype packages you will download in future have not been tampered with by a third party.

sudo apt-get install sourcefabric-keyring

When prompted, press the y key on your keyboard to install the sourcefabric-keyring package without verification. If you wish to verify the authenticity of the package signing key, please contact Sourcefabric for assistance.

Update your sources again, to confirm that you are now using a trusted software repository:

sudo apt-get update

You should no longer see the error message about the public key.

Installing the Booktype package

After confirming that the secure apt repository is set up, you can install the Booktype package with the command:

sudo apt-get install booktype

This command will install all of the Booktype components, plus other packages that Booktype requires in order to run.

The Booktype package installer will ask if you want to set up a default instance automatically. Use the cursor keys on your keyboard to highlight your answer. Press the Tab key to highlight the <OK> button and press the Enter key to continue.

If you answer "no thanks", Booktype files will be installed, but an instance will not be created. You will need to set up the instances that you require by following the method shown in the chapter Manual installation on GNU/Linux.

Automatic configuration

If you answer "yes please", the installer will ask further questions about the default instance. More details of these configuration values are shown in the chapter Manual installation on GNU/Linux.

The first five questions are about the Booktype database. Refer to the details of the PostgreSQL database which you created earlier.

Name of the Booktype database

Database username

Database password

Database hostname

Database port number

The next three questions are for setting up the Booktype system administrator account.

Administrator name

Administrator email

Administrator password

The following two questions are about the default Booktype instance which will be created.

Name of the instance

Domain of the instance

There are three questions about email configuration for the instance.

Email from address

Email server

SMTP port

You can also set the name of the default publisher for new books.

Default publisher

The next four questions relate to the Redis server. For a simple configuration on a single server, with no other applications using Redis, you can use the defaults.

Redis hostname

Redis port

Redis number

Redis password

The final two questions concern the default time zone and interface localisation.

Time zone

Interface language code

After these installation questions, Booktype's libraries will be installed, which can take a few minutes.

Library installation

Finally, check that Booktype is running. Open a web browser with the URL of the Booktype instance that you have installed, such as http://booktype.example.com. If you see the Booktype homepage, you can now proceed to the chapter Getting Started.

Errata

If you chose to set up a default instance automatically, and see the error at the end of the package installation:

CommandError: Could not create the user.

this is due to a bug in Booktype, which can be misleading. If the user account you created for the Booktype administrator can be used to log in to the Booktype instance homepage, all is well.

There has been error in communication with Booktype server. Not sure right now where is the problem.

You should refresh this page.