It’s easiest to install Djrill from PyPI:

$ pip install djrill

If you decide to install Djrill some other way, you’ll also need to install its one dependency (other than Django, of course): the requests library from Kenneth Reitz.


In your project’s

  1. Add djrill to your INSTALLED_APPS:

  2. Add the following line, substituting your own MANDRILL_API_KEY:

    MANDRILL_API_KEY = "brack3t-is-awesome"
  3. Override your existing EMAIL_BACKEND with the following line:

    EMAIL_BACKEND = "djrill.mail.backends.djrill.DjrillBackend"

Mandrill Webhooks (Optional)

Djrill includes optional support for Mandrill webhooks, including inbound email. See the Djrill webhooks section for configuration details.

Admin (Optional)

Djrill includes an optional Django admin interface, which allows you to:

  • Check the status of your Mandrill API connection
  • See stats on email senders, tags and urls

If you want to enable the Djrill admin interface, edit your base

from django.contrib import admin

from djrill import DjrillAdminSite = DjrillAdminSite()

urlpatterns = patterns('',
    url(r'^admin/', include(,

Project Versions

Table Of Contents

Previous topic

Djrill 1-2-3

Next topic

Sending Mail

This Page