1. Install django_cron (ideally in your virtualenv!) using pip or simply getting a copy of the code and putting it in a directory in your codebase.

  2. Add django_cron to your Django settings INSTALLED_APPS:

        # ...
  3. Run python migrate django_cron

  4. Write a cron class somewhere in your code, that extends the CronJobBase class. This class will look something like this:

    from django_cron import CronJobBase, Schedule
    class MyCronJob(CronJobBase):
        RUN_EVERY_MINS = 120 # every 2 hours
        schedule = Schedule(run_every_mins=RUN_EVERY_MINS)
        code = 'my_app.my_cron_job'    # a unique code
        def do(self):
            pass    # do your thing here
  5. Add a variable called CRON_CLASSES (similar to MIDDLEWARE_CLASSES etc.) thats a list of strings, each being a cron class. Eg.:

        # ...
  6. Now everytime you run the management command python runcrons all the crons will run if required. Depending on the application the management command can be called from the Unix crontab as often as required. Every 5 minutes usually works for most of my applications, for example:

    > crontab -e
    */5 * * * * source /home/ubuntu/.bashrc && source /home/ubuntu/work/your-project/bin/activate && python /home/ubuntu/work/your-project/src/ runcrons > /home/ubuntu/cronjob.log

Management Commands:

  1. run a specific cron with python runcrons cron_class ..., for example:

    # only run "my_app.cron.MyCronJob"
    $ python runcrons "my_app.cron.MyCronJob"
    # run "my_app.cron.MyCronJob" and "my_app.cron.AnotherCronJob"
    $ python runcrons "my_app.cron.MyCronJob" "my_app.cron.AnotherCronJob"
  2. force run your crons with python runcrons --force, for example:

    # run all crons, immediately, regardless of run time
    $ python runcrons --force
  3. run without any messages to the console python runcrons --silent, for example:

    # run crons, if required, without message to console
    $ python runcrons --silent