How To Set Up Cherokee on Ubuntu 12.10/Debian

Published on April 12, 2013

Di Wu

How To Set Up Cherokee on Ubuntu 12.10/Debian

About Cherokee

Cherokee is a high performance, lightweight, full-featured web server. It is compatible with SSL, FastCGI, and all modern web application frameworks like NodeJS, Rails, and Python through uWSGI. The best thing about Cherokee is that unlike Apache or Nginx, Cherokee can be administered completely through it's admin web interface.

Setup On Ubuntu

On Ubuntu droplets, Cherokee can be installed after the Cherokee PPA has been configured.

sudo add-apt-repository ppa:cherokee-webserver/ppa

If your system does not come with add-apt-repository, try installing software-properties-common first.

sudo apt-get install software-properties-common

Afterwards, update the apt cache and install cherokee and cherokee-admin

sudo apt-get update
sudo apt-get install cherokee cherokee-admin

Setup On Debian and Ubuntu

On Debian or Ubuntu droplets, Cherokee can be installed directly from the apt repository.

sudo apt-get install cherokee cherokee-admin

Setup On CentOS

On CentOS droplets, Cherokee can be installed directly from the EPEL repository.

sudo yum install cherokee

Check Cherokee Status

Now that Cherokee is installed, we can check whether it is running.

sudo service cherokee status

If Cherokee is ever having troubles, we can check its logs in the /var/log/cherokee directory. We can also verify that Cherokee is running by visiting the droplet's IP address. We should be greeted by this page.

Administering Cherokee

The best part about using Cherokee is being able to manage all of its configurations through a simple to use web interface. The web management interface does not and should not be running by default. It can be started through the cherokee-admin command.

sudo cherokee-admin

Cherokee-admin will output the temporary credentials to use in the web interface. Copy the one time password generated.

Cherokee Web Server 1.2.101 (Oct 25 2012): Listening on port,
TLS disabled, IPv6 enabled, using epoll, 4096 fds system limit, max. 2041
connections, caching I/O, single thread

  User:              admin
  One-time Password: tGCtsC95wdbwtBCC

Web Interface:

Since the administration page is bound by default only to the server's local interface, we should start another SSH connection and forward port 9090 to our local machine. This allows us to access the web interface on our local machine at port 9090.

ssh USER_NAME@DROPLET_IP_ADDRESS -L9090:localhost:9090

Now if we visit localhost:9090, we will be prompted for the admin password. After logging in, we can use the Cherokee admin interface to manage all aspects of our web server, such as setting up vServers, WSGI sources, tuning, etc...

Thanks for learning with the DigitalOcean Community. Check out our offerings for compute, storage, networking, and managed databases.

Learn more about our products

About the authors
Default avatar
Di Wu


Still looking for an answer?

Ask a questionSearch for more help

Was this helpful?

This textbox defaults to using Markdown to format your answer.

You can type !ref in this text area to quickly search our full set of tutorials, documentation & marketplace offerings and insert the link!

There is a new book on the Cherokee server titled “Linux Web Server Development”. It is available from Amazon at: http://www.amazon.com/Linux-Server-Development-Step---Step/dp/1511993138

Or rather than the port forwarding you could just run

sudo cherokee-admin -b 123.456.789.012

Which will allow you to access the admin via the servers Ip or hostname.

Try DigitalOcean for free

Click below to sign up and get $200 of credit to try our products over 60 days!

Sign up

Join the Tech Talk
Success! Thank you! Please check your email for further details.

Please complete your information!

Featured on Community

Get our biweekly newsletter

Sign up for Infrastructure as a Newsletter.

Hollie's Hub for Good

Working on improving health and education, reducing inequality, and spurring economic growth? We'd like to help.

Become a contributor

Get paid to write technical tutorials and select a tech-focused charity to receive a matching donation.

Welcome to the developer cloud

DigitalOcean makes it simple to launch in the cloud and scale up as you grow — whether you're running one virtual machine or ten thousand.

Learn more
DigitalOcean Cloud Control Panel