Django Cache Panel

A universal cache inspector for Django.

Compatible with dj-control-room. Register this panel in the Control Room to manage it from a centralized dashboard.

• Official site: djangocontrolroom.com
• Project repo: dj-control-room

Docs

https://django-control-room.github.io/dj-cache-panel/

Features

• Browse Cache Instances: View all configured cache backends from your CACHES setting
• Abilities Matrix: See at a glance which operations each cache supports (Query, Get, Delete, Flush)
• Key Search: Search and browse cache keys with wildcard patterns (for supported backends)
• Value Preview: View cache values directly in search results
• Pagination: Navigate through large sets of keys efficiently
• Admin Integration: Seamlessly integrates with Django's admin interface
• Secure: Only accessible to staff users
• Backend Agnostic: Works with any Django cache backend (with varying feature support)

Requirements

• Python 3.9-3.14
• Django 4.2+

Screenshots

Django Admin Integration

Seamlessly integrated into your Django admin interface. A new section for dj-cache-panel will appear in the same places where your models appear.

NOTE: This application does not actually introduce any model or migrations.

Caches Overview

Get a list of all your caches as well as the allowed capabilities for each cache

Key Search

Key Edits/Adds

Installation

pip install dj-cache-panel dj-control-room

Optional Valkey support (requires Python 3.10+):

pip install dj-cache-panel[valkey] dj-control-room

Add it to INSTALLED_APPS, include its URLs, and migrate:

INSTALLED_APPS = [
    # ...
    "dj_control_room_base",
    "dj_cache_panel",
    "dj_control_room",
    # ...
]

urlpatterns = [
    path("admin/dj-control-room-base/", include("dj_control_room_base.urls")),
    path("admin/dj-cache-panel/", include("dj_cache_panel.urls")),
    path("admin/dj-control-room/", include("dj_control_room.urls")),
    path("admin/", admin.site.urls),
]

The panel reads your existing Django CACHES setting. no extra instance config required for most projects. Advanced options (backend panel mappings, per-cache ability overrides, CSS) are covered in Configuration.

python manage.py migrate

Then visit /admin/ and look for the "DJ CACHE PANEL" section.

For the full walkthrough and production recommendations, see the Installation and Configuration docs. See Scopes for per-view permission scopes.

License

This project is licensed under the MIT License. See the LICENSE file for details.

Contributing

Want to contribute or set up the project for local development? See Contributing for prerequisites, Docker/virtualenv setup, running the example project, and the test suite.