How-to: manage schedules

Canonfig uses the operating system's user scheduler (systemd user timer on Linux, launchd user agent on macOS, and Task Scheduler on Windows). There is no resident Follower Machine daemon. Every native job invokes:

canonfig sync --apply --no-input

Set the default schedule

The default schedule is daily at 00:00 in the follower's local timezone. Install it explicitly:

canonfig schedule set daily@00:00

Configure specific times and timezones

Set a daily schedule in a named IANA timezone:

canonfig schedule set daily@00:00 --timezone Europe/Paris

Set a weekly schedule on a specific day:

canonfig schedule set weekly:Mon@12:30 --timezone Europe/Paris

The CLI accepts weekday abbreviations Mon, Tue, Wed, Thu, Fri, Sat, and Sun, with a 24-hour HH:mm time.

If scheduler execution needs an explicit Canonfig path, pass the executable location:

canonfig schedule set daily@00:00 --executable /opt/canonfig

Inspect or remove schedules

Check the status of the native schedule:

canonfig schedule status

Status is one of not-installed, current, drifted, or disabled.

Remove a schedule completely:

canonfig schedule remove

Setting the same schedule is idempotent. Removing a schedule that is already absent is also an unchanged result.