summaryrefslogtreecommitdiff
path: root/docs/howto
diff options
context:
space:
mode:
authorAndrew Miller <info@akmiller.co.uk>2024-08-07 14:47:05 +0100
committerSarah Boyce <42296566+sarahboyce@users.noreply.github.com>2024-08-08 10:08:53 +0200
commitcec62fb99e8ff63f30c7871a048ab15081142668 (patch)
tree89b1d1826fe27295247b4e012d383f38e330afce /docs/howto
parent49815f70e4508ae21135f725da177fc2935de32c (diff)
Refs #35591 -- Emphasized that runserver is not suitable for production.
Diffstat (limited to 'docs/howto')
-rw-r--r--docs/howto/deployment/checklist.txt8
-rw-r--r--docs/howto/deployment/index.txt3
2 files changed, 10 insertions, 1 deletions
diff --git a/docs/howto/deployment/checklist.txt b/docs/howto/deployment/checklist.txt
index 75c9735e86..0f4bd158f8 100644
--- a/docs/howto/deployment/checklist.txt
+++ b/docs/howto/deployment/checklist.txt
@@ -36,6 +36,14 @@ Some of the checks described below can be automated using the :option:`check
--deploy` option. Be sure to run it against your production settings file as
described in the option's documentation.
+Switch away from ``manage.py runserver``
+========================================
+
+The :djadmin:`runserver` command is not designed for a production setting. Be
+sure to switch to a production-ready WSGI or ASGI server. For a few common
+options, see :doc:`WSGI servers </howto/deployment/wsgi/index>` or
+:doc:`ASGI servers </howto/deployment/asgi/index>`.
+
Critical settings
=================
diff --git a/docs/howto/deployment/index.txt b/docs/howto/deployment/index.txt
index e2fadba5b9..2f53a97bef 100644
--- a/docs/howto/deployment/index.txt
+++ b/docs/howto/deployment/index.txt
@@ -12,7 +12,8 @@ the scope of what Django can give you as guidance.
Django, being a web framework, needs a web server in order to operate. And
since most web servers don't natively speak Python, we need an interface to
-make that communication happen.
+make that communication happen. The :djadmin:`runserver` command starts a
+lightweight development server, which is not suitable for production.
Django currently supports two interfaces: WSGI and ASGI.