1. cherrypy
  2. CherryPy


CherryPy / sphinx / source / intro / install.rst

The default branch has multiple heads






All you need is a working version of Python-2.3 or later on your computer. If you are running Max OS X or some Linux distribution (e.g. Ubuntu, Debian, Fedora) you most likely already have python on you system, for a detailed instruction on how to install python follow the instruction on the python wiki.

Download Stable Versions

Using pip or easy_install

Using pip:

$ pip install CherryPy

or with easy_install:

$ easy_install CherryPy

It is recommended to use pip instead of easy_install. If you want to download and install CherryPy for yourself proceed to the next instructions depending on your platform.


You may download the most current version from PyPI

For other releases, browse our download index.

  • Unzip/untar the files
  • Enter the directory created by the file extraction.
  • Type "python setup.py install" to install the CherryPy module


You may download the most current version from PyPI.

For other releases, browse our download index.

  • Select the file ending in ".exe".
  • Run the downloaded file.

Next Steps

  • To run your first sample website, go to cherrypy/tutorial/ and type "python tut01_helloworld.py", and you'll have a running website on port 8080.
  • Open your favorite browser and point it to http://localhost:8080 to see your first CherryPy-served page :-)

Now, you should try running some of the other tutorials found in the tutorial directory and look at their source code to understand how to develop a website with CherryPy.

Development versions

CherryPy's source code is managed using Mercurial, a source code control system written in python.

You can access our Mercurial repository using your favorite Mercurial client at bitbucket.

For Windows users, we recommend the wonderful Mercurial client TortoiseHg. Users of other operating systems are advised to use multi-platform command line tools provided by the core Mercurial distribution.

  • To submit a patch fork the repository and submit your pull request. For further information please contact us via email or IRC (see getting involved).

Standalone WSGI server

The WSGI server that comes bundled with CherryPy is available as a standalone module. Feel free to use it for all of your WSGI serving needs.