Description: Cherokee is a flexible, very fast, lightweight Web server. It is implemented entirely in C, and has no dependencies beyond a standard C library. It is embeddable and extensible with plug-ins. It supports on-the-fly configuration by reading files or strings, TLS/SSL (via GNUTLS or OpenSSL), virtual hosts, authentication, cache friendly features, PHP, custom error management, and much more.
Keywords: cherokee web server httpd http

## Index → Configuration

## General Configuration

### Network

#### IPv6 support

The IPv6 configuration key brings the possibility of activating or deactivating the IPv6 support at the server. If Cherokee has been compiled with IPv6 support (--with-ipv6), this configuration entry will be fully functional, otherwise it will be ignored.

#### SSL/TLS Back-end

Specifies the TLS/SSL backend to be used, if any. The current option is OpenSSL.

#### Timeout

Sets the number of seconds that Cherokee will wait before closing the connection.

#### Server Tokens

This specifies the string that Cherokee should use to identify itself.

Parameters | Description
--- | ---
Product | Cherokee
Minor | Cherokee/0.98
Minimal | Cherokee/0.98.3
OS | Cherokee/0.98.3 (UNIX)
Full | Cherokee/0.98.3 b2955 (UNIX)

By default, Cherokee will use Full.

#### Graphs type

Through this you can enable or disable the usage of RRD graphs. Check the usage graphs section for more details.

### Ports to listen

This section allows to configure the ports that the server will be listening to. You can add several different ports, and configure whether they will be used for HTTP or HTTPS.

Each binding entry can be configured to listen to a network interface. In case the text entry is empty, the server will accept connection from the port on any interface.

### Server Permissions

#### User & Group

The User directive configures which user the Cherokee daemon will normally run as. By default, Cherokee runs as root which is considered undesirable in all but the most trustful network configurations.

The User directive used in conjunction with the Group directive instructs the daemon to switch to the specified user and group as quickly as possible after startup.

There are two possible formats: using the user or group name, or using the system ID.

#### Chroot

Cherokee can be jailed inside a directory. Note that this should not be used as the sole security measure.

### Icon management

The icons configuration file associates an icon image with one or more file extensions. This information will be used mainly by the dirlist handler.

- Extensions

  - This allows to associate icons with extensions.

- Files

  - This section lets you specify an icon for certain filenames such as "core" or "README". It accepts wild-card strings (using * and ?)

- Special icons

  - Directory: In this case, it specifies the icon to be used with Directories.

  - ParentDirectory: This entry is used to assign an Icon to the "go to the parent directory" action.

  - Default: This is the icon that will be shown if any of the previous ones matched.

### MIME Types

This section allows to add support for new MIME types or edit the existing ones.

- Mime Type: this is the proper mime string.

- Extensions: the file extensions for this type of contents.

- Max Age: defines for how long a file of this type must be cached at the client’s side.