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 `_. +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/