Schedules - Humrun Docs

Schedule types

Humrun supports several ways to schedule your scripts:

Interval schedules

Run your script at regular intervals:

Every 15 minutes
Every 30 minutes
Every hour
Every 6 hours
Every 12 hours
Every 24 hours

The interval is measured from the start of the previous run. If a run takes 10 seconds and you have a 15-minute interval, the next run starts 15 minutes after the previous one started.

Daily schedules

Run once per day at a specific time:

Set the hour (0-23)
Set the minute (0-59)
Choose your timezone

Example: Run every day at 9:00 AM Pacific time.

Cron expressions

For more complex schedules, use cron syntax:

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

Examples:

0 9 * * 1-5 - Every weekday at 9:00 AM
*/30 * * * * - Every 30 minutes
0 0 1 * * - First day of every month at midnight
0 8,12,18 * * * - At 8 AM, 12 PM, and 6 PM daily

Timezone

All schedules run in the timezone you specify in your account settings. The default is UTC.

When using interval schedules, timezone doesn't matter much. For daily or cron schedules, make sure your timezone is set correctly.

Minimum interval

The minimum schedule interval is 1 minute.

Pausing schedules

You can pause a script's schedule at any time. While paused:

Scheduled runs don't occur
You can still run the script manually
Run history is preserved

Manual runs

You can always run a script manually using the Run now button. Manual runs:

Don't affect the regular schedule
Count toward your monthly execution limit
Are logged the same as scheduled runs

Missed runs

If Humrun experiences downtime during a scheduled run, the run is skipped. We don't queue up missed runs or try to "catch up."

For most monitoring and reporting use cases, this is the right behavior. If you need guaranteed execution, consider a more robust workflow platform.