GitPedia

Adonis scheduler

This library provides an easy way to schedule recurring tasks for AdonisJS.

From nrempel·Updated April 5, 2026·View on GitHub·

[![NPM Version][npm-image]][npm-url] [![Build Status][travis-image]][travis-url] [![Appveyor][appveyor-image]][appveyor-url] [![Coveralls][coveralls-image]][coveralls-url] The project is written primarily in JavaScript, distributed under the MIT License license, first published in 2016. Key topics include: adonis, adonisjs, cron, task-scheduler.

Adonis Scheduler Provider

NPM Version
Build Status
Appveyor
Coveralls

This library provides an easy way to schedule recurring tasks for AdonisJS v4.

Use branch adonis-v3 for AdonisJS version 3

Install

npm install --save adonis-scheduler

Configure

Register it in start/app.js:

javascript
const providers = [ ... 'adonis-scheduler/providers/SchedulerProvider' ] const aliases = { ... Scheduler: 'Adonis/Addons/Scheduler' }

Register the commands:

javascript
const aceProviders = [ ... 'adonis-scheduler/providers/CommandsProvider' ]

Usage

Starting the scheduler

Starting an instance of the kue listener is easy with the included ace command. Simply run node ace run:scheduler.

The provider looks for jobs in the app/Tasks directory of your AdonisJS project and will automatically register a handler for any tasks that it finds.

Creating your first task

Jobs are easy to create. Run node ace make:task Example. They expose the following properties:

NameRequiredTypeStaticDescription
scheduletruemanytrueThe schedule for which the task should run. More docs.
handletruefunctionfalseA function that is called for this task.

Thanks

Special thanks to the creator(s) of AdonisJS for creating such a great framework.

Contributors

Showing top 3 contributors by commit count.

View all contributors on GitHub →

This article is auto-generated from nrempel/adonis-scheduler via the GitHub API.Last fetched: 6/24/2026