diff --git a/docs/howto/deployment/asgi/daphne.txt b/docs/howto/deployment/asgi/daphne.txt index 5948288f07..48c0ab41c1 100644 --- a/docs/howto/deployment/asgi/daphne.txt +++ b/docs/howto/deployment/asgi/daphne.txt @@ -33,3 +33,22 @@ For a typical Django project, invoking Daphne would look like: 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. + +.. _daphne-runserver: + +Integration with ``runserver`` +============================== + +Daphne provides a :djadmin:`runserver` command to serve your site under ASGI +during development. + +This can be enabled by adding ``daphne`` to the start of your +:setting:`INSTALLED_APPS` and adding an ``ASGI_APPLICATION`` setting pointing +to your ASGI application object:: + + INSTALLED_APPS = [ + "daphne", + ..., + ] + + ASGI_APPLICATION = "myproject.asgi.application" diff --git a/docs/ref/django-admin.txt b/docs/ref/django-admin.txt index f757ce16d9..bda8aba7b5 100644 --- a/docs/ref/django-admin.txt +++ b/docs/ref/django-admin.txt @@ -1019,6 +1019,13 @@ By default, the development server doesn't serve any static files for your site you want to configure Django to serve static media, read :doc:`/howto/static-files/index`. +Serving with ASGI in development +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Django's ``runserver`` command provides a WSGI server. In order to run under +ASGI you will need to use an :doc:`ASGI server `. +The Django Daphne project provides :ref:`daphne-runserver` that you can use. + ``sendtestemail`` -----------------