Skip to content

timer

A systemd timer that runs a command on a schedule.

step "example" {
timer {
command = "..."
name = "..."
on_calendar = "..."
}
}
Name Type Required Description
command string Yes Command to run (ExecStart).
description string No Unit description.
name string Yes Unit name, without .timer or .service.
on_calendar string Yes systemd calendar expression, such as “daily” or “--* 02:30:00”.
on_remove string No “delete” (default) stops the timer and removes its units, “forget” leaves it.
persistent bool No Run a missed job at the next boot.
user string No User the command runs as. Defaults to root.

Conn3x sets these; reference them as conn3x_timer.<circuit>__<step>["<host>"].<name>.

Name Type Description
in_sync bool Whether the units match and the timer is enabled and running.

A step lowers to the conn3x_timer resource, one instance per host, and connects with its circuit’s ssh block.