Skip to content
This repository

Cherokee Web Server

Merge pull request #1126 from cherokee/kinnison/fix-parent-dying

MAIN: Do not process special exit codes unless worker is exiting.
latest commit 5592d57791
Stefan de Konink skinkie authored
Octocat-spinner-32 admin Merge pull request #1117 from cherokee/more_tls_options February 06, 2014
Octocat-spinner-32 cget Remove unused variable. January 02, 2014
Octocat-spinner-32 cherokee MAIN: Do not process special exit codes unless worker is exiting. April 13, 2014
Octocat-spinner-32 contrib Managed to drop the status from line 176. Readded. January 05, 2014
Octocat-spinner-32 dbslayer Changing the copyright messages to fit for 2014. Happy new year, ever… December 29, 2013
Octocat-spinner-32 doc Artwork censorship February 04, 2014
Octocat-spinner-32 icons Clean up: Trims trailing spaces. December 14, 2009
Octocat-spinner-32 m4 Some minor autoconf/automake fixes March 18, 2013
Octocat-spinner-32 packages Gets rid of most the Windows related code. There is no reason we keep March 21, 2013
Octocat-spinner-32 po Release of Cherokee 1.2.104 April 01, 2014
Octocat-spinner-32 qa Make the SSL tests run February 01, 2014
Octocat-spinner-32 themes Artwork censorship February 04, 2014
Octocat-spinner-32 www Artwork censorship February 04, 2014
Octocat-spinner-32 .gitignore Updates .gitignore, it was not covering some of the binaries and October 13, 2011
Octocat-spinner-32 AUTHORS git-svn-id: svn://cherokee-project.com/cherokee-pyscgi@504 5dc97367-9… December 10, 2006
Octocat-spinner-32 COPYING git-svn-id: svn://cherokee-project.com/cherokee/trunk@243 5dc97367-97… April 01, 2006
Octocat-spinner-32 INSTALL This was autogenerated from automake --add-missing August 13, 2013
Octocat-spinner-32 Makefile.am Keep cherokee.conf also after make uninstall January 02, 2014
Octocat-spinner-32 NEWS git-svn-id: svn://cherokee-project.com/cherokee/trunk@243 5dc97367-97… April 01, 2006
Octocat-spinner-32 README.rst Adds support for Automake's "Silent Building" mechanism. June 10, 2013
Octocat-spinner-32 SUNWcherokee.spec git-svn-id: svn://cherokee-project.com/cherokee/trunk@1131 5dc97367-9… February 21, 2008
Octocat-spinner-32 acinclude.m4 New year, new copyright notice: 's/2009/2010/g'. January 20, 2010
Octocat-spinner-32 autogen.sh Update autogen.sh June 04, 2013
Octocat-spinner-32 censor-artwork.py Artwork censorship February 04, 2014
Octocat-spinner-32 cherokee-admin-launcher.1 Fixes some documentation typos. Thanks to Tom Browder <tom.browder@gm… February 17, 2011
Octocat-spinner-32 cherokee-admin.1 Updates manpages February 16, 2011
Octocat-spinner-32 cherokee-config.1 Fixes some documentation typos. Thanks to Tom Browder <tom.browder@gm… February 17, 2011
Octocat-spinner-32 cherokee-config.in git-svn-id: svn://cherokee-project.com/cherokee/trunk@243 5dc97367-97… April 01, 2006
Octocat-spinner-32 cherokee-tweak.1 Fixes some documentation typos. Thanks to Tom Browder <tom.browder@gm… February 17, 2011
Octocat-spinner-32 cherokee-worker.1 git-svn-id: svn://cherokee-project.com/cherokee/trunk@1923 5dc97367-9… August 31, 2008
Octocat-spinner-32 cherokee.1 Updates manpages February 16, 2011
Octocat-spinner-32 cherokee.conf.sample.pre Changing /icons to /cherokee_icons (fix Google issue #1383) January 26, 2013
Octocat-spinner-32 cherokee.m4 git-svn-id: svn://cherokee-project.com/cherokee/trunk@243 5dc97367-97… April 01, 2006
Octocat-spinner-32 cherokee.pc.in git-svn-id: svn://cherokee-project.com/cherokee/trunk@243 5dc97367-97… April 01, 2006
Octocat-spinner-32 cherokee.spec.in Changing the copyright messages to fit for 2014. Happy new year, ever… December 29, 2013
Octocat-spinner-32 config.h.win32 git-svn-id: svn://cherokee-project.com/cherokee/trunk@243 5dc97367-97… April 01, 2006
Octocat-spinner-32 configure.ac Release of Cherokee 1.2.104 April 01, 2014
Octocat-spinner-32 constants.h.pre Merges the Front-Line Cache branch. May 03, 2011
Octocat-spinner-32 contributing.md Update contributing.md January 03, 2014
Octocat-spinner-32 debian_testing.sh git-svn-id: svn://cherokee-project.com/cherokee/trunk@243 5dc97367-97… April 01, 2006
Octocat-spinner-32 debian_testing_chroot.sh git-svn-id: svn://cherokee-project.com/cherokee/trunk@243 5dc97367-97… April 01, 2006
Octocat-spinner-32 developers.py Replaced Taher's old octality email address with his current one. January 03, 2014
Octocat-spinner-32 http-cherokee.xml.pre Changing the copyright messages to fit for 2014. Happy new year, ever… December 29, 2013
Octocat-spinner-32 mods-admin.sample git-svn-id: svn://cherokee-project.com/cherokee/trunk@243 5dc97367-97… April 01, 2006
Octocat-spinner-32 org.cherokee.webserver.plist.in Adds support for MacOS X's launchd. It implements RFE #871: May 16, 2010
Octocat-spinner-32 pam.d_cherokee git-svn-id: svn://cherokee-project.com/cherokee/trunk@243 5dc97367-97… April 01, 2006
Octocat-spinner-32 pam.samba.m4 git-svn-id: svn://cherokee-project.com/cherokee/trunk@243 5dc97367-97… April 01, 2006
Octocat-spinner-32 performance.conf.sample.pre git-svn-id: svn://cherokee-project.com/cherokee/trunk@2989 5dc97367-9… March 18, 2009
README.rst

Cherokee Web Server

Web site

Visit our main website for the latest updates: http://www.cherokee-project.com/

Compiling from source

Building from the repository

To build from the repository, you will require autoconf, automake, and libtool tools to be available, typically available on your distribution either by default or by running the following on Debian-based systems:

sudo apt-get install autoconf automake libtool

or, for Yum-based systems, such as RedHat, CentOS or Fedora:

sudo yum install autoconf automake libtool

or, for Pacman-based systems such as ArchLinux:

sudo pacman -Sy autoconf automake libtool

To check out the code from GitHub, including all dependencies that are specified as Git submodules, do the following:

git clone --recursive http://github.com/cherokee/webserver.git

or, if using a version of Git < 1.6.5, run:

git clone http://github.com/cherokee/webserver.git
git submodule update --init

Once cloned, cd into the resulting source directory and run ./autogen.sh to set up the environment and generate ./configure:

cd webserver
./autogen.sh [options]
make
make install

./autogen.sh will accept any optional parameters otherwise typically passed to ./configure; in doing so you can avoid needing to run ./configure separately.

Several examples of using ./autogen.sh follow shortly in the Frequently Asked Questions (FAQ) section.

Building from a tar.gz file

After downloading (likely from http://www.cherokee-project.com/downloads.html) and extracting, you should run ./configure, with options as appropriate. The standard options are documented in the INSTALL file. Typically, the most interesting options are:

  • the usual --prefix=/usr
  • --localstatedir=/var
  • --sysconfdir=/etc

After running ./configure, issues the make command, and then make install (excuting this last command as root if the destination permissions require that).

Tying this all together will result in commands like the following:

wget http://www.cherokee-project.com/download/trunk/cherokee-latest-snapshot.tar.gz
tar xf cherokee-latest-snapshot.tar.gz
cd cherokee-latest-snapshot
./configure --prefix=/usr --sysconfdir=/etc --localstatedir=/var
make
sudo make install

The exact options passed to ./configure can vary based upon your configuration.

License

Cherokee is released under GPL v2. Read the COPYING file for more information.

Mailing lists

There are several mailing lists available for Cherokee and they are listed at:

http://lists.cherokee-project.com/

The main mailing list, where questions should be sent and general discussion takes place, is:

http://lists.cherokee-project.com/listinfo/cherokee

There are also a few technical mailing lists. Developers and package maintainers should subscribe to these mailing lists as well as the main mailing list:

http://lists.cherokee-project.com/listinfo/cherokee-dev

http://lists.cherokee-project.com/listinfo/cherokee-commits

The mailing lists' archives are available at:

http://lists.cherokee-project.com/pipermail/cherokee/

Don't hesitate to subscribe and contribute to any of the mailing lists!

IRC channel

Communicate with the Cherokee community via IRC:

irc.freenode.net, channel #cherokee

Frequently Asked Questions (FAQ)

Here is a list of the most frequently asked questions regarding compilation and similar topics:

How to compile it

./configure --prefix=/usr --sysconfdir=/etc --localstatedir=/var
make

How to create dynamic modules

Modules are created dynamically by default.

How to configure the module xyz to be linked statically

./configure --prefix=/usr --sysconfdir=/etc --localstatedir=/var --enable-static-module=xyz

How to build everyhing statically

./configure --prefix=/usr --sysconfdir=/etc --localstatedir=/var --enable-static-module=all

How to compile it on Windows

./configure --prefix=/usr --sysconfdir=/etc --localstatedir=/var --enable-static-module=all --enable-static --enable-shared=no --enable-beta --enable-trace

How to build a MacOS X binary package

./autogen.sh --prefix=/usr/local --with-wwwroot=/Library/WebServer/Documents --with-wwwuser=www --with-wwwgroup=www --with-mysql=no --with-ffmpeg=no --with-ldap=no --enable-beta
make -j8
packages/osx/build.py

Development

./autogen.sh --prefix=/usr --sysconfdir=/etc --localstatedir=/var --enable-static-module=all --enable-static --enable-shared=no --with-mysql=no --with-ffmpeg=no --with-ldap=no --enable-beta --enable-trace --enable-backtraces --enable-maintainer-mode
make V=1 CFLAGS="-ggdb3 -O0" -j8

How to cross compile the Win32 version

How to create a self signed certificate for TLS

openssl req -days 1000 -new -x509 -nodes -out /etc/cherokee/ssl/cherokee.pem -keyout /etc/cherokee/ssl/cherokee.pem

How to create a release .tar.gz

git clone --recursive http://github.com/cherokee/webserver.git
cd webserver
./autogen.sh
make dist-gzip

The resulting file will be created in the current directory and will be a .tar.gz archive.

Something went wrong with that request. Please try again.