gunicorn/docs/site/index.html
Prateek Singh Paudel f6e2fbc935 Add new website.
Older html is modified with redirect code to redirect to relevant
part in newsite or docs. So, someone linking to us will still work.
2012-10-04 00:43:15 +05:45

186 lines
7.0 KiB
HTML

<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="utf-8" />
<title>Gunicorn &dash; Python WSGI HTTP Server for UNIX</title>
<meta http-equiv="X-UA-Compatible" content="IE=edge,chrome=1">
<link rel="stylesheet" type="text/css" href="css/style.css" />
<link rel="shortcut icon" href="images/favicon.png" type="image/x-icon">
</head>
<body>
<div class="logo-wrapper">
<div class="logo-div">
<div class="logo"><img src="images/logo.jpg" ></div>
</div>
</div>
<div class="banner-wrapper">
<div class="banner">
<div class="title"><img src="images/title.png"></div>
<h1>Gunicorn 'Green Unicorn' is a Python WSGI HTTP Server for UNIX. It's a pre-fork worker model ported from Ruby's Unicorn project. The Gunicorn server is broadly compatible with various web frameworks, simply implemented, light on server resources, and fairly speedy.</h1>
<div class="banner-button">
<a href="https://github.com/benoitc/gunicorn" title="View source at github" class="greenbutton">View source</a>
<a href="http://pypi.python.org/pypi/gunicorn/" title="Download from PyPi" class="redbutton">Download</a>
</div>
</div>
</div>
<div class="mid-wrapper">
<div class="tabs">
<ul class="tab-bar">
<li class="active">
<a href="#quickstart" title="Quickstart" class="gabout">
<h2>Quickstart</h2>
<p>Quickstart guide to getting started with using Gunicorn.</p>
</a>
</li>
<li class="withborder">
<a href="#deployment" title="Deployment" class="gdownloads">
<h2>Deployment</h2>
<p>Learn how to deploy the Gunicorn server.</p>
</a>
</li>
<li class="withborder">
<a href="#community" title="Community" class="gcommunity">
<h2>Community</h2>
<p>Get in touch with the community.</p>
</a>
</li>
<li class="withborder">
<a href="#docs" title="Documentation" class="gdocuments">
<h2>Documentation</h2>
<p>Read documentation to learn more about the Gunicorn.</p>
</a>
</li>
</ul>
<div class="clearall active"></div>
<div class="tab-box active" data-tab="quickstart">
<h1>Installation</h1>
<p>
Here's a quick rundown on how to get started with gunicorn. For more detail read the documentation.
</p>
<pre>
$ sudo pip install virtualenv
$ mkdir ~/environments/
$ virtualenv ~/environments/tutorial/
$ cd ~/environments/tutorial/
$ ls
bin include lib
$ source bin/activate
(tutorial) $ pip install gunicorn
(tutorial) $ mkdir myapp
(tutorial) $ cd myapp/
(tutorial) $ vi myapp.py
(tutorial) $ cat myapp.py
def app(environ, start_response):
data = "Hello, World!\n"
start_response("200 OK", [
("Content-Type", "text/plain"),
("Content-Length", str(len(data)))
])
return iter([data])
(tutorial) $ ../bin/gunicorn -w 4 myapp:app
2010-06-05 23:27:07 [16800] [INFO] Arbiter booted
2010-06-05 23:27:07 [16800] [INFO] Listening at: http://127.0.0.1:8000
2010-06-05 23:27:07 [16801] [INFO] Worker spawned (pid: 16801)
2010-06-05 23:27:07 [16802] [INFO] Worker spawned (pid: 16802)
2010-06-05 23:27:07 [16803] [INFO] Worker spawned (pid: 16803)
2010-06-05 23:27:07 [16804] [INFO] Worker spawned (pid: 16804)
</pre>
</div>
<div class="tab-box" data-tab="deployment">
<h1>Deployment</h1>
<p>
Gunicorn is wsgi http server. It is best to use Gunicorn behind HTTP proxy server. We strongly advise you to use <a href="http://www.nginx.org/">nginx</a>.
</p>
<p>Here's an example to help you get started with using nginx.</p>
<pre>
server {
listen 80;
server_name example.org;
access_log /var/log/nginx/example.log;
location / {
proxy_pass http://127.0.0.1:8000;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
}
}
</pre>
<p>Nginx is set up as reverse proxy server to gunicorn server which is running at localhost port 8000.</p>
<p>Read the full documentation at <a href="#">docs.gunicorn.org</a></p>
</div>
<div class="tab-box" data-tab="community">
<h1>Mailing list</h1>
<p>The user mailing list is general discussion and support list for
Gunicorn users.</p>
<ul>
<li>
To subscribe, send an email to <a href="mailto:user+subscribe&#64;gunicorn.org">user+subscribe&#64;gunicorn.org</a>
</li>
<li>
To unsubscribe, send an email to <a href="mailto:user+unsubscribe&#64;gunicorn.org">user+unsubscribe&#64;gunicorn.org</a>
</li>
<li>
Finally, to post a message to the list use the address to
<a href="mailto:user&#64;gunicorn.org">user&#64;gunicorn.org</a>
</li>
</ul>
<p>The archive for this list can also be <a href="http://lists.gunicorn.org/user">browsed online</a>.</p>
<h1>Irc</h1>
<p>The Gunicorn channel is on the <a href="http://freenode.net/">Freenode</a> IRC
network. You can chat with other on <a href="http://webchat.freenode.net/?channels=gunicorn">#gunicorn channel</a>.</p>
<h1>Issue Tracking</h1>
<p>Bug reports, enhancement requests and tasks generally go in the <a href="http://github.com/benoitc/gunicorn/issues">Github
issue tracker</a>.</p>
</div>
<div class="tab-box" data-tab="docs">
<h1>Documentation</h1>
<p>You can read more comprehensive documentation at <a href="http://docs.gunicorn.org">docs.gunicorn.org</a>.</p>
<p>The contents are:</p>
<ul>
<li><a href="#">Installation</a></li>
<li><a href="#">Commands</a></li>
<li><a href="#">Configuration</a></li>
<li><a href="#">Deployment</a></li>
<li><a href="#">Design</a></li>
<li><a href="#">FAQ</a></li>
<li><a href="#">Changelog</a></li>
</div>
</div>
</div>
<!-- <div class="user-wrapper">
<div class="users">
<div class="left-details">
<h3>Who is using</h3>
<h2>Gunicorn</h2>
</div>
<div class="company-logos">
<a href="#"><img src="images/user1.jpg"></a>
<a href="#"><img src="images/user1.jpg"></a>
<a href="#"><img src="images/user1.jpg"></a>
<a href="#"><img src="images/user1.jpg"></a>
<a href="#"><img src="images/user1.jpg"></a>
<a href="#"><img src="images/user1.jpg"></a>
</div>
<div class="clearall"></div>
</div>
</div> -->
<div class="footer">
<div class="footer-wp">
This open sourced site is hosted on GitHub. <br>
<a href="http://github.com/benoitc/gunicorn/issues">Patches, suggestions, and comments are welcome.</a>
</div>
</div>
<script src="http://ajax.googleapis.com/ajax/libs/jquery/1.7.2/jquery.min.js"></script>
<script src="js/main.js"></script>
</body>
</html>