summaryrefslogtreecommitdiff
path: root/network/cherokee/README
blob: 5891e7ac206874a572cf4db1b3fb634ec1721a14 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
Cherokee is a very fast, flexible and easy to configure Web Server
written by Alvaro Lopez Ortega <alvaro@alobbs.com>.
It supports the widespread technologies nowadays: FastCGI, SCGI,
PHP, CGI, SSI, TLS and SSL encrypted connections, Virtual hosts,
Authentication, on the fly encoding, Load Balancing, Apache
compatible log files, Data Base Balancing, Reverse HTTP Proxy,
Traffic Shaper, Video Streaming and much more.

A user friendly interface called cherokee-admin is provided for a
no-hassle configuration of the server.

If you are installing a high load http server, you will probably need
a zero-downtime process of log rotation. To achieve this, I strongly
recommend you to take a look to this cookbook:
  *  http://www.cherokee-project.com/doc/cookbook_managing_logs.html

If need to get popular web applications working or fine tune your
server, follow the cherokee's cookbooks page:
  *  http://www.cherokee-project.com/doc/cookbook.html

ffmpeg is an optional dependency (for video streaming - BROKEN ATM).

Notes about using this SlackBuild
---------------------------------

1) To specify the WWW root directory pass WWWROOT=/path/to/www/root
   to the script, like this:

      WWWROOT=/var/www/htdocs-cherokee ./cherokee.SlackBuild

2) If you want to enable IPv6 support, pass IPV6=yes to the script.
3) If you want to disable the Cherokee-admin installation, pass
   ADMIN=no to the script.
4) This script builds Cherokee with support for MySQL client library
   by default. If you want to avoid the dependency on MySQL client
   library, or just build Cherokee without this support, pass MYSQL=no
   to the script.
5) If you want to build Cherokee with debugging options, enable trace
   facility by passing TRACE=yes to the script.
6) The $WWWGROUP group and the $WWWUSER user account are set to cherokee.
   To run cherokee as a different user/group specify them passing the
   options WWWUSER/WWWGROUP to the slackbuild, like

     WWWUSER=cherokee WWWGROUP=cherokee ./cherokee.SlackBuild

   You want to create first a dedicated user/group.

     groupadd -g 299 cherokee
     useradd -u 299 -g cherokee -d /var/www/htdocs-cherokee cherokee

   See http://slackbuilds.org/uid_gid.txt for current reccomendations (if any)
7) If you want to use it with php, remember to add your user to the
   apache group, so that it can use /var/lib/php, like

     gpasswd -a cherokee apache

Comments, suggestions or bug reports
------------------------------------

If you have anything to say about this SlackBuild, even reporting a
bug, don't hesitate to contact me at pablosaro@gmail.com
(be aware that pablo might not know that I wrecked his build
script for 1.2.101, ndponce <matteo.bernardini@gmail.com>)