Gunicorn

Production-ready Python web services

Gunicorn is a dependable WSGI HTTP server for UNIX that keeps Python applications running fast and resilient in production. Built on a pre-fork worker model and trusted in countless deployments, it pairs clean configuration with flexible worker strategies so you can meet any traffic pattern.

Install Gunicorn View on GitHub

$ pip install gunicorn
$ gunicorn example:app --workers 3

Latest release: {{ release }}

Quickstart

Install Gunicorn into your application environment.
Point Gunicorn at your WSGI app: gunicorn myproject.wsgi.
Tune worker type, concurrency, and hooks using the rich settings.

Need a longer walkthrough? Jump into the install guide.

Why teams choose Gunicorn

Works with your framework

Django, Flask, FastAPI, Pyramid, you name it—Gunicorn speaks WSGI so your stack just runs.

Running Gunicorn →

Flexible workers

Sync, async, gevent, eventlet—choose the concurrency model that fits.

Worker classes →

Battle-tested hooks

Lifecycle hooks let you instrument, reload, and extend Gunicorn to match your deployment requirements.

Server hooks →

Containers to bare metal

Deploy with systemd, Kubernetes, Heroku, or Docker—the configuration stays predictable everywhere.

Deployment patterns →

Documentation map

Install: Set up Gunicorn in a clean environment.
Run: CLI usage and integration with frameworks.
Configure: Combine CLI flags and config files effectively.
Settings reference: Generated from the Gunicorn source of truth.
Signals: Manage worker lifecycle in production.
Instrumentation: Monitor metrics and logs.

Community & support

Report bugs or request features on GitHub Issues.
Discuss strategies with maintainers in #gunicorn on Libera Chat.
Contributions are welcome—see the contributing guide and say hi to the maintainers.

3.1 KiB Raw Blame History