Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

django-maintenancemode allows you to temporary shutdown your site for maintenance work

Project Description

django-maintenancemode is a middleware that allows you to temporary shutdown your site for maintenance work.

Logged in users having staff credentials can still fully use the site as can users visiting the site from an IP address defined in Django’s INTERNAL_IPS.

Authored by Remco Wendt, and some great contributors.

How it works

maintenancemode works the same way as handling 404 or 500 error in Django work. It adds a handler503 which you can override in your main or you can add a 503.html to your templates directory.

  • If user is logged in and staff member, the maintenance page is not displayed.

  • If user’s IP is in INTERNAL_IPS, the maintenance page is not displayed.

  • To override the default view which is used if the maintenance mode is enabled you can simply define a handler503 variable in your ROOT_URLCONF, similar to how you would customize other error handlers, e.g. :

    handler503 = 'example.views.maintenance_mode'


  1. Either checkout maintenancemode from GitHub, or install using pip :

    pip install django-maintenancemode
  2. Add maintenancemode to your INSTALLED_APPS :

  3. Add MaintenanceModeMiddleware to MIDDLEWARE_CLASSES, make sure it comes after AuthenticationMiddleware :

  4. Add variable called MAINTENANCE_MODE in your project’s file :

    MAINTENANCE_MODE = True  # Setting this variable to ``True`` activates the middleware.

    or set MAINTENANCE_MODE to False and use maintenance command :

    python ./ maintenance <on|off>

Please see example application. This application is used to manually test the functionalities of this package. This also serves as a good example…

You need only Django 1.4 or above to run that. It might run on older versions but that is not tested.


There are various optional configuration options you can set in your

# Enable / disable maintenance mode.
# Default: False
MAINTENANCE_MODE = True  # or ``False`` and use ``maintenance`` command

# Sequence of URL path regexes to exclude from the maintenance mode.
# Default: ()


django-maintenancemode is released under the BSD license.

Release History

This version
History Node


History Node


History Node


History Node


History Node


History Node

History Node


History Node


History Node


History Node


Download Files

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

Filename, Size & Hash SHA256 Hash Help File Type Python Version Upload Date
(11.1 kB) Copy SHA256 Hash SHA256
Wheel 2.7 Dec 26, 2015
(7.3 kB) Copy SHA256 Hash SHA256
Source None Dec 26, 2015

Supported By

Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Google Google Cloud Servers