Schedules
Automate recurring actions — backups and restarts — with cron-based schedules on agentstead.dev.
Schedules let you automate recurring actions on an agent — like taking a daily backup or restarting every week — without manual intervention.
What schedules can do
| Action | What it does |
|---|---|
backup | Creates a full workspace backup at the scheduled time |
restart | Restarts the agent at the scheduled time |
Creating a schedule
Open your agent's Schedules tab
From the agent detail panel, click the Schedules tab.
Click Add Schedule
Fill in the schedule fields:
| Field | Description |
|---|---|
| Name | A label for the schedule, e.g. Daily backup |
| Action | backup or restart |
| Cron expression | When to run (see cron format below) |
| Enabled | Toggle on to activate immediately |
Save
The schedule is stored and will fire at the next matching cron time (UTC).
Cron format
Schedules use standard 5-field cron expressions in UTC:
┌──────── minute (0-59)
│ ┌────── hour (0-23)
│ │ ┌──── day of month (1-31)
│ │ │ ┌── month (1-12)
│ │ │ │ ┌ day of week (0-7, 0=Sunday)
│ │ │ │ │
* * * * *Common examples:
| Expression | Runs |
|---|---|
0 2 * * * | Every day at 02:00 UTC |
0 2 * * 0 | Every Sunday at 02:00 UTC |
0 */6 * * * | Every 6 hours |
0 3 1 * * | First of every month at 03:00 UTC |
30 1 * * 1-5 | Weekdays at 01:30 UTC |
All schedule times are UTC. If you're in BST (UTC+1), a 0 2 * * * schedule fires at 03:00 local time.
Editing a schedule
Open the agent's Schedules tab, click the schedule, and edit any field. You can also toggle a schedule on or off without deleting it.
Deleting a schedule
Click the delete icon next to the schedule. The next scheduled run is cancelled immediately.
Backup quota
Scheduled backups count against your backup storage quota the same as manual backups. If your quota is full when a scheduled backup fires, it will fail.
Check your quota on the Backups page and add storage if needed. See Data & Backups for quota tiers.
Failed scheduled backups are visible in the agent's Logs tab.