---
id: django-tasks-db
version: "0.12.0"
license: BSD-3-Clause
license_treatment: permissive
maintenance: active
---

# django-tasks-db — An ORM-based backend for Django Tasks

License: permissive · Maintenance: active · Downloads: 155.1K/mo

## What it is and what it does

django-tasks-db is a backend for Django's built-in task system that stores task definitions and results directly in your application database instead of requiring a separate message broker or task queue service. It integrates with Django's ORM and provides a management command to run a worker process that executes queued tasks. This approach eliminates the operational complexity of running Redis, RabbitMQ, or Celery, making it suitable for smaller deployments or applications where database-backed task storage is acceptable.

The package supports customizable task ID generation, automatic task result pruning via management command, and development-mode auto-reload. It's actively maintained and supports Django 4.2 through 6.0 on Python 3.10+. Since tasks live in your database, you get built-in persistence and can query task status directly through Django's ORM, but you trade off the scalability and decoupling that external task queues provide.

Use it for:

- Run background jobs in Django without deploying Redis or RabbitMQ.
- Store and audit all task executions in your application database for compliance or debugging.
- Prototype or develop task-based features before committing to a separate queue infrastructure.
- Execute periodic or triggered work within a single-server or small-scale deployment.
- Query task history and status directly via Django ORM without a separate monitoring tool.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

A Django Tasks backend that stores and executes asynchronous tasks in your database using Django's ORM, with a management command to run a worker process.

Yes, if you want a lightweight, database-backed task queue for Django without external infrastructure. The active maintenance, low install friction, and permissive license make it a solid choice for small to medium projects. Not recommended if you need high-throughput task processing, distributed workers across multiple machines, or the decoupling that external queues provide.

## Install

pip install django-tasks-db
uv add django-tasks-db
poetry add django-tasks-db

## Installing django-tasks-db

Before you install: Low install friction with a pure-Python wheel. Actively maintained with recent commits and a stable release. Requires Django, typing_extensions, django-stubs-ext, and django-tasks as runtime dependencies.

License in practice: BSD-3-Clause is a permissive license that allows commercial use, modification, and distribution with minimal restrictions—suitable for most projects.

Quickstart:

pip install django-tasks-db

# In settings.py
INSTALLED_APPS = ["django_tasks_db"]
TASKS = {"default": {"BACKEND": "django_tasks_db.DatabaseBackend", "QUEUES": ["default"]}}

# Run worker
./manage.py db_worker

Requires Python 3.10 or later and Django 4.2+; tasks are stored in the database so schema migrations are needed after installation.

Verify before relying:

- Whether the database backend scales adequately for high-volume task workloads compared to external task queues.
- Performance characteristics when pruning large accumulated task result sets.
- Support for distributed workers across multiple processes or machines.

## Package facts

- License: BSD-3-Clause (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 155.1K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

django task queue database backend, async tasks django orm, django background jobs database, task scheduling django db, django celery alternative database, manage async work django, orm-based task worker, django-tasks, background-jobs, database-backed

[View on SkillFed](https://skillfed.io/packages/django-tasks-db) · [View on PyPI](https://pypi.org/project/django-tasks-db/)