Skip to content
APScheduler for Django
Branch: master
Clone or download
Type Name Latest commit message Commit time
Failed to load latest commit information.
django_apscheduler Change parameter name. Apr 3, 2019
examples/example_apscheduler Fixed #20 Apr 28, 2018
tests Add model manager for deleting old job executions. Apr 3, 2019
.gitignore Some fixes Nov 5, 2017
.travis.yml Update travis dist to xenial. Apr 3, 2019 Add model manager for deleting old job executions. Apr 3, 2019
requirements.txt Pin requirement Jul 11, 2016
requirements_dev.txt Add model manager for deleting old job executions. Apr 3, 2019
setup.cfg Actually, bump minor version. Apr 3, 2019

Django APScheduler


If anyone feels up to helping maintain this package, please PM me and we can get you some privileges.

Build status codecov PyPI version

APScheduler for Django.

This little wrapper around APScheduler enables storing persistent jobs in the database using Django's ORM rather than requiring SQLAlchemy or some other bloatware.

Features in this project:

  • Work on both python2.* and python3+
  • Manage jobs from Django admin interface
  • Monitor your job execution status: duration, exception, traceback, input parameters.


pip install django-apscheduler


  • Add django_apscheduler to INSTALLED_APPS in your Django project settings, You can also specify a different format for displaying runtime timestamps in the Django admin site using APSCHEDULER_DATETIME_FORMAT:

    APSCHEDULER_DATETIME_FORMAT =  "N j, Y, f:s a"  # Default
  • Run migrations:

    ./ migrate
  • Instantiate a new scheduler as you would with APScheduler. For example:

    from apscheduler.schedulers.background import BackgroundScheduler
    scheduler = BackgroundScheduler()
  • Instruct the scheduler to use DjangoJobStore:

    from django_apscheduler.jobstores import DjangoJobStore
    # If you want all scheduled jobs to use this store by default,
    # use the name 'default' instead of 'djangojobstore'.
    scheduler.add_jobstore(DjangoJobStore(), 'djangojobstore')
  • If you want per-execution monitoring, call register_events on your scheduler:

      from django_apscheduler.jobstores import register_events

    It provides the following interface:

  • Old job executions can be deleted with:

  DjangoJobExecution.objects.delete_old_job_executions(604_800)  # Delete job executions older than 7 days
  • Register any jobs as you would normally. Note that if you haven't set DjangoJobStore as the 'default' job store, you'll need to include jobstore='djangojobstore' in your scheduler.add_job calls.

  • Don't forget to give each job a unique id. For example:

    @scheduler.scheduled_job("interval", seconds=60, id="job")
    def job():

    or use custom decorator for job registration. It will give id automatically:

    from django_apscheduler.jobstores import register_job
    @register_job("interval", seconds=60)
    def job():
  • Start the scheduler:


A full example project can be found in the example dir. Code snippet:

import time

from apscheduler.schedulers.background import BackgroundScheduler
from django_apscheduler.jobstores import DjangoJobStore, register_events, register_job

scheduler = BackgroundScheduler()
scheduler.add_jobstore(DjangoJobStore(), "default")

@register_job(scheduler, "interval", seconds=1)
def test_job():
    print("I'm a test job!")
    # raise ValueError("Olala!")


print("Scheduler started!")
You can’t perform that action at this time.