In today's digital age, managing tasks efficiently is crucial for any web application's success. While Django simplifies the development process by providing a robust structure for building scalable applications.

However, when it comes to scheduling and managing asynchronous tasks, developers often find themselves in need of a more specialized solution.

Enter Django Tasks Scheduler, a powerful tool designed to integrate seamlessly with Django projects, offering a flexible and database-backed approach to scheduling tasks.

This article will introduce you to the Django Tasks Scheduler, highlighting its key features and how it can transform task management in your Django applications.

What is Django Tasks Scheduler?

Django Tasks Scheduler is a comprehensive solution for managing asynchronous tasks within Django applications. It's a powerful framework that provides developers with the ability to schedule, execute, and monitor background tasks with ease. Leveraging Django's own database models, it allows for tasks to be defined and tracked through the Django admin interface or directly within the code.

This scheduler is not just about running delayed or scheduled tasks; it's a full-fledged system that supports one-time tasks, periodic tasks based on intervals, and even tasks scheduled using cron expressions for complex timing requirements. It offers a database-backed way to store tasks, their execution status, and results, making it easy to monitor and retry tasks as needed.

The flexibility of Django Tasks Scheduler means it can be used for a wide range of applications, from sending batch emails at a scheduled time and generating reports during off-peak hours, to performing maintenance tasks like database backups regularly. Its integration with Django's ecosystem allows developers to build robust and scalable applications that can handle asynchronous workloads efficiently, improving the overall performance and user experience.

Main features of Django Tasks Scheduler

Django Tasks Scheduler boasts several key features that make it a highly versatile and efficient tool for managing asynchronous tasks in Django applications:

Database-Backed Scheduling: Utilizes Django's ORM to store tasks, their parameters, execution times, and statuses. This allows for durable and reliable task scheduling, ensuring tasks are not lost between deployments or server restarts.

Django Admin Integration: Seamlessly integrates with Django's admin interface, providing a user-friendly way to schedule, monitor, and manage tasks directly from the admin dashboard. This includes creating new tasks, viewing the list of scheduled and executed tasks, and examining the outcomes of task executions.

Flexible Scheduling Options: Supports a variety of scheduling options, including one-time tasks, repeated tasks at fixed intervals, and cron-style tasks for complex scheduling needs. This flexibility allows developers to tailor task execution according to the specific requirements of each project.

Asynchronous Execution: Built to handle tasks asynchronously, ensuring that the main application flow is not blocked or slowed down by task execution. This is crucial for maintaining a responsive and efficient web application.

Task Retries and Failure Handling: Offers mechanisms to retry failed tasks automatically, with customizable retry policies. This feature helps in managing temporary issues that might cause task failures, such as network downtime or third-party service unavailability.

Scalable and Efficient: Designed to handle a high volume of tasks efficiently, making it suitable for both small projects and large-scale applications with heavy task loads. Its architecture allows for scaling task processing horizontally by adding more worker processes.

Detailed Monitoring and Logging: Provides detailed logs and monitoring capabilities for each task, allowing developers to track task execution, debug issues, and optimize performance. This is crucial for maintaining high reliability and efficiency in production environments.

Customizable Task Execution: Allows developers to define custom tasks with specific logic and parameters. This means that almost any background job can be implemented and managed through Django Tasks Scheduler, from simple data processing tasks to complex workflows.

Install Django Tasks Scheduler

Installing Django Tasks Scheduler in your Django project is straightforward. Follow these steps to integrate it into your project:

Install the Package: First, you need to install Django Tasks Scheduler using pip, Python's package manager. Run the following command in your terminal or command prompt:

pip install django-tasks-scheduler

Add to Installed Apps: After installation, you need to add scheduler to the INSTALLED_APPS list in your Django project's settings file ( This step is crucial for Django to recognize the scheduler as part of your project.


Configure Your Queues: You need to specify your task queues in your Django project's file. This involves defining connection details for one or more Redis queues. Here's how to add a basic Redis queue configuration:

import os

    'default': {
        'HOST': 'localhost',
        'PORT': 6379,
        'DB': 0,
        'USERNAME': 'some-user',
        'PASSWORD': 'some-password',
        'DEFAULT_TIMEOUT': 360,
            'ssl_cert_reqs': None,
    'with-sentinel': {
        'SENTINELS': [('localhost', 26736), ('localhost', 26737)],
        'MASTER_NAME': 'redismaster',
        'DB': 0,
        'USERNAME': 'redis-user',
        'PASSWORD': 'secret',
        'SOCKET_TIMEOUT': 0.3,
            'ssl': True
        'SENTINEL_KWARGS': {
            'username': 'sentinel-user',
            'password': 'secret',
    'high': {
        'URL': os.getenv('REDISTOGO_URL', 'redis://localhost:6379/0'),  # If you're on Heroku
        'DEFAULT_TIMEOUT': 500,
    'low': {
        'HOST': 'localhost',
        'PORT': 6379,
        'DB': 0,

Configure Default Values for Queuing Jobs from Code (Optional): You may also want to set default configurations for how jobs are queued from your code. Add these settings to

    'DEFAULT_TIMEOUT': 300,  # 5 minutes
    'SCHEDULER_INTERVAL': 10,  # 10 seconds

Integrate Scheduler URLs: For convenient management and monitoring of tasks through a web interface, add the Django Tasks Scheduler's URLs to your project's

from django.urls import path, include

urlpatterns = [
    # ...
    path('scheduler/', include('scheduler.urls')),

Migrate the Database: Django Tasks Scheduler uses models to store information about tasks, so you'll need to create the necessary database tables. Run the following commands to migrate your database:

python migrate

Excited to dive deeper into the world of Python programming? Look no further than my latest ebook, "Python Tricks - A Collection of Tips and Techniques".

Get the eBook

Inside, you'll discover a plethora of Python secrets that will guide you through a journey of learning how to write cleaner, faster, and more Pythonic code. Whether it's mastering data structures, understanding the nuances of object-oriented programming, or uncovering Python's hidden features, this ebook has something for everyone.

Using Django Tasks Scheduler

Using Django Tasks Scheduler involves a few straightforward steps to enqueue jobs from your code, schedule jobs through the Django admin, and manage worker processes.

Here's how to make the most of its capabilities:

Enqueue Jobs From Code

To enqueue jobs programmatically, define your tasks as functions and decorate them with @job from the scheduler module. Here's how:

Configure Default Values:

RQ = {

Passing Additional RQ's Job Decorator Arguments:

from scheduler import job

@job('default', timeout=3600)
def long_running_func():

long_running_func.delay()  # Enqueues function with a timeout of 3600 seconds

Specifying a Queue:

def long_running_func():

long_running_func.delay()  # Enqueues function in "high" queue

Basic Job Enqueueing:

from scheduler import job

def long_running_func():

long_running_func.delay()  # Enqueues function in "default" queue

Scheduling a Job Through Django Admin

  1. Navigate to the Django Admin site (e.g., http://localhost:8000/admin/) and find the Tasks Scheduler section.
  2. Click on the "Add" link for the type of job you want to add (Scheduled Task, Repeatable Task, or Cron Task).
  3. Fill in the required fields, including:
    • Name: Enter a unique name for the job.
    • Callable: Enter a Python dot notation path to the method that defines the job (e.g.,
    • Queue: Choose your queue from those defined in your under SCHEDULER_QUEUES.
    • Scheduled Time: Enter the UTC time when the job is to be executed.
  4. Optional fields allow you to set priorities, timeouts, and the result TTL (Time to Live).

Enqueue Jobs Through the Command Line

You can also queue jobs from the command line using the Django management command:

python run_job -q {queue} -t {timeout} -r {result_ttl} {callable} {args}

Running a Worker

Running a worker to execute queued jobs:

python rqworker [queues ...]


Django Tasks Scheduler presents a robust and versatile solution for managing asynchronous tasks within Django applications.

By leveraging features like Django admin integration, Redis-backed queues, and detailed job configuration options, developers can significantly enhance the scalability and performance of their applications.

From simple one-off tasks to complex cron-based scheduling, the flexibility and power of Django Tasks Scheduler cater to a wide range of use cases.

Whether you're building a small project or a large-scale enterprise application, incorporating Django Tasks Scheduler can lead to more organized, efficient, and reliable task management.

Thank you for reading and I will see you on the Internet.

This post is public so feel free to share it.

If you like my free articles and would want to support my work, consider buying me a coffee:

Are you working on a project that’s encountering obstacles, or are you envisioning the next groundbreaking web application?

If Python, Django, and AI are the tools you're exploring but you need more in-depth knowledge, you're in the right place!

Get in touch for a 1-hour consultation where I can address your specific challenges.

Developer Service Blog - 1 Hour Consulting - Nuno Bispo
Are you working on a project that’s hitting roadblocks or simply dreaming up the next big web application?

Tagged in: