Pages in Reference

noust cron

Run commands on a schedule, as systemd timers.

Reference Updated 29 October 2026 View as Markdown

Shell

noust cron [OPTIONS] COMMAND [ARGS]...

noust cron create

Create a cron job as a systemd timer, or rewrite one Noust already owns.

Shell

noust cron create [OPTIONS] NAME COMMAND

Arguments: name, command

Option	What it does	Default
`--schedule`	hourly, daily, weekly, monthly, or a systemd OnCalendar expression.	`daily`
`--user`	Unix user to run as. The configured service_user by default.
`--working-directory`	Absolute directory to run the command in.
`--app`	Associate the job with a deployed application; its runtime directory (current/ for a releases application) becomes the default.
`--timeout`	Stop the command after this many seconds (1 to 86400); the run counts as failed.
`--service`	Run the command in this service of the --app application's Compose stack (docker compose exec) instead of on this server.
`--reason`	Why this change is made (a change reference, a ticket). Recorded with the command in the audit log; required only where a compliance framework asks for it (ENS) or security.change_reasons is on.

Remove a cron job's timer and service units.

Shell

noust cron delete [OPTIONS] NAME

Arguments: name

Option	What it does	Default
`-f`, `-y`, `--force`	Do not ask for confirmation.
`--reason`	Why this change is made (a change reference, a ticket). Recorded with the command in the audit log; required only where a compliance framework asks for it (ENS) or security.change_reasons is on.

Disable a job's timer, keeping the unit files.

Shell

noust cron disable [OPTIONS] NAME

Arguments: name

Option	What it does	Default
`--reason`	Why this change is made (a change reference, a ticket). Recorded with the command in the audit log; required only where a compliance framework asks for it (ENS) or security.change_reasons is on.

Enable a job's timer and start it now.

Shell

noust cron enable [OPTIONS] NAME

Arguments: name

Option	What it does	Default
`--reason`	Why this change is made (a change reference, a ticket). Recorded with the command in the audit log; required only where a compliance framework asks for it (ENS) or security.change_reasons is on.

Show which occurrences of a job ran, were late or never ran.

Shell

noust cron ledger [OPTIONS] NAME

Arguments: name

Option	What it does	Default
`--days`	How far back to look.	`7`
`--json`	Print the ledger as JSON.
`--reason`	Why this change is made (a change reference, a ticket). Recorded with the command in the audit log; required only where a compliance framework asks for it (ENS) or security.change_reasons is on.

List every Noust cron job with its schedule and last result.

Shell

noust cron list [OPTIONS]

Option	What it does	Default
`--json`	Print the jobs as JSON.
`--reason`	Why this change is made (a change reference, a ticket). Recorded with the command in the audit log; required only where a compliance framework asks for it (ENS) or security.change_reasons is on.

Start a job's service immediately, outside its schedule.

Shell

noust cron run [OPTIONS] NAME

Arguments: name

Option	What it does	Default
`--reason`	Why this change is made (a change reference, a ticket). Recorded with the command in the audit log; required only where a compliance framework asks for it (ENS) or security.change_reasons is on.

Show a job's recent executions, reconstructed from the journal.

Shell

noust cron runs [OPTIONS] NAME

Arguments: name

Option	What it does	Default
`--limit`	Most runs to show.	`10`
`--json`	Print the runs as JSON.
`--reason`	Why this change is made (a change reference, a ticket). Recorded with the command in the audit log; required only where a compliance framework asks for it (ENS) or security.change_reasons is on.

Something on this page is wrong or unclear? Report it on GitHub.

Help, contributing and the project’s policies are under Project.