diff options
author | Carlton Gibson <carlton.gibson@noumenal.es> | 2023-03-07 19:47:55 +0100 |
---|---|---|
committer | GitHub <noreply@github.com> | 2023-03-07 19:47:55 +0100 |
commit | 279e611c017b5fcc055263e760de1495a9098ede (patch) | |
tree | 444d95fcaf911fa543bc560690db7e97d3a1765a /docs | |
parent | e846c5e7246a0ffbe5dcf07a2b6c7c2a47537eb3 (diff) | |
download | django-279e611c017b5fcc055263e760de1495a9098ede.tar.gz |
Refs #31626 -- Noted that Daphne provides a runserver command.
Diffstat (limited to 'docs')
-rw-r--r-- | docs/howto/deployment/asgi/daphne.txt | 19 | ||||
-rw-r--r-- | docs/ref/django-admin.txt | 7 |
2 files changed, 26 insertions, 0 deletions
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 56e29861ee..290d31f253 100644 --- a/docs/ref/django-admin.txt +++ b/docs/ref/django-admin.txt @@ -1013,6 +1013,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 </howto/deployment/asgi/index>`. +The Django Daphne project provides :ref:`daphne-runserver` that you can use. + ``sendtestemail`` ----------------- |