IndexGetting startedInstallation

Installation on Windows

The latest Windows bundled release is available at the Windows download section of the Cherokee Project website.

Quickstart

The installation process requires little explanation, as it is simply a matter of pointing and clicking.

You have to check the desired components to be installed, select the desired installation path and that's it.

However, if you want to try out the latest development release or simply want to compile from source, you will need to setup a proper building environment.

Configuring the building the environment

Cherokee for Windows runs in fully native mode, but the environment for its development has always been Unix/Linux. Building in non-native mode (i.e., using Cygwin) would incur in a big loss of performance, though it would be much simpler to maintain and build.

However, a big effort is done to ensure Cherokee's complete cross-platform compatibility. To be able to build Cherokee you will need a unix-like environment that provides the necessary tools listed in the requirements section. Unfortunately this environment is far from trivial to set up.

You can either follow these instructions on how to accomplish such task, or simply download the Win32 preconfigured building environment bundle provided by the Cherokee-Project and skip the rest of this section, right to the building part.

This is what you need to install. Check the MinGW site to download most of the software mentioned in the following lines.

MinGW: minimalist GNU for Windows (GCC & binutils)
MSYS: Minimal SYStem
MSYS DTK: Dev Toolkit
Update Autoconf & Automake
Pthreads Win32: POSIX Threads
Python

Building

  1. Download a fresh copy of Cherokee

  2. Configure the package for your system:

    ./configure --prefix=/usr --sysconfdir=/etc --localstatedir=/var  \
    --enable-trace --enable-static-module=all --enable-static         \
    --enable-shared=no --enable-beta --disable-readdir_r
  3. Compile the package:

    make
  4. Install the programs and any data files:

    make install

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
—enable-trace Allows debugging options

Autostart

To be written