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

<h2 id=stable>Stable Version</h2>

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

<h3 id=source>From Source</h3>

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

<h4 id=system>System-wide</h4>

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

<h4 id=local>Local</h4>

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

<h3 id=distribution>Via GNU/Linux Distribution</h3>

<h4 id=debian>Debian or Ubuntu</h4>

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.

<kbd class=su>yum install python-webpy</kbd>
<kbd class=su></kbd>
<kbd class=su>up2date -i python-webpy</kbd>
<kbd class=su></kbd>

<h2 id=development>Development Branch</h2>

To follow the bleeding edge clone the master branch.

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

<h2 id=verify>Verify Install</h2>

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

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