File: gunicorn.txt

package info (click to toggle)
python-django 3%3A5.2.5-1
  • links: PTS, VCS
  • area: main
  • in suites: experimental
  • size: 61,236 kB
  • sloc: python: 361,585; javascript: 19,250; xml: 211; makefile: 182; sh: 28
file content (36 lines) | stat: -rw-r--r-- 1,340 bytes parent folder | download | duplicates (3)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
===============================
How to use Django with Gunicorn
===============================

Gunicorn_ ('Green Unicorn') is a pure-Python WSGI server for UNIX. It has no
dependencies and can be installed using ``pip``.

.. _Gunicorn: https://gunicorn.org/

Installing Gunicorn
===================

Install gunicorn by running ``python -m pip install gunicorn``. For more
details, see the `gunicorn documentation`_.

.. _gunicorn documentation: https://docs.gunicorn.org/en/latest/install.html

Running Django in Gunicorn as a generic WSGI application
========================================================

When Gunicorn is installed, a ``gunicorn`` command is available which starts
the Gunicorn server process. The simplest invocation of gunicorn is to pass the
location of a module containing a WSGI application object named
``application``, which for a typical Django project would look like:

.. code-block:: shell

    gunicorn myproject.wsgi

This will start one process running one thread listening on ``127.0.0.1:8000``.
It requires that your project be on the Python path; the simplest way to ensure
that is to run this command from the same directory as your ``manage.py`` file.

See Gunicorn's `deployment documentation`_ for additional tips.

.. _deployment documentation: https://docs.gunicorn.org/en/latest/deploy.html