summaryrefslogtreecommitdiff
path: root/docs/howto/deployment
diff options
context:
space:
mode:
authorSimon Willison <swillison@gmail.com>2022-10-26 02:51:15 -0700
committerGitHub <noreply@github.com>2022-10-26 11:51:15 +0200
commit022a864a5d1de28b853f009566a24be251e90d96 (patch)
tree65ec23b193e895167562b0e1e7026cb0119f81f4 /docs/howto/deployment
parente51c998f8d6fbc9421e4a1226c144d8035c126e0 (diff)
Fixed #34109 -- Updated instructions for running with Uvicorn.
Co-authored-by: Paolo Melchiorre <paolo@melchiorre.org>
Diffstat (limited to 'docs/howto/deployment')
-rw-r--r--docs/howto/deployment/asgi/uvicorn.txt22
1 files changed, 20 insertions, 2 deletions
diff --git a/docs/howto/deployment/asgi/uvicorn.txt b/docs/howto/deployment/asgi/uvicorn.txt
index 148edc29ea..bcee952ea1 100644
--- a/docs/howto/deployment/asgi/uvicorn.txt
+++ b/docs/howto/deployment/asgi/uvicorn.txt
@@ -12,7 +12,7 @@ Installing Uvicorn
You can install Uvicorn with ``pip``::
- python -m pip install uvicorn gunicorn
+ python -m pip install uvicorn
Running Django in Uvicorn
=========================
@@ -24,12 +24,30 @@ called (separated by a colon).
For a typical Django project, invoking Uvicorn would look like::
- gunicorn myproject.asgi:application -k uvicorn.workers.UvicornWorker
+ python -m uvicorn myproject.asgi:application
This will start one process listening on ``127.0.0.1:8000``. It requires that
your project be on the Python path; to ensure that run this command from the
same directory as your ``manage.py`` file.
+In development mode, you can add ``--reload`` to cause the server to reload any
+time a file is changed on disk.
+
For more advanced usage, please read the `Uvicorn documentation <Uvicorn_>`_.
+Deploying Django using Uvicorn and Gunicorn
+===========================================
+
+Gunicorn_ is a robust web server that implements process monitoring and automatic
+restarts. This can be useful when running Uvicorn in a production environment.
+
+To install Uvicorn and Gunicorn, use the following::
+
+ python -m pip install uvicorn gunicorn
+
+Then start Gunicorn using the Uvicorn worker class like this::
+
+ python -m gunicorn myproject.asgi:application -k uvicorn.workers.UvicornWorker
+
.. _Uvicorn: https://www.uvicorn.org/
+.. _Gunicorn: https://gunicorn.org/