Skip to end of metadata
Go to start of metadata

Installing Objavi

Installation of Objavi is split into three steps: installing prerequisites, getting the Objavi source code and creating an Objavi site.


Objavi depends on a number of external tools and libraries for it's operation. Package names might vary depending on the operating system you are using.

The following demonstrates installing prerequisite packages on Ubuntu 12.04:

sudo apt-get install psutils poppler-utils pdftk pdfedit
sudo apt-get install texlive-latex-base fontconfig xvfb calibre
sudo apt-get install supervisor apache2 libapache2-mod-wsgi redis-server
sudo apt-get install python-dev python-django python-redis python-lxml python-uno
sudo pip install django-celery

The HTML to PDF converter (wkhtmltopdf) should be downloaded from its respective home page manually. Make sure you choose the binary that matches your architecture (i386 or amd64). The following snipped demonstrates installing wkhtmltopdf on i386:

bunzip2 -c wkhtmltopdf-0.11.0_rc1-static-i386.tar.bz2 | tar xf -
sudo mv wkhtmltopdf-i386 /usr/local/bin/wkhtmltopdf

To use the beta PDF renderer you need to have its binary somewhere in the PATH, e.g. in /usr/local/bin. The source code for the Objavi Renderer is on GitHub, and can be obtained by cloning the repository. Binaries for x86 and AMD-64 architectures are available from you're getting a binary version make sure you download the package for your architecture. An INSTALL.txt file is included, just follow the instructions.

To create ODF output, you also need a whole lot of OpenOffice or LibreOffice 3.

Getting the code

The easiest way to obtain the Objavi source code is to clone the official Objavi git repository:

git clone git://

After unpacking the sources go to the Objavi's top-level directory and make sure that all files in the "bin" directory are executable.

Objavi also requires some sources from its sister project Booktype. If you don't already have Booktype sources on the system get them from the same place you got Objavi from:

git clone git://

Creating a Site

Once you have everything in place you are ready to create an Objavi site.

The 'create_site' script located in the 'scripts' directory of the Objavi source tree does exactly that. The script requires a destination directory where the site will be created.

The following command creates an Objavi installation inside /var/www/objavi_site:

./scripts/create_site /var/www/objavi_site

Make sure you have the write permissions for the destination directory.

If you don't have Booktype installed globally on the system (i.e. somewhere in the PYTHONPATH) you will have to specify the path to Booktype's source directory when running the script, e.g.:

./scripts/create_site --with-booktype=/usr/local/src/Booktype /var/www/objavi_site

If the site was successfully created the script will notify you that a file named POST_INSTALL.txt has been created there and that you should read it. To complete the installation simply follow the instructions found in the POST_INSTALL.txt file.

  • No labels

1 Comment

  1. Installing to /var/www/objavi caused problems for me, you might want to try changing the name of the directory to anything other than "objavi"even just making it uppercase would let the install work...
    ./scripts/create_site /var/www/Objavi