django-health-check

What it is and what it does

Django HealthCheck is a Django app that adds pluggable health check endpoints to your application. It lets you monitor the health of your Django app and its connected services—databases, DNS, and other dependencies—by exposing a standardized endpoint that external monitoring systems or load balancers can query. The package is designed to be extensible: you enable only the checks you need by adding them to your Django configuration.

The package has been maintained since 2011 and is currently in production-stable status. It depends only on Django and dnspython, making it lightweight to add to an existing project. It supports modern Python versions (3.10 through 3.14) and recent Django releases (5.2 through 6.1), so integration with contemporary stacks is straightforward.

Use it for:

• Expose a health check endpoint for Kubernetes liveness and readiness probes in containerized Django deployments.
• Monitor database connectivity and other service dependencies as part of a load balancer health check strategy.
• Integrate with external monitoring systems (Datadog, New Relic, etc.) that poll a standard health endpoint.
• Verify DNS resolution and other network-dependent services are functioning before routing traffic to the app.
• Build custom health checks for application-specific services by extending the pluggable framework.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Provides pluggable health check endpoints for Django applications to monitor the app and its connected services like databases and DNS.

Yes. It is actively maintained, has no known vulnerabilities, low install friction, and a permissive license. The package solves a concrete operational need—exposing standardized health checks—that is essential for production Django deployments in containerized or load-balanced environments. Install it if you need to integrate your Django app with orchestration systems or external monitoring.

Install

django-health-check on PyPI

pip install django-health-check

uv add django-health-check

poetry add django-health-check

Installing django-health-check

Before you install

Low friction install with only Django and dnspython as runtime dependencies. Actively maintained with a release 7 days ago and 1423 repository stars; supports current Python versions from 3.10 through 3.14 and Django 5.2 through 6.1.

License in practice

Licensed under MIT (permissive), so you can use it freely in commercial and private projects with minimal restrictions.

Quickstart

pip install django-health-check

# In Django settings.py, add to INSTALLED_APPS:
# 'health_check',
# 'health_check.db',
# 'health_check.contrib.django_mailbox',

# Then access health status at /health/

Requires Django and Python 3.10 or later; dnspython is a runtime dependency for DNS health checks.

Verify before relying

• Which specific services (database backends, caches, message queues) are supported by the pluggable health check system.
• Whether the health check endpoint requires authentication or can be exposed publicly.
• Performance impact of running health checks on application startup or per-request.

Package facts

Evidence: django_health_check-4.5.0-py3-none-any.whl

Keywords: django, postgresql

Tags

More Utilities packages