Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
gunicorn 'Green Unicorn' is a WSGI HTTP Server for UNIX, fast clients and sleepy applications.
Python HTML Other

This branch is 39 commits behind benoitc:master

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
docs
examples
gunicorn
rpm
scripts
tests
.gitignore
.travis.yml
CONTRIBUTING.md
LICENSE
MAINTAINERS
MANIFEST.in
Makefile
NOTICE
README.rst
THANKS
requirements_dev.txt
requirements_test.txt
setup.cfg
setup.py
tox.ini

README.rst

Gunicorn

Build Status

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 resource usage, and fairly speedy.

Feel free to join us in #gunicorn on Freenode.

Documentation

The documentation is hosted at http://docs.gunicorn.org.

Installation

Gunicorn requires Python 2.x >= 2.6 or Python 3.x >= 3.2.

Install from PyPI:

$ pip install gunicorn

Usage

Basic usage:

$ gunicorn [OPTIONS] APP_MODULE

Where APP_MODULE is of the pattern $(MODULE_NAME):$(VARIABLE_NAME). The module name can be a full dotted path. The variable name refers to a WSGI callable that should be found in the specified module.

Example with test app:

$ cd examples
$ gunicorn --workers=2 test:app

License

Gunicorn is released under the MIT License. See the LICENSE file for more details.

Something went wrong with that request. Please try again.