Skip to main content

​
Cron

Schedule recurring tasks with cron expressions.

​
Configuration

​
Format

6-field cron: second minute hour day month weekday

​
Notes

  • Cron jobs are short-lived (run and exit)
  • restart_policy is ignored for cron units; each run is scheduled, not supervised
  • Overlap detection prevents duplicate runs
  • Cron units are scheduled by the supervisor, not run as persistent services. Unlike services, they cannot be started or restarted directly with sysg start -s <unit> or sysg restart -s <unit> — both return SG0101. To (re)schedule a cron unit, reload or restart its project so the supervisor re-reads the manifest. A project restart does not run the unit immediately.
A cron row marked Failed or Failing means its most recent run failed. The scheduler remains active and will run it again at the next scheduled time. A later successful run replaces that health verdict; use sysg inspect -s <unit> for run history and sysg logs -s <unit> for output.

​
Examples

​
Status