Quick Guide to Cherokee

Introduction

Cherokee aims at being a lighter alternative to Apache.

Setup

On Ubuntu 10.04, here's how to install Cherokee, PHP-CGI (FastCGI) and the library to connect to MySQL (source).

  1. add-apt-repository ppa:cherokee-webserver
  2. apt-get update
  3. apt-get install cherokee cherokee-doc libcherokee-mod-libssl libcherokee-mod-streaming libcherokee-mod-rrd
  4. apt-get install php5-cgi
  5. apt-get install php5-mysql php5-curl php5-gd php5-idn php-pear php5-imagick php5-imap php5-mcrypt php5-memcache php5-mhash php5-ming php5-ps php5-pspell php5-recode php5-snmp php5-sqlite php5-tidy php5-xmlrpc php5-xsl php5-json
  6. vi /etc/php5/cgi/php.ini, and uncomment this line:

    ;cgi.fix_pathinfo = 1

  7. /etc/init.d/cherokee restart
  8. Launch the admin interface: cherokee-admin -b
  9. vServers icon at the top > default > Behavior > Rule Management > "+" button at the top left corner > Languages > PHP > Add
  10. To change the settings for PHP: Sources at the top right corner > PHP Interpreter
  11. SAVE button at the top right corner > Graceful Restart
  12. CTRL-C to close the admin application
  13. /etc/init.d/cherokee restart
  14. vi /var/www/phpinfo.php

    <? phpinfo(); ?>
     
  15. Aim your browser at the Cherokee server, check that PHP works and that it has the MySQL library.

Q&A

Difference between FINAL and NON FINAL?

How to have Cherokee listen on both TCP4 and TCP6?

How to change the port on which Cherokee listens?

General > Ports to listen > SAVE > Graceful restart

I changed port from 80 to 8787, but can't connect from remote computer :-/

Why all those errors in /var/log/cherokee/cherokee.error?

PHP Deprecated:  Comments starting with '#' are deprecated in /etc/php5/cgi/conf.d/idn.ini on line 1 in Unknown on line 0

PHP Deprecated:  Comments starting with '#' are deprecated in /etc/php5/cgi/conf.d/imagick.ini on line 1 in Unknown on line 0

Resources