The feincms-in-a-box project template has a few prerequisites. This page explains how to prepare your system for the initial setup and continued development.

Operating system-specific instructions

Debian and Ubuntu

Install the following libraries, tools and services:

sudo apt-get install build-essential python-dev python-pip \
python-virtualenv libjpeg8-dev liblcms2-dev libopenjpeg-dev libwebp-dev \
libpng12-dev libtiff4-dev libxslt1-dev libfreetype6-dev \
postgresql-9.3 postgresql-server-dev-9.3 gettext npm redis-server


Other versions of PostgreSQL will work as well if you are running a different version of Debian or Ubuntu.


An installation of the Xcode command line tools is required:

xcode-select --install

It is recommended to use Homebrew for all additional dependencies:

brew install gettext libxslt libxml2 jpeg freetype libpng
brew install libtiff node postgresql redis sqlite
brew link --force gettext libxml2 libxslt

It will also help to add a clean installation of Python:

brew install python python3

It is not required to set up an installation of PostgreSQL which runs in the background. Adding the following lines to your ~/.bash_profile and starting postgres in the shell is good enough for local development:

echo "export PGDATA=/usr/local/var/postgres" >> ~/.bash_profile

You can also just install the Postgres App. You then need to add the app to the PATH variable (depending on the version):



You’ll have to open a new Terminal, otherwise the PGDATA of .profile environment variable will not be available.

Python-based command line tools

We also require a few Python-based command line tools, virtualenv, Fabric and flake8:

pip install -U pip
pip install -U setuptools
pip install -U wheel
pip install -U virtualenv fabric flake8

Node-based command line tools

Update npm:

npm install -g npm

Install the following packages using npm (not required for recent projects, we have mostly stopped using those tools):

npm install -g bower jshint gulp

The following tools are recommended:

npm install -g npm-check-updates