summaryrefslogtreecommitdiff
path: root/docs/howto/deployment/checklist.txt
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>
2025-09-17Added backticks to email addresses in docs.Mariusz Felisiak
2024-08-08Refs #35591 -- Emphasized that runserver is not suitable for production.Andrew Miller
2023-03-01Fixed #34140 -- Reformatted code blocks in docs with blacken-docs.django-bot
2023-01-17Removed versionadded/changed annotations for 4.1.Mariusz Felisiak
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-08-17Fixed #32964 -- Corrected 'setup'/'set up' usage in docs.Andrew Northall
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
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-02-08Fixed #30004 -- Changed default FILE_UPLOAD_PERMISSION to 0o644.Himanshu Lakhara
2018-10-11Simplified deployment checklist docs on customizing error views.Adam Johnson
2018-08-04Refs #28540 -- Added FILE_UPLOAD_PERMISSIONS to deployment checklist.Carlton Gibson
2017-05-22Updated various links in docs to avoid redirectsClaude Paroz
Thanks Tim Graham and Mariusz Felisiak for review and completion.
2017-01-18Refs #23919 -- Removed Python 2 notes in docs.Tim Graham
2016-12-28Fixed #27641 -- Doc'd default local-memory caching in deployment checklist.Adam Chainz
2016-09-29Fixed typos in docs/howto/deployment/checklist.txt.Laurent
2016-05-08Fixed #26483 -- Updated docs.python.org links to use Intersphinx.Tim Graham
2016-04-28Fixed #26554 -- Updated docs URLs to readthedocs.ioTim Graham
2016-02-19Fixed #26243 -- Noted that 'python -R' is enabled by default in Python 3.3.Raphael Michel
2016-01-14Fixed #23868 -- Added support for non-unique django-admin-options in docs.Tim Graham
Also documented missing short command line options to fix #24134. This bumps the minimum sphinx version required to build the docs to 1.3.4. Thanks Simon Charette for review.
2015-12-01Fixed #25778 -- Updated docs links to use https when available.Jon Dufresne
2015-07-28Fixed #25178 -- Added DEFAULT_FROM_EMAIL to deployment checklist.Tim Graham
2015-07-25Fixed malformed Sphinx directives.Tim Graham
2015-06-11Added ALLOWED_HOSTS and SERVER_EMAIL details to deployment checklist.Tim Graham
2014-12-28Deprecated TEMPLATE_LOADERS.Aymeric Augustin
2014-12-28Deprecated ALLOWED_INCLUDE_ROOTS.Aymeric Augustin
2014-12-19Used https for most *.python.org linksClaude Paroz
2014-09-12Fixed #17101 -- Integrated django-secure and added check --deploy optionTim Graham
Thanks Carl Meyer for django-secure and for reviewing. Thanks also to Zach Borboa, Erik Romijn, Collin Anderson, and Jorge Carleitao for reviews.
2013-09-07Fixed #20938 -- Added cached sessions note to deployment checklist.Tim Graham
Thanks mjtamlyn for the suggestion.
2013-08-01Fixed #20667 - Removed discussion of DEBUG from tutorial.Tim Graham
Forward-port of 3493f18d78 from master.
2013-07-14Fixed #20746 -- Removed Python 2.6 specific code/docsTim Graham
2013-05-27Fixed #20508 -- ReST typo.Aymeric Augustin
2013-05-23Fixed #20080 - Recommended use of PYTHONHASHSEEDTim Graham
Thanks jacob for the suggestion and ryankask for the patch.
2013-05-09Fixed #20215 -- Disabled persistent connections by default.Aymeric Augustin
2013-03-29Fixed #19897 - Updated static files howto.Tim Graham
Thanks Jan Murre, Reinout van Rees and Wim Feijen, plus Remco Wendt for reviewing.
2013-03-17Two additions to the deployment checklist.Aymeric Augustin
Thanks Erik Romijn.
2013-03-17Fixed #19697 -- Added a deployment checklist.Aymeric Augustin