Zotonic runs on Linux, Mac OS X and (not officially) on Windows.
Before running Zotonic, you must make sure your system meets the minimum requirements to do so. Zotonic needs the following software installed:
- Erlang/OTP version 18 or newer. Build it from source, or use packages.
- ImageMagick (version 6.5 or higher) for the
identifytools. Make sure that the convert and identify tools are in your path so that zotonic can find them. For auto-rotation to work you’ll need the
exifutility as well.
- PostgreSQL version 8.4 or higher. Enable trust-authentication (username+password) in Postgres (see below).
- make A recent version of the GNU
- git Zotonic comes with a few subprojects which are pulled from
the web with the
If you meet these requirements, head straight on to Installation, otherwise, read on below for the specifics on these.
You can check if you have Erlang installed by typing the following command in a terminal:
The output should be something like:
Erlang/OTP 18 [erts-7.1] [source] [64-bit] [smp:4:4] [async-threads:10] [hipe] [kernel-poll:false] Eshell V7.1 (abort with ^G) 1>
(Press ctrl+c twice to exit)
If your version is below release 18, you need to upgrade. If you don’t have Erlang installed, we recommend downloading a build for your operating system from the Erlang Solutions website:
You can check if you have ImageMagick installed by typing the following command in a terminal:
$ convert -version
This tells you which version of ImageMagick is installed:
Version: ImageMagick 6.7.7-10 2012-08-17 Q16 http://www.imagemagick.org
You can check if you have PostgreSQL installed by typing the following command in a terminal:
$ psql -V
Returns the PostgreSQL version:
psql (PostgreSQL) 9.1.6
Enabling trust-authentication in PostgreSQL¶
To let Postgres users access the database from Zotonic, you need to
make a configuration change in Postgres’ configuration file
On Linux, this file is located in
version>/main/pg_hba.conf. Add the following lines:
# Zotonic settings local all zotonic ident host all zotonic 127.0.0.1/32 md5 host all zotonic ::1/128 md5
These settings assume that your Zotonic sites are going to connect
with a Postgres user called
zotonic. For other user names, adjust
accordingly. Do not forget to restart Postgres after you’ve made this
Ubuntu / Debian¶
We recommend you install Erlang from the Erlang solutions website:
The other requirements are easily fetched with
sudo apt-get install build-essential postgresql imagemagick git
If you’re running on FreeBSD, make sure you’ve got the ‘GNU’ ‘make’
make --version, which should give you GNU, and version
info). If you don’t have GNU make, Zotonic will give an error when
trying to compile.
Mac OS X¶
With Homebrew you can install Erlang and ImageMagick using the following commands:
brew install erlang brew install imagemagick
Alternatively, with MacPorts:
sudo port install erlang +ssl sudo port install ImageMagick
For PostgreSQL choose either:
Currently, Zotonic is not officially supported on the Windows platform. However, the main dependencies Erlang, PostgreSQL and ImageMagick do work on Windows, so, if you’re adventurous, it should be possible to get it running.
We have included user-contributed
batch-scripts which used to work on Windows, but have not been kept
up-to-date with recent changes. Expect some major tweaking to get this
ack on track.