Visit our main website for the latest updates: www.cherokee-project.com.
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, do the following:
git clone http://github.com/cherokee/webserver.git
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.
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.
Cherokee is released under GPL v2. Read the COPYING file for more
information.
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:
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!
Communicate with the Cherokee community via IRC:
irc.freenode.net, channel #cherokee
Here is a list of the most frequently asked questions regarding compilation and similar topics:
./configure --prefix=/usr --sysconfdir=/etc --localstatedir=/var make
Modules are created dynamically by default.
./configure --prefix=/usr --sysconfdir=/etc --localstatedir=/var --enable-static-module=xyz
./configure --prefix=/usr --sysconfdir=/etc --localstatedir=/var --enable-static-module=all
./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
./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
openssl req -days 1000 -new -x509 -nodes -out /etc/cherokee/ssl/cherokee.pem -keyout /etc/cherokee/ssl/cherokee.pem
git clone 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.