summaryrefslogtreecommitdiff
path: root/docs/howto/deployment
AgeCommit message (Collapse)Author
2026-05-20Refs #35514 -- Cleaned up mailers docs.Mike Edmunds
* Fixed typos related to automated EMAIL_PROVIDERS -> MAILERS renaming. * Clarified wording in some recently added/updated sections. * Removed deprecated, extraneous `fail_silently=False` from examples. * Moved EmailBackend API documentation out of "Email backends" intro into a dedicated section in email.txt. * Sorted MAILERS alphabetically in settings.txt.
2026-05-13Fixed #35514 -- Implemented dictionary-based MAILERS.Mike Edmunds
See DEP 0018. Added: * MAILERS setting. * django.core.mail.mailers dict-like EmailBackend factory. * `using` argument to mail sending APIs. * `sent_using` attribute to mail.outbox messages in locmem backend. * MAILERS in startproject settings template, set to console backend. * AdminLogHandler.using argument. * BrokenLinkEmailsMiddleware.send_mail() method. Updated: * BaseEmailBackend to track the MAILERS alias used to construct it, and to report errors for unknown kwargs (OPTIONS). * EmailBackend implementations to initialize from kwargs (OPTIONS) only when MAILERS is being used. * smtp.EmailBackend to require `host` option and to default `port` option based on SSL/TLS options. * SimpleTestCase setup to substitute the locmem backend for all defined MAILERS configurations. * Django's tests that send mail to define MAILERS. Deprecated: * EMAIL_BACKEND and other backend-related EMAIL_* settings. * mail.get_connection(). * The `connection`, `fail_silently`, `auth_user`, and `auth_password` arguments to mail functions. * The EmailMessage.connection attribute. * BaseEmailBackend support for `fail_silently`. Backends that support fail_silently (SMTP, console, file) now implement it directly. * AdminEmailHandler.email_backend argument. Removed undocumented features without deprecation: * EmailMessage.get_connection() method. (send() now raises an error if a subclass has attempted to override it.) * EmailMessage.send() no longer sets self.connection to the connection used for sending. (It still _uses_ a pre-existing self.connection.) * AdminEmailHandler.connection() method. (Init now raises an error if a subclass has attempted to override it.) Thanks to Natalia Bidart for shepherding DEP 0018 and for extensive reviews and suggestions on the implementation. Thanks to Jacob Rief for the initial implementation and multiple iterations while refining the design. Co-authored-by: Jacob Rief <jacob.rief@gmail.com>
2026-04-07Updated Apache links to the current docs.Mariusz Felisiak
2026-04-07Removed outdated note about uwsgi LTS from docs.Mariusz Felisiak
projects.unbit.it has an invalid certificate and provides old packages.
2026-03-27Corrected outdated links to gunicorn documentation.Sebastian Skonieczny
2025-12-19Fixed #36781 -- Added Granian to deployment documentation.JaeHyuck Sa
Signed-off-by: JaeHyuck Sa <wogur981208@gmail.com>
2025-11-20Fixed typo in docs/howto/deployment/wsgi/apache-auth.txt.Jacob Walls
2025-09-17Added backticks to email addresses in docs.Mariusz Felisiak
2025-08-28Ensured :doc: role uses absolute targets in docs.Adam Johnson
2025-08-25Refs #36485 -- Rewrapped docs to 79 columns line length.David Smith
Lines in the docs files were manually adjusted to conform to the 79 columns limit per line (plus newline), improving readability and consistency across the content.
2024-10-21Updated Hypercorn links in docs/howto/deployment/asgi/hypercorn.txt.amirreza sohrabi far
2024-09-05Updated instruction for deploying with Uvicorn and Gunicorn.SirenityK
2024-08-08Refs #35591 -- Emphasized that runserver is not suitable for production.Andrew Miller
2023-04-17Used extlinks for PyPI links.Tim Graham
Co-authored-by: Mariusz Felisiak <felisiak.mariusz@gmail.com>
2023-03-07Refs #31626 -- Noted that Daphne provides a runserver command.Carlton Gibson
2023-03-01Fixed #34140 -- Reformatted code blocks in docs with blacken-docs.django-bot
2023-02-10Refs #34140 -- Applied rst code-block to non-Python examples.Carlton Gibson
Thanks to J.V. Zammit, Paolo Melchiorre, and Mariusz Felisiak for reviews.
2023-01-17Removed versionadded/changed annotations for 4.1.Mariusz Felisiak
2022-10-26Fixed #34109 -- Updated instructions for running with Uvicorn.Simon Willison
Co-authored-by: Paolo Melchiorre <paolo@melchiorre.org>
2022-08-09Fixed #33842 -- Used :source: role for links to repo files on GitHub.Ramil Yanbulatov
2022-03-22Fixed #33544 -- Expanded the TEMPLATES section of the Deployment checklist.Samuel Hartmann
Clarified that the cached template loader is enabled by default when DEBUG = False.
2022-02-01Fixed #30360 -- Added support for secret key rotation.tschilling
Thanks Florian Apolloner for the implementation idea. Co-authored-by: Andreas Pelme <andreas@pelme.se> Co-authored-by: Carlton Gibson <carlton.gibson@noumenal.es> Co-authored-by: Vuyisile Ndlovu <terrameijar@gmail.com>
2021-10-08Improved docs regarding UTF-8 support with Apache and mod_wsgi.Nick Frazier
2021-08-17Fixed #32964 -- Corrected 'setup'/'set up' usage in docs.Andrew Northall
2021-07-29Refs #32880 -- Made remaining titles consistent in how-to documents.Mariusz Felisiak
Follow up to 22fbebc7444c8974f101c146f0fc18fe64ab48f6.
2021-07-29Fixed 32956 -- Lowercased spelling of "web" and "web framework" where ↵David Smith
appropriate.
2021-07-28Refs #32956 -- Lowercased "internet" and "email" where appropriate.David Smith
2021-05-17Refs #32720 -- Updated various links in docs to avoid redirects and use HTTPS.Nick Pope
2020-09-29Updated ASGI uvicorn deployment docs.Thomas Grainger
2020-08-05Added Hypercorn to ASGI deployment guide. Phil Jones
2020-06-02Fixed #31643 -- Changed virtualenv doc references to Python 3 venv.Jon Dufresne
2020-05-25Removed instructions for unsupported Apache versions.Claude Paroz
2020-05-13Used :envvar: role and .. envvar:: directive in various docs.Nick Pope
2020-05-13Used :pep: role in various docs.Nick Pope
2020-04-01Prevented (and corrected) single backtick usage in docs.Adam Johnson
2020-03-25Improved sessions notes in deployment checklist.Adam Johnson
- Added note to clear old sessions when using database-backend. - Made note to consider the cache backend more generic.
2019-12-20Refs #30767 -- Improved deployment documentation.Katie McLaughlin
2019-12-04Refs #20935 -- Removed duplicate ToC references.Fredrik
These sections are being referred to already from other locations. Having multiple references to the same location from the ToC is ambiguous, and causes errors in the EPUB build.
2019-10-02Fixed some typos in comments and docs.Min ho Kim
Thanks to Mads Jenson for review.
2019-09-09Fixed #30767 -- Improved references to deployment documentation.Katie McLaughlin
* Increased tocdepth to expose more complexity of topics. * Ensured deployment checklist is linked on main doc page.
2019-09-06Fixed #30573 -- Rephrased documentation to avoid words that minimise the ↵Tobias Kunze
involved difficulty. This patch does not remove all occurrences of the words in question. Rather, I went through all of the occurrences of the words listed below, and judged if they a) suggested the reader had some kind of knowledge/experience, and b) if they added anything of value (including tone of voice, etc). I left most of the words alone. I looked at the following words: - simply/simple - easy/easier/easiest - obvious - just - merely - straightforward - ridiculous Thanks to Carlton Gibson for guidance on how to approach this issue, and to Tim Bell for providing the idea. But the enormous lion's share of thanks go to Adam Johnson for his patient and helpful review.
2019-07-16Updated WSGI servers ordering according to the more commonly used.Frank Wiles
2019-06-20Fixed #30451 -- Added ASGI handler and coroutine-safety.Andrew Godwin
This adds an ASGI handler, asgi.py file for the default project layout, a few async utilities and adds async-safety to many parts of Django.
2019-04-18Fixed #30367 -- Changed "pip install" to "python -m pip install" in docs, ↵Ramiro Morales
comments and hints.
2019-02-08Fixed #30004 -- Changed default FILE_UPLOAD_PERMISSION to 0o644.Himanshu Lakhara
2018-11-10Updated some links to https and new locations.Mads Jensen
2018-10-11Simplified deployment checklist docs on customizing error views.Adam Johnson
2018-09-26Refs #29784 -- Switched to https:// links where available.Jon Dufresne
2018-08-04Refs #28540 -- Added FILE_UPLOAD_PERMISSIONS to deployment checklist.Carlton Gibson
2018-01-07Updated various links in docs to use HTTPS.Mariusz Felisiak
generated by cgit v1.3 (git 2.53.0) at 2026-07-01 21:15:57 +0000