Compiling and installing on Unix

Required

The following requirements exist for building Cherokee:

  • Building tools: Cherokee is built on top of the autoconf and automake tools, hence your systems has to have some basic system programs like a sh shell, make and an ANSI C compiler. We have compiled Cherokee in various platforms with different compilers, so it shouldn't be a problem.

Optional

  • Python: Cherokee includes a number of Quality Assurance tests written in Python language. If you are planning to contribute code into the project, or you just want to test everything is working in the server, you will need a Python interpreter installed on your system.

  • Python docutils: in order to generate the documentation from text files.

  • TLS libraries: Cherokee supports two different SSL/TLS libraries: OpenSSL and GNUTLS. You need to have one of those libraries with its development files.

Quickstart

  1. Download a fresh copy of Cherokee

  2. Configure the package for your system:

    ./configure --localstatedir=/var --prefix=/usr --sysconfdir=/etc --with-wwwroot=/var/www
  3. Compile the package:

    make
  4. Install the programs and any data files:

    make install
  5. Start Cherokee admin

Advanced parameters

If you want to learn more about configure you can run ./configure —help

Parameter Description
—with-wwwroot=DIR Specify the webserver root directory
—disable-epoll Disable epoll() support
—disable-pthread Disable threading support
—disable-readdir_r Disable readdir_r usage
—disable-ipv6 Disable IPv6 support
—disable-pam Disable PAM support
—disable-tls Disable TLS/SSL support
—enable-tls= gnutls|openssl

Autostart

If you need the cherokee webserver to start at boot (through init's runlevel) you can find a start/stop script in the contrib source directory:

cp contrib/cherokee /etc/init.d/

Additionally, you need to create symlinks at the correct rc directory of the appropiate runlevel. This can can be done in many ways and usually each distribution offers its own tools to do so.