Skip to content
bunqueue

Cron Jobs

Schedule jobs to run on a recurring basis using cron expressions or intervals.

Server Mode

Terminal window
# Add a cron job
bunqueue cron add daily-report \
  -q reports \
  -d '{"type":"daily"}' \
  -s "0 9 * * *"


# List cron jobs
bunqueue cron list


# Delete
bunqueue cron delete daily-report

Cron Expressions

┌───────────── minute (0-59)
│ ┌───────────── hour (0-23)
│ │ ┌───────────── day of month (1-31)
│ │ │ ┌───────────── month (1-12)
│ │ │ │ ┌───────────── day of week (0-6, Sun=0)
│ │ │ │ │
* * * * *

Examples:

  • 0 9 * * * - Every day at 9:00 AM
  • */15 * * * * - Every 15 minutes
  • 0 0 * * MON - Every Monday at midnight
  • 0 0 1 * * - First day of every month

Timezone Support

bunqueue supports IANA timezones for cron jobs (added in v1.9.4). This allows you to schedule jobs based on specific local times rather than the server’s timezone.

Common timezone examples:

  • Europe/Rome
  • America/New_York
  • Asia/Tokyo
  • UTC
// Schedule job at 9 AM Rome time every day
await queue.add('daily-report', { type: 'sales' }, {
  repeat: {
    pattern: '0 9 * * *',
    tz: 'Europe/Rome'
  }
});


// Schedule job at 6 PM New York time on weekdays
await queue.add('end-of-day', { type: 'summary' }, {
  repeat: {
    pattern: '0 18 * * 1-5',
    tz: 'America/New_York'
  }
});

When a timezone is specified, the cron expression is evaluated in that timezone, automatically handling daylight saving time transitions.

Interval-Based

Terminal window
# Every 5 minutes
bunqueue cron add heartbeat \
  -q system \
  -d '{"check":"health"}' \
  -e 300000

Embedded Mode (Repeatable Jobs)

await queue.add('report', { type: 'daily' }, {
  repeat: {
    pattern: '0 9 * * *',
  }
});


// Or interval-based
await queue.add('heartbeat', {}, {
  repeat: {
    every: 60000,  // Every minute
    limit: 100,    // Max 100 executions
  }
});