home > Installation


web.py supports Python 2.4 – 2.6 and has no immediate prerequisites.

  1. Stable Version
    1. From Source
      1. System-wide
      2. Local
    2. Via Distribution
      1. Debian-based
      2. Red Hat-based
  2. Development Version
  3. Verify Install

Stable Version

The easiest way to install web.py is using [easy_install](http://peak.telecommunity.com/DevCenter/EasyInstall).
Note that you will install the version specified in the Python Package Index.

easy_install web.py

From Source

wget http://webpy.org/static/web.py-0.33.tar.gz
tar xvzf web.py-0.33.tar.gz


cd web.py-0.33
sudo python setup.py install


If you need to bundle web.py with your application extract the source to a vendor folder and create a symlink, normally within your package’s root.

ln -s vendor/web.py-0.33/web web

Via GNU/Linux Distribution

Debian or Ubuntu

If you are on a Debian-based system you can install web.py using apt-get.
Note that you may not get the latest version as the Ubuntu/Debian release cycles are different from web.py. See <a href=http://packages.debian.org/search?searchon=names&keywords=python-webpy>Debian</a> and <a href=https://launchpad.net/ubuntu/+source/webpy>Ubuntu</a> package profiles for more information.

sudo apt-get install python-webpy

<h4 id=red-hat>Red Hat or Fedora, RHEL, CentOS</h4>

If you are on a Red Hat-based system you can install web.py using yum or up2date.
Note that CentOS requires the EPEL repository.

yum install python-webpy
up2date -i python-webpy

Development Branch

To follow the bleeding edge clone the master branch.

git clone git://github.com/webpy/webpy.git

Verify Install

python -c "import web; web.application(('/', lambda: 'success')).run()"

Point a browser to your host at port 8080 and expect a response of success.