Skip to main content

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.



  • Changed the middleware to not fetch the user instance if both MAINTENANCE_ALLOW_STAFF and MAINTENANCE_ALLOW_SUPERUSER are False.
  • Added support for django 3.1.


  • Added support for django 2.x, dropped support for django < 1.11. It may still work with django 1.8, but this is no longer tested.


  • Getting ready for Django 1.10 release.
  • Dropped support for Django 1.3 and older.


  • Enable network specify in INTERNAL_IPS


  • Added management command to set maintenance mode on/off


  • Made sure the app runs on Django 1.8.


  • Got rid of dependency on setuptools
  • Added ability to exclude specific paths from maintenance mode with the MAINTENANCE_IGNORE_URLS setting.
  • Use RequestContext when rending the 503.html template.
  • Use tox for running the tests instead of buildout.
  • Made sure the app runs on Django 1.4.


  • Minor documentation updates for the switch to github, expect more changes to follow soon.


  • Fixed an issue with setuptools, thanks for reporting this ksato9700


  • Tested django-maintenancemode with django-1.0 release (following the 1.0.X release branch)
  • Bundled buildout.cfg and bootstrap with the source version of the project, allowing repeatable buildout
  • The middleware now uses its own default config file, thanks to a patch by semente
  • Use INTERNAL_IPS to check for users that need access. user.is_staff will stay in place for backwards incompatibility. Thanks for the idea Joshua Works
  • Have sdist only distribute maintenancemode itself, no longer distribute tests and buildout stuff
  • Use README and CHANGES in’s long_description, stolen from Jeroen’s djangorecipe :)
  • Updated the documentation and now use pypi as the documentation source (link there from google code)


First release

Download files

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

Files for django-maintenancemode, version 0.11.4
Filename, size File type Python version Upload date Hashes
Filename, size django_maintenancemode-0.11.4-py2.py3-none-any.whl (10.6 kB) File type Wheel Python version 3.8 Upload date Hashes View
Filename, size django-maintenancemode-0.11.4.tar.gz (8.4 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page