Sourcefabric Manuals

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

Booktype 1.6 para autores y editores

Installation on OS X

More or less you will use terminal window to do everything. First you need to create a proper environment. Where you can use easy_install for python tools install and for redis-server we will use Homebrew. Check their page (url: to make first time install.

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 apple ID for that) and xcode which can be downloaded using macosx app store. After successful installation of Homebrew do “brew install redis”.

It’s time to install Booktype now. Before everything I recommend (you don’t need to do it, just a recommendation) to create a virtual environment with:

easy_install virtualenv

and start it with:

virtualenv myvirtenv
cd myvirtenv
source bin/activate

You also need to install a pil library with easy_install pil (it is an image manipulation package for python)

Skip all the apt-get’s (it’s a Debian/Linux thing anyway)

easy_install django
easy_install simplejson
easy_install south
easy_install lxml

(as said skip apt-get, libraries will be installed during installation process)

easy_install unidecode

Now it’s the time to install Booktype. I have used the latest version from github, so you’ll need git for that (I think it’s part of Developer tools)

so do the git clone (according to INSTALL document from sourcefabric)

Let’s try what we did.
Open two terminals and in one type in redis-server

Create mybooki now with:

./createbooki --database sqlite $HOME/mybooki
go to the directory
and since we are using django 1.4 you need to correct some settings:

        'default': {
                'ENGINE': 'django.db.backends.sqlite3',
                'USER': '',
                'PASSWORD' : ''
for database. And 




type in: . ./booki.env

Then populate database with data: syncdb --noinput migrate createsuperuser
(if you get an unknown locale: UTF-8 error try to do: export LC_ALL=en_US.UTF-8; export LANG=en_US.UTF-8 before that) loaddata documentation_licenses

That's more like it: runserver
Then try in browser localhost:8000


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

You should refresh this page.