mirror of
https://github.com/frappe/gunicorn.git
synced 2026-01-14 11:09:11 +08:00
149 lines
5.9 KiB
HTML
149 lines
5.9 KiB
HTML
<!DOCTYPE html>
|
|
<html lang="en">
|
|
<head>
|
|
<meta charset="utf-8" />
|
|
<title>Green Unicorn - Installing Gunicorn</title>
|
|
<link rel="alternate" type="application/rss+xml" href="/feed.xml" />
|
|
|
|
<!--[if IE]>
|
|
<script>
|
|
document.createElement('section');
|
|
document.createElement('article');
|
|
document.createElement('aside');
|
|
document.createElement('footer');
|
|
document.createElement('header');
|
|
document.createElement('nav');
|
|
document.createElement('time');
|
|
</script>
|
|
|
|
<![endif]-->
|
|
|
|
<link rel="stylesheet" href="css/style.css" type="text/css" media="screen">
|
|
</head>
|
|
<body>
|
|
<div class="container">
|
|
<div id="header">
|
|
|
|
<h1 class="logo"><a href="http://gunicorn.org">gunicorn</a></h1>
|
|
|
|
<div id="links">
|
|
Get the source via
|
|
<a href="http://github.com/benoitc/gunicorn">git</a>, then
|
|
<a href="http://github.com/benoitc/gunicorn/issues">send feedback</a>
|
|
</div>
|
|
</div>
|
|
|
|
|
|
|
|
<div id="menu">
|
|
<ul id="actions">
|
|
<li><a href="installation.html">Installation</a></li>
|
|
<li><a href="usage.html">Usage</a></li>
|
|
<li><a href="deployment.html">Deployment</a></li>
|
|
<li><a href="configuration.html">Configuration</a></li>
|
|
<li><a href="tuning.html">Tuning</a></li>
|
|
<li><a href="faq.html">FAQ</a></li>
|
|
<li><a href="news.html">News</a></li>
|
|
</ul>
|
|
</div>
|
|
|
|
<div class="document" id="installation">
|
|
<h1 class="title">Installation</h1>
|
|
<div class="section" id="requirements">
|
|
<h1>Requirements</h1>
|
|
<ul class="simple">
|
|
<li><strong>Python 2.5 or newer</strong> (Python 3.x will be supported soon)</li>
|
|
<li>setuptools >= 0.6c6</li>
|
|
<li>nosetests (for the test suite only)</li>
|
|
</ul>
|
|
</div>
|
|
<div class="section" id="installing-with-easy-install">
|
|
<h1>Installing with easy_install</h1>
|
|
<p>If you don't already have <tt class="docutils literal">easy_install</tt> available you'll want to download
|
|
and run the <tt class="docutils literal">ez_setup.py</tt> script:</p>
|
|
<pre class="literal-block">
|
|
$ curl -O http://peak.telecommunity.com/dist/ez_setup.py
|
|
$ sudo python ez_setup.py -U setuptools
|
|
</pre>
|
|
<p>To install or upgrade to the latest released version of Gunicorn:</p>
|
|
<pre class="literal-block">
|
|
$ sudo easy_install -U gunicorn
|
|
</pre>
|
|
</div>
|
|
<div class="section" id="installing-from-source">
|
|
<h1>Installing from source</h1>
|
|
<p>You can install Gunicorn from source as simply as you would install any other
|
|
Python package. Gunicorn uses setuptools which will automatically fetch all
|
|
dependencies (including setuptools itself).</p>
|
|
<div class="section" id="get-a-copy">
|
|
<h2>Get a Copy</h2>
|
|
<p>You can download a tarball of the latest sources from <a class="reference external" href="http://github.com/benoitc/gunicorn/downloads">GitHub Downloads</a> or
|
|
fetch them with <a class="reference external" href="http://git-scm.com/">git</a>:</p>
|
|
<pre class="literal-block">
|
|
$ git clone git://github.com/benoitc/gunicorn.git
|
|
</pre>
|
|
</div>
|
|
<div class="section" id="id1">
|
|
<h2>Installation</h2>
|
|
<pre class="literal-block">
|
|
$ python setup.py install
|
|
</pre>
|
|
<p>If you've cloned the git repository, its highly recommended that you use the
|
|
<tt class="docutils literal">develop</tt> command which will allow you to use Gunicorn from the source
|
|
directory. This will allow you to keep up to date with development on GitHub as
|
|
well as make changes to the source:</p>
|
|
<pre class="literal-block">
|
|
$ python setup.py develop
|
|
</pre>
|
|
</div>
|
|
</div>
|
|
<div class="section" id="installation-requirements-for-sleepy-application-handling">
|
|
<h1>Installation requirements for sleepy application handling</h1>
|
|
<p>If you want to handle <a class="reference external" href="faq.html">sleepy application</a> you will need to install
|
|
<a class="reference external" href="http://eventlet.net">Eventlet</a> or <a class="reference external" href="http://gevent.org">Gevent</a>.</p>
|
|
<p>To install eventlet:</p>
|
|
<pre class="literal-block">
|
|
$ easy_install -U eventlet
|
|
</pre>
|
|
<p>Replace <tt class="docutils literal">eventlet</tt> with <tt class="docutils literal">gevent</tt> if you want to use the <tt class="docutils literal">gevent</tt>
|
|
arbiter.</p>
|
|
<p>You can now launch gunicorn with Eventlet or Gevent arbiter, see
|
|
<a class="reference external" href="usage.html">usage</a> for more information.</p>
|
|
<div class="note">
|
|
<p class="first admonition-title">Note</p>
|
|
<p class="last">If <tt class="docutils literal">eventlet</tt> or <tt class="docutils literal">gevent</tt> fails to install for you, its most likely
|
|
due to an out of date <a class="reference external" href="http://software.schmorp.de/pkg/libev.html">libev</a> library. You'll need to download and install
|
|
a newer version for either of those to modules to work properly.</p>
|
|
</div>
|
|
</div>
|
|
<div class="section" id="installing-on-ubuntu-debian-systems">
|
|
<h1>Installing on Ubuntu/Debian systems</h1>
|
|
<p>If you use <a class="reference external" href="http://www.ubuntu.com/">Ubuntu</a> karmic, you can update your
|
|
system with packages from our <a class="reference external" href="https://launchpad.net/~bchesneau/+archive/gunicorn">PPA</a> by adding <tt class="docutils literal">ppa:bchesneau/gunicorn</tt>
|
|
to your system's Software Sources.</p>
|
|
<p>Or this PPA can be added to your system manually by copying the lines below
|
|
and adding them to your system's software sources:</p>
|
|
<pre class="literal-block">
|
|
deb http://ppa.launchpad.net/bchesneau/gunicorn/ubuntu karmic main
|
|
deb-src http://ppa.launchpad.net/bchesneau/gunicorn/ubuntu karmic main
|
|
</pre>
|
|
<p>Signing key:</p>
|
|
<pre class="literal-block">
|
|
1024R/15E5EB06
|
|
</pre>
|
|
<p>Fingerprint:</p>
|
|
<pre class="literal-block">
|
|
49AEEDFF5CDCD82CEA8AB4DABC981A8115E5EB06
|
|
</pre>
|
|
</div>
|
|
</div>
|
|
|
|
|
|
|
|
<div id="footer">
|
|
<p>This work is licensed under a <a rel="license" href="http://creativecommons.org/licenses/by/3.0/">Creative Commons Attribution 3.0 Unported License</a>.</p>
|
|
<p>Hosted on <a href="http://github.com/">Github</a></p>
|
|
</div>
|
|
</div>
|
|
</body>
|
|
</html> |