Sourcefabric Manuals

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

Booktype 1.6 for Authors and Publishers

Installation on OS X

Before installing Booktype on an OS X server, you need to create a suitable environment. You can use the command line tools easy_install 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

Then install the Python dependencies, with the commands:

easy_install django
easy_install lxml
easy_install pil
easy_install simplejson
easy_install south
easy_install unidecode

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

Now it's time to install Booktype. 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 with:

git clone

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 'mybooki' with the command:

./createbooki --database sqlite $HOME/mybooki

Change to the target directory and edit the file to suit your installation. In this example we are using a python virtualenv and an sqlite3 database:

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

Then edit TEMPLATE_LOADERS to read:


Load the environment variables, with the command:

. ./booki.env

Then populate the database with data: syncdb --noinput migrate createsuperuser loaddata documentation_licenses

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 with: runserver

Then open http://localhost:8000/ in your web browser to see the test server.

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

You should refresh this page.