


Cherokee(1)                                           Cherokee(1)


NAME
       cherokee - Cherokee Web Server

SYNOPSIS
       cherokee [options]

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

OPTIONS
       This command will launch the Cherokee webserver. It accepts the follow-
       ing 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, --config=PATH
               Specifies an alternative path for the configuration file to use
               instead of the default cherokee.conf

       -p, --port=PORT
               TCP port number to which the server will listen.

       -r, --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 devel-
               opment and troubleshooting purposes.

SIGNALS
       The following signals are supported by Cherokee:

       SIGHUP,  Restarts the server gracefully

       SIGUSR1, Restarts the server closing all the opened connections





                        December 13, 2010                       1





Cherokee(1)                                           Cherokee(1)


       SIGUSR2, Reopens the log files

       SIGTERM, Exits

BUGS
   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 Chero-
       kee, especially if you are using it for a distribution.

       Report bugs to http://bugs.cherokee-project.com

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

       subscribe cherokee

       in the body of the message. The submission address  is  cherokee@chero-
       kee-project.com.

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  conve-
       nient invocation method.

AUTHOR
       Alvaro Lopez Ortega <alvaro@alobbs.com>.

       This manpage is maintainted by Taher Shihadeh <taher@unixwars.com>.

























                        December 13, 2010                       2


