Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Small, simple, app to show a down page or redirect to another site while you make upgrades.
Python HTML
Branch: master

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
demo
docs bump release.
downtime Removed testing prints
.gitignore Move migrations.
.travis.yml Add 1.8 to travis.
CHANGELOG.rst bump release.
CONTRIBUTORS.rst Add @kevinglover as a contributor and updating for the next release.
LICENSE Add conributors and prep for new release.
MANIFEST.in
README.md Added tabs for formatting
build.md Bumping versions, docs.
runtests.py Django 1.8
setup.cfg Remove trivial test.
setup.py bump release.
test-requirements.txt Tests.

README.md

Django Downtime

Small, simple, app to show a down page while you make upgrades.

Official Docs

http://django-downtime.readthedocs.org

Install

Django supports versions 1.4 to 1.8 on Python 2.7 and 3.4.

To install django-downtime::

pip install django-downtime

add to installed apps::

downtime

Add downtime middleware to the top your list of installed middlewares::

'downtime.middleware.DowntimeMiddleware',

Settings

Exempted URLs::

DOWNTIME_EXEMPT_EXACT_URLS = (
    '/', # exempts homepage
    '/other_location/not_down/page',
)

Exempted Paths::

DOWNTIME_EXEMPT_PATHS = (
    '/admin',
    '/other_location_not_down',
)

Url Redirect

DOWNTIME_URL_REDIRECT = "http://errors.mypage.com"

Templates

If no URL Redirect is specified a lame default template is rendered, this can be overridden by specifying a downtime/downtime.html template.

Management Commands

There are two managment commands, one to take a project down python manage.py downtime_start and one to set it back up python manage.py downtime_end.

What happens internally when calling python manage.py downtime_start?

This sets a start date time and mark is as enabled. We call this "deployment mode", usually called before running a deployment script.

What happens internally when calling python manage.py downtime_end?

This sets a end date time to all records that has a start date time and no end date time set and are marked as enabled. We call this "closing deployment mode", usually called after running a deployment script.

Something went wrong with that request. Please try again.