Sourcefabric Manuals

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

Booktype 2.3 for Authors and Publishers

Manual installation on OS X

Before installing Booktype on an OS X machine, you need to create a suitable environment. You can use the command line tool pip to obtain the necessary Python dependencies and Homebrew to install Redis. The page at provides instructions for a first time install of Homebrew.

To use Redis you need to install Command Line Tools for Xcode which can be found at the Apple developer web pages ( - you'll need an Apple ID before you are allowed to download), and xcode which can be downloaded using the OS X app store.

After the successful installation of Homebrew, open a terminal and enter the command:

brew install redis

To download Booktype from the source code repository you'll need git from or the native GitHub application from

Once git is installed, you can download Booktype 2.0 with the command:

git clone --branch 2.0 --depth 1 --single-branch

Then install the Python dependencies for a development install with sqlite, using the commands:

easy_install pip
pip install -r booktype/requirements/dev.txt

Optionally, you can install these Python packages in a virtualenv (Python virtual environment).

Open another terminal, and enter the command:


to run Redis.

Back in the original terminal, where you downloaded Booktype with git, change to the scripts directory and create a Booktype instance called 'mybooktype' and a sqlite database with the commands:

cd scripts
./createbooktype --check-versions --database sqlite $HOME/mybooktype

Change to the target directory $HOME/mybooktype and edit the settings/ and settings/ files to suit your installation. In this example we are using a python virtualenv and the sqlite3 database:

        'default': {
                'USER': '',
                'PASSWORD' : ''

Load the environment variables, with the command:

. ./booktype.env

Then populate the database with data and complete the installation: syncdb --noinput migrate createsuperuser collectstatic compress update_permissions

If you get an unknown locale: UTF-8 error try the command:

export LC_ALL=en_US.UTF-8; export LANG=en_US.UTF-8

before running the above commands again. Finally, run a test server on an unused port, such as port 8005, with the command: runserver

Then open the localhost IP address and the specified port in your web browser, for example and you should see the test server.

You can sign in to the test server using the superuser account details that you created in the installation step above.

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

You should refresh this page.