+arbiter="egg:gunicorn" # Or "egg:gunicorn#eventlet" (eventlet or gevent)
+backlog = 2048
bind = "127.0.0.1:8000" # Or "unix:/tmp/gunicorn.sock"
daemon = False # Whether work in the background
debug = False # Some extra logging
+keepalive = 2 # Time we wait for next connection (in ms)
logfile = "-" # Name of the log file
loglevel = "info" # The level at which to log
pidfile = None # Path to a PID file
@@ -65,6 +68,7 @@ user = None # Change process owner to user
group = None # Change process group to group
proc_name = None # Change the process name
tmp_upload_dir = None # Set path used to store temporary uploads
+worker_connections=1000 # Number of connections accepted by a worker
after_fork=lambda server, worker: server.log.info(
"Worker spawned (pid: %s)" % worker.pid),
@@ -79,6 +83,10 @@ before_exec=lambda server: server.log.info("Forked child, reexecuting"
Green Unicorn (gunicorn) is an HTTP/WSGI Server for UNIX designed to serve fast clients and nothing else.
+Green Unicorn (gunicorn) is an HTTP/WSGI Server for UNIX designed to serve fast clients or sleepy applications.
This is a port of Unicorn in Python. Meet us on the #gunicorn IRC channel on Freenode.
Gunicorn is released under the MIT License. See the LICENSE for more details.
If you don't already have easy_install available you'll want to download and run the ez_setup.py script:
+If you don't already have easy_install available you'll want to download and run the ez_setup.py script:
$ curl -O http://peak.telecommunity.com/dist/ez_setup.py $ sudo python ez_setup.py -U setuptools @@ -84,12 +84,22 @@ $ git clone git://github.com/benoitc/gunicorn.git$ python setup.py install-If you've cloned the git repository, its highly recommended that you use the develop 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:
+If you've cloned the git repository, its highly recommended that you use the develop 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:
$ python setup.py develop
If you want to handle sleepy application you will need to install Eventlet or Gevent.
+To install eventlet:
++$ easy_install -U eventlet ++
Replace eventlet by gevent if you want to use gevent.
+You can now launch gunicorn with Eventlet or Gevent arbiter, see usage for more information.
+If you use ubuntu karmic, you can update your system with packages from our PPA by adding ppa:bchesneau/gunicorn to your system's Software Sources.
diff --git a/doc/htdocs/usage.html b/doc/htdocs/usage.html index a3423ef8..52c6c1c3 100644 --- a/doc/htdocs/usage.html +++ b/doc/htdocs/usage.html @@ -56,7 +56,7 @@Thirty seconds to launch the example application packaged with Gunicorn:
+To launch the example application packaged with Gunicorn:
$ cd /path/to/gunicorn/examples/ $ gunicorn --workers=2 test:app @@ -66,6 +66,12 @@ $ gunicorn --workers=2 test:app $ cd ~/ $ gunicorn --workers=12 awesomeproject.wsgi.main:main_app+
To launch the websocket example application using Eventlet:
++$ cd /path/to/gunicorn/examples/ +$ gunicorn -w 12 -a "egg:gunicorn#eventlet" websocket:app ++
and then go on http://localhost:8000 to see the result.
@@ -79,6 +85,9 @@ Options:
unix:/tmp/gunicorn.sock
-w WORKERS, --workers=WORKERS
Number of workers to spawn. [1]
+ -a ARBITER, --arbiter=ARBITER
+ gunicorn arbiter entry point or module
+ [egg:gunicorn#main]
-p PIDFILE, --pid=PIDFILE
set the background PID FILE
-D, --daemon Run daemonized in the background.