cherokee man page

cherokee — Cherokee Web Server


cherokee [options]


cherokee is an extremely fast, flexible and embeddable web server.


This command will launch the Cherokee webserver. It accepts the following options:

-h, --help
Prints a brief help message and terminates execution
-V, --version
Prints Cherokee's version and terminates execution
-t, --test
Perform a sanity check on the configuration file. The server will not run.
-d, --detach
Launches the server as a background process (default behaviour is to stay attached to the controlling terminal).
-C<PATH>, --config=<PATH>
Specifies an alternative path for the configuration file to use instead of the default cherokee.conf
-p<PORT>, --port=<PORT>
TCP port number to which the server will listen.
-r<PATH>, --documentroot=<PATH>
Launches a server exposing statically the specified directory. When launched with -r, the configuration file is ignored, and the Cherokee instance runs with its default values.
-i, --print-server-info
Print server technical information.
-v, --valgrind
Execute the worker process under Valgrind. Used only for development and troubleshooting purposes.


The following signals are supported by Cherokee:

SIGHUP, Restarts the server gracefully

SIGUSR1, Restarts the server closing all the opened connections

SIGUSR2, Reopens the log files



Bug reports

I would appreciate hearing of any problems you have with Cherokee. I would also like to hear from you if you have successfully used Cherokee, especially if you are using it for a distribution.

Report bugs to

There is a mailing list for discussion among Cherokee users and for announcements of new and test versions. To join, send a message to with the line:

subscribe cherokee

in the body of the message. The submission address is

See Also

Cherokee can be run either with this command or cherokee-worker(1). This last option is discouraged if you are not developing though. Note that, for most systems, a startup/shutdown script such as /etc/init.d/cherokee is provided and will probably be the most convenient invocation method.


Alvaro Lopez Ortega <>.

This manpage is maintainted by Taher Shihadeh <>.

Referenced By

cherokee-admin(1), cherokee-admin-launcher(1), cherokee-config(1), cherokee-tweak(1), cherokee-worker(1).

February 16, 2011