Each of the following steps needs to be configured for the Debug Toolbar to be fully functional.
Getting the code¶
The recommended way to install the Debug Toolbar is via pip:
$ pip install django-debug-toolbar
If you aren’t familiar with pip, you may also obtain a copy of the
debug_toolbar directory and add it to your Python path.
To test an upcoming release, you can install the in-development version instead with the following command:
$ pip install -e git+https://github.com/jazzband/django-debug-toolbar.git#egg=django-debug-toolbar
Make sure that
'django.contrib.staticfiles' is set up properly and add
'debug_toolbar' to your
INSTALLED_APPS = [ # ... 'django.contrib.staticfiles', # ... 'debug_toolbar', ] STATIC_URL = '/static/'
If you’re upgrading from a previous version, you should review the change log and look for specific upgrade instructions.
Setting up URLconf¶
Add the Debug Toolbar’s URLs to your project’s URLconf as follows:
from django.conf import settings from django.conf.urls import include, url # For django versions before 2.0 from django.urls import include, path # For django versions from 2.0 and up if settings.DEBUG: import debug_toolbar urlpatterns = [ path('__debug__/', include(debug_toolbar.urls)), # For django versions before 2.0: # url(r'^__debug__/', include(debug_toolbar.urls)), ] + urlpatterns
This example uses the
__debug__ prefix, but you can use any prefix that
doesn’t clash with your application’s URLs. Note the lack of quotes around
The Debug Toolbar is mostly implemented in a middleware. Enable it in your settings module as follows:
MIDDLEWARE = [ # ... 'debug_toolbar.middleware.DebugToolbarMiddleware', # ... ]
The order of
MIDDLEWARE is important. You should include the Debug
Toolbar middleware as early as possible in the list. However, it must come
after any other middleware that encodes the response’s content, such as
Configuring Internal IPs¶
The Debug Toolbar is shown only if your IP address is listed in the
INTERNAL_IPS setting. This means that for local
development, you must add
you’ll need to create this setting if it doesn’t already exist in your
INTERNAL_IPS = [ # ... '127.0.0.1', # ... ]
You can change the logic of determining whether or not the Debug Toolbar should be shown with the SHOW_TOOLBAR_CALLBACK option. This option allows you to specify a custom function for this purpose.