{"title":"How to use Django with uWSGI","version":"4.1","locale":"en","docname":"howto/deployment/wsgi/uwsgi","url":"/en/4.1/howto/deployment/wsgi/uwsgi/","canonical":"https://djangodocs.dev/en/4.1/howto/deployment/wsgi/uwsgi/","summary":"uWSGI is a fast, self-healing and developer/sysadmin-friendly application container server coded in pure C. See also The uWSGI docs offer a tutorial covering…","html":"

How to use Django with uWSGILink to this heading#

\n

uWSGI is a fast, self-healing and developer/sysadmin-friendly application\ncontainer server coded in pure C.

\n\n
\n

Prerequisite: uWSGILink to this heading#

\n

The uWSGI wiki describes several installation procedures. Using pip, the\nPython package manager, you can install any uWSGI version with a single\ncommand. For example:

\n
Shell
# Install current stable version.\n$ python -m pip install uwsgi\n\n# Or install LTS (long term support).\n$ python -m pip install https://projects.unbit.it/downloads/uwsgi-lts.tar.gz\n
\n
\n

uWSGI modelLink to this heading#

\n

uWSGI operates on a client-server model. Your web server (e.g., nginx, Apache)\ncommunicates with a django-uwsgi “worker” process to serve dynamic content.

\n
\n
\n

Configuring and starting the uWSGI server for DjangoLink to this heading#

\n

uWSGI supports multiple ways to configure the process. See uWSGI’s\nconfiguration documentation.

\n

Here’s an example command to start a uWSGI server:

\n
Shell
uwsgi --chdir=/path/to/your/project \\\n    --module=mysite.wsgi:application \\\n    --env DJANGO_SETTINGS_MODULE=mysite.settings \\\n    --master --pidfile=/tmp/project-master.pid \\\n    --socket=127.0.0.1:49152 \\      # can also be a file\n    --processes=5 \\                 # number of worker processes\n    --uid=1000 --gid=2000 \\         # if root, uwsgi can drop privileges\n    --harakiri=20 \\                 # respawn processes taking more than 20 seconds\n    --max-requests=5000 \\           # respawn processes after serving 5000 requests\n    --vacuum \\                      # clear environment on exit\n    --home=/path/to/virtual/env \\   # optional path to a virtual environment\n    --daemonize=/var/log/uwsgi/yourproject.log      # background the process\n
\n

This assumes you have a top-level project package named mysite, and\nwithin it a module mysite/wsgi.py that contains a WSGI application\nobject. This is the layout you’ll have if you ran django-admin\nstartproject mysite (using your own project name in place of mysite) with\na recent version of Django. If this file doesn’t exist, you’ll need to create\nit. See the How to deploy with WSGI documentation for the default\ncontents you should put in this file and what else you can add to it.

\n

The Django-specific options here are:

\n\n

Example ini configuration file:

\n
Shell
[uwsgi]\nchdir=/path/to/your/project\nmodule=mysite.wsgi:application\nmaster=True\npidfile=/tmp/project-master.pid\nvacuum=True\nmax-requests=5000\ndaemonize=/var/log/uwsgi/yourproject.log\n
\n

Example ini configuration file usage:

\n
Shell
uwsgi --ini uwsgi.ini\n
\n\n

See the uWSGI docs on managing the uWSGI process for information on\nstarting, stopping and reloading the uWSGI workers.

\n
\n
","rootId":"how-to-use-django-with-uwsgi","toc":[{"title":"Prerequisite: uWSGI","anchor":"prerequisite-uwsgi","children":[{"title":"uWSGI model","anchor":"uwsgi-model","children":[]},{"title":"Configuring and starting the uWSGI server for Django","anchor":"configuring-and-starting-the-uwsgi-server-for-django","children":[]}]}],"breadcrumbs":[{"docname":"howto/index","title":"“How-to” guides","url":"/en/4.1/howto/"},{"docname":"howto/deployment/index","title":"How to deploy Django","url":"/en/4.1/howto/deployment/"},{"docname":"howto/deployment/wsgi/index","title":"How to deploy with WSGI","url":"/en/4.1/howto/deployment/wsgi/"}],"prev":{"docname":"howto/deployment/wsgi/gunicorn","title":"How to use Django with Gunicorn","url":"/en/4.1/howto/deployment/wsgi/gunicorn/"},"next":{"docname":"howto/deployment/wsgi/modwsgi","title":"How to use Django with Apache and mod_wsgi","url":"/en/4.1/howto/deployment/wsgi/modwsgi/"},"formats":{"html":"/en/4.1/howto/deployment/wsgi/uwsgi/","markdown":"/en/4.1/howto/deployment/wsgi/uwsgi.md","json":"/en/4.1/howto/deployment/wsgi/uwsgi.json"},"source":"https://github.com/django/django/blob/stable/4.1.x/docs/howto/deployment/wsgi/uwsgi.txt","official":"https://docs.djangoproject.com/en/4.1/howto/deployment/wsgi/uwsgi/","inVersions":["dev","6.1","6.0","5.2","5.1","5.0","4.2","4.1","4.0","3.2","3.1","3.0","2.2","2.1","2.0","1.11","1.10","1.9","1.8"],"inLocales":["en","zh-hans","fr","ja","id","it","pt-br","ko","es","el","pl"]}