Repository files navigation

Gunicorn 'Green Unicorn' is a Python WSGI HTTP Server for UNIX. It's a pre-forkworker model ported from Ruby'sUnicorn project. The Gunicorn server is broadlycompatible with various web frameworks, simply implemented, light on serverresource usage, and fairly speedy.

Feel free to join us in#gunicorn onFreenode.

The documentation is hosted athttp://docs.gunicorn.org.

Gunicorn requiresPython 2.x >= 2.6 orPython 3.x >= 3.2.

Install from PyPI:

$ pip install gunicorn

Basic usage:

$ gunicorn [OPTIONS] APP_MODULE

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

Example with test app:

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

Gunicorn is released under the MIT License. See theLICENSE file for moredetails.