Cherokee Basics
Getting started

Why Cherokee?Feature overview.
RequirementsHardware and software requirements.
DownloadWhere and how to download Cherokee.
InstallationInstallation instructions.
Upgrading CherokeeUpgrading from a previous release?
Running CherokeeBasic steps to run Cherokee.

Configuration
Set up process explained

WalkthroughOverview and walkthrough.
HomeMain section.
StatusServer status information.
GeneralGeneral settings.
Virtual serversServer definition.
Information SourcesDefining information sources.
AdvancedAdvanced tweaking. Not for the faint of heart.
WizardsConfiguration assistants for many known scenarios.

Cookbook
Recipes for specific tasks

AuthenticationHow to set up authenticated resources.
Cross compilationHow to cross compile Cherokee.
DBSlayerHow to set up DBSlayer MySQL balancing.
Embedding CherokeeCherokee on embedded devices.
MaintenanceSeamlessly switching to maintenance mode.
Managing logsSeamless log rotation.
Optimizing CherokeeRecommendations and tweaks.
RedirectionsCommon redirection examples.
SSL/TLS, certsSecure connection tips.
HTTPS acceleratorSSL Offloading with Cherokee.
StreamingHow to stream Audio and Video with Cherokee.
PHPHow to run PHP apps with Cherokee.
Ruby on RailsHow to run Ruby on Rails apps with Cherokee.
DjangoHow to run Django apps with Cherokee.
ColdFusionHow to run ColdFusion apps with Cherokee.
DrupalHow to run Drupal on Cherokee.
WordpressHow to run Wordpress on Cherokee.
AlfrescoHow to run Alfresco on Cherokee.
ASP.NETHow to run ASP.NET apps with Mono and Cherokee.
GlassFishHow to run Java apps with Cherokee.
JoomlaHow to run Joomla on Cherokee.
KumbiaHow to run Kumbia apps with Cherokee.
LiferayHow to run Liferay on Cherokee.
MailmanHow to run Mailman on Cherokee.
MoodleHow to run Moodle on Cherokee.
NagiosHow to run Nagios with Cheroke.
phpBBHow to run phpBB on Cherokee.
phpMyAdminHow to run phpMyAdmin on Cherokee.
SugarCRMHow to run SugarCRM on Cherokee.
Concrete5How to run Concrete5 on Cherokee.
SymfonyHow to run Symfony apps with Cherokee.
TracHow to run Trac on Cherokee.
ZendHow to run Zend apps with Cherokee.
uWSGISetting up Cherokee for uWSGI.
HTTP to HTTPSHow to redirect all traffic from HTTP to HTTPS.
Restricting traffic by IPHow to restrict traffic based on incoming IP.
Domain matchingMatching domains and subdomains with Cherokee.

Modules
Information about the standard modules

HandlersConnection handling modules.
ValidatorsAuthentication mechanisms.
EncodersCompression and filtering.
LoggersLogging mechanisms.
BalancersLoad balancing strategies.

Other information
Miscellaneous

FAQList of Frequently Asked Questions.
Front-line CacheSpecifics of the Caching subsystem.
System TuningTweaking the OS for maximum performance.
Cherokee GoodiesInteresting Cherokee features.
Usage graphsInformation on the several graphs available.
SignalsSignals supported by Cherokee.
CommunityMore information sources.
Common errorsSome typical production errors and their cause.
Man pagesDetails about each program bundled with Cherokee.

Development info
Things of interest to developers

QuickstartWhere to start?
DebuggingResources available to debug Cherokee.
cherokee.confInternal configuration specs.
Quality AssuranceSome info about QA in Cherokee.
CTKDive into the Cherokee Toolkit.

Cherokee’s Distribution
Web Apps distribution on Cherokee

Introduction to DevelopmentHow to build a package.

Cherokee Basics

Index → Getting started → Installation

Installing Cherokee: Windows

Warning!

The Windows native build is currently broken. It will be fixed as soon as possible. A Windows binary release will be available too. In the meantime, if you need to run Cherokee on a Windows host you will have to rely on Cygwin and the likes. Almost all the code base of the Cherokee-Project can be used natively under Windows, as it was 100% compatible not too long ago. However, since resources and man-power are limited, and due to Cherokee’s fast evolution, we are not yet there. Reacquiring binary compatibility with the Windows platform is a medium-to-long term goal.

You can download a more modern version from Stefan de Konink’s Windows binary repository.

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 made 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)

Download MinGW release 5.1.4 at the time of this writing.
Run it and select ‘Candidate’. Check base tools & g++
Install in a directory with no spaces (the default directory C:\MinGW is fine).

MSYS: Minimal SYStem

Download MSYS, tests were made with release 1.0.10
Install it in the same directory as MinGW (remove “1.0″ from the install path).
Answer y, y, c:/MinGW
You should add something like this to your ~/.profile to process your preferences:
```
if [ -f ${HOME}/.bashrc ] then
  . ${HOME}/.bashrc
fi
```

MSYS DTK: Dev Toolkit

Get DTK
Install it in the same path as above

Update Autoconf & Automake

You might encounter problems if you do not have up to date Autoconf and Automake. We recommend the usage of at least versions 2.61 and 1.10.1, that are the ones we used.

Pthreads Win32: POSIX Threads

Cherokee will need these. Just download Pthreads-Win32 and copy the appropriate files to /lib and /include

Python

You will need this, since both the build process and Cherokee-Admin use Python. Just download a Python Windows installer, remember to include the directory in your path environment variable, and you’re done.
rxvt seems to be broken, which is most noticeable when you try to run Python interactively, so just comment out its line in msys.bat.

Building

Download a fresh copy of Cherokee

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

Compile the package:
```
make
```
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
`--with-user=USER`	Custom username under which the server will run
`--with-user=GROUP`	Custom group under which the server will run
`--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
`--enable-trace`	Allows debugging options
`--disable-admin`	Stops cherokee-admin from installing

Autostart

To be written