This section shows how to install Cherokee (http://www.0x50.org) in a Unix environment. At this moment, there is an effort of porting the server to a native Windows program, but it is under heavy development and it will need more time and work to be ready to be used.
Table of contents |
The following requirements exist for building Cherokee:
Cherokee can be downloaded from the Cherokee Web Server download site (http://0x50.org/index.php?option=com_content&task=view&id=11&Itemid=13) or from one of the mirrors. Some users of Cherokee on unix-like systems will be better off downloading and compiling a source version. The build process (described below) is easy, and it allows you to customize your server to suit your needs. Anyway, there are some operating systems and GNU/Linux distributions that are building Cherokee binary packages (http://0x50.org/index.php?option=com_content&task=view&id=11&Itemid=13)
If you know the URL of the cherokee sources that you would like to download, for example, cherokee-x.y.z.tar.gz, you can just use the follow command:wget http://0x50.org/download/x.y/x.y.z/cherokee-x.y.z.tar.gz -O - | gzip -dc - | tar xfv -
In order to activate the secure connections support you has to ensure you have one of GNUTLS or OpenSSL libraries installed on your system. The configuration script will detect if there is a suitable installation of that libraries. If it finds one of them, it will compile the server with SSL/TLS support. Anyway you can specify who do you want to compile the it:
To disable the the SSL/TLS support just add the follow parameter to configure:--disable-tlsTo force to compile using the GNU TLS library:
--enable-tls=gnutlsTo force to compile using the OpenSSL:
--enable-tls=openssl
Cherokee supports IPv6. If your building system supports it, the server will be built with this feature enabled. If it isn't supported or enabled on your system, the binary simply won't be able to work with a IPv6 stack. If Cherokee is compiled with IPv6 support it will work with both stacks: IPv4 and IPv6 at same time. Anyway there is a configuration option that will allow you to disable the IPv6 support on run time.
To disable the IPv6 support:--disable-ipv6
There are a few very important configure parameters: prefix, sysconfdir and with-wwwroot. Usually it is a good idea to use these three parameters. A very common configure script call is:
./configure --prefix=/usr --sysconfdir=/etc --with-wwwroot=/var/wwwAfter this, the sources will be ready to get compiled. This should be enough
makebut you can also add compilation parameters. For example, if you are using gcc and you want to compile the Cherokee with debug information just execute make like this
make CFLAGS="-O0 -g"
make install
If you are making a system wide installation you will need to become root first.