Skip to main content

Centralize and relay email from multiple distributed Django projects to an internal SMTP server via a database queue.

Project description


PyPI PyPI - Python Version Django Version

django-email-relay enables Django projects without direct access to a preferred SMTP server to use that server for email dispatch.

It consists of two parts:

  1. A Django app with a custom email backend that stores emails in a central database queue. This is what you will use on all the distributed Django projects that you would like to give access to the preferred SMTP server.

  2. A relay service that reads from this queue to orchestrate email sending. It is available as either a standalone Docker image or a management command to be used within a Django project that does have access to the preferred SMTP server.


  • Python 3.8, 3.9, 3.10, 3.11, 3.12
  • Django 3.2, 4.2, 5.0

Getting Started

Visit the documentation for more information. There you will find:

  • Why we created this package and how it can help you.
  • How to install and configure the relay service and Django app.
  • How to use the Django app to send emails.
  • Things to be aware of when it comes time to update the package.
  • How you can contribute to the package.


This package is heavily inspired by the django-mailer package. django-mailer is licensed under the MIT license, which is also the license used for this package. The required copyright notice is included in the LICENSE file for this package.


django-email-relay is licensed under the MIT license. See the LICENSE file for more information.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

django_email_relay-0.4.3.tar.gz (33.3 kB view hashes)

Uploaded Source

Built Distribution

django_email_relay-0.4.3-py3-none-any.whl (13.9 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page