Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Newer
Older
100644 80 lines (54 sloc) 2.983 kb
799c9b9 edit
Angelo Gladding authored
1 ---
2 layout: default
3 title: Installation
4 ---
5
6 # Installation
7
bfecf75 edit
Angelo Gladding authored
8 `web.py` supports Python 2.4 – 2.6 and has no immediate prerequisites.
799c9b9 edit
Angelo Gladding authored
9
f0348c9 edit
Angelo Gladding authored
10 1. [Stable Version](#stable)
11 1. [From Source](#source)
12 1. [System-wide](#system)
799c9b9 edit
Angelo Gladding authored
13 1. [Local](#local)
f0348c9 edit
Angelo Gladding authored
14 1. [Via Distribution](#distribution)
15 1. [Debian-based](#debian)
16 1. [Red Hat-based](#red-hat)
17 1. [Development Version](#development)
761a07a edit
Angelo Gladding authored
18 1. [Verify Install](#verify)
799c9b9 edit
Angelo Gladding authored
19
f0348c9 edit
Angelo Gladding authored
20 <h2 id=stable>Stable Version</h2>
799c9b9 edit
Angelo Gladding authored
21
22 The easiest way to install `web.py` is using
23 <code>[easy_install](http://peak.telecommunity.com/DevCenter/EasyInstall)</code>.
24 <em><small><strong>Note</strong> that you will install the version specified in the [Python Package Index](http://pypi.python.org/pypi/web.py).</small></em>
25
8adf06f edit
Angelo Gladding authored
26 <pre><code><kbd>easy_install web.py</kbd>
27 <kbd></kbd></code></pre>
799c9b9 edit
Angelo Gladding authored
28
f0348c9 edit
Angelo Gladding authored
29 <h3 id=source>From Source</h3>
799c9b9 edit
Angelo Gladding authored
30
bfecf75 edit
Angelo Gladding authored
31 <pre><code><kbd>wget http://webpy.org/static/web.py-0.33.tar.gz</kbd>
8ef9a95 edit
Angelo Gladding authored
32 <kbd>tar xvzf web.py-0.33.tar.gz</kbd>
597217c edit
Angelo Gladding authored
33 <kbd></kbd></code></pre>
799c9b9 edit
Angelo Gladding authored
34
761a07a edit
Angelo Gladding authored
35 <h4 id=system>System-wide</h4>
799c9b9 edit
Angelo Gladding authored
36
bfecf75 edit
Angelo Gladding authored
37 <pre><code><kbd>cd web.py-0.33</kbd>
8adf06f edit
Angelo Gladding authored
38 <kbd>sudo python setup.py install</kbd>
39 <kbd></kbd></code></pre>
799c9b9 edit
Angelo Gladding authored
40
761a07a edit
Angelo Gladding authored
41 <h4 id=local>Local</h4>
799c9b9 edit
Angelo Gladding authored
42
43 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.
44
8adf06f edit
Angelo Gladding authored
45 <pre><code><kbd>ln -s vendor/web.py-0.33/web web</kbd>
46 <kbd></kbd></code></pre>
799c9b9 edit
Angelo Gladding authored
47
f0348c9 edit
Angelo Gladding authored
48 <h3 id=distribution>Via GNU/Linux Distribution</h3>
799c9b9 edit
Angelo Gladding authored
49
f0348c9 edit
Angelo Gladding authored
50 <h4 id=debian>Debian <small>or Ubuntu</small></h4>
799c9b9 edit
Angelo Gladding authored
51
52 If you are on a Debian-based system you can install `web.py` using `apt-get`.
f0348c9 edit
Angelo Gladding authored
53 <em><small><strong>Note</strong> 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.</small></em>
799c9b9 edit
Angelo Gladding authored
54
8adf06f edit
Angelo Gladding authored
55 <pre><code><kbd>sudo apt-get install python-webpy</kbd>
56 <kbd></kbd></code></pre>
799c9b9 edit
Angelo Gladding authored
57
f0348c9 edit
Angelo Gladding authored
58 <h4 id=red-hat>Red Hat <small>or Fedora, RHEL, CentOS</small></h4>
799c9b9 edit
Angelo Gladding authored
59
60 If you are on a Red Hat-based system you can install `web.py` using `yum` or `up2date`.
61 <em><small><strong>Note</strong> that CentOS requires the [<abbr title="Extra Packages for Enterprise Linux">EPEL</abbr>](https://fedoraproject.org/wiki/EPEL) repository.</small></em>
62
8adf06f edit
Angelo Gladding authored
63 <pre><code><kbd class=su>yum install python-webpy</kbd>
11faba3 edit
Angelo Gladding authored
64 <kbd class=su></kbd></code></pre>
8adf06f edit
Angelo Gladding authored
65 <pre><code><kbd class=su>up2date -i python-webpy</kbd>
11faba3 edit
Angelo Gladding authored
66 <kbd class=su></kbd></code></pre>
799c9b9 edit
Angelo Gladding authored
67
f0348c9 edit
Angelo Gladding authored
68 <h2 id=development>Development Branch</h2>
69
70 To follow the bleeding edge clone the master branch.
761a07a edit
Angelo Gladding authored
71
8adf06f edit
Angelo Gladding authored
72 <pre><code><kbd>git clone git://github.com/webpy/webpy.git</kbd>
73 <kbd></kbd></code></pre>
761a07a edit
Angelo Gladding authored
74
3403402 edit
Angelo Gladding authored
75 <h2 id=verify>Verify Install</h2>
761a07a edit
Angelo Gladding authored
76
bfecf75 edit
Angelo Gladding authored
77 <pre><code><kbd>python -c "import web; web.application(('/', lambda: 'success')).run()"</kbd>
761a07a edit
Angelo Gladding authored
78 <samp>http://0.0.0.0:8080/</samp></code></pre>
79
bfecf75 edit
Angelo Gladding authored
80 Point a browser to your host at port `8080` and expect a response of `success`.
Something went wrong with that request. Please try again.