Pages in Reference

noust deploy

Follow the deploy queue, cancel a build, and hold, freeze or release deploys.

Reference Updated 29 October 2026 View as Markdown

Shell

noust deploy [OPTIONS] COMMAND [ARGS]...

Subcommands: cancel, freeze, freezes, held, keep, pause, pause-on-rollback, queue, resume, schedule, unfreeze

noust deploy cancel

Cancel a deployment: a job that waits, or the build that runs.

Shell

noust deploy cancel [OPTIONS] TARGET

Arguments: target

Option	What it does	Default
`--all`	With an application: also cancel what waits in the queue for it.
`--wait`	Seconds to wait for the build to stop (0 to ask and return).	`30`
`--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.

noust deploy freeze

Freeze deploys: nothing is deployed, of DOMAIN or of the whole server, for a while.

Shell

noust deploy freeze [OPTIONS] [DOMAIN]

Arguments: domain

Option	What it does	Default
`--reason`, `-m`	Why; whoever tries to deploy is told it.
`--from`	When it starts (2026-12-24T18:00); now when left out.
`--until`	When it ends; none lasts until lifted.
`--hours`	Instead of --until: how long from its start.
`--json`	Print the freeze as JSON.

noust deploy freezes

List the freezes that hold deploys now, or will.

Shell

noust deploy freezes [OPTIONS]

Option	What it does	Default
`--all`	Also the ones that ended or were lifted.
`--json`	Print the freezes 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.

noust deploy held

Say what holds the deploys of an application, if anything: a pause or a freeze.

Shell

noust deploy held [OPTIONS] DOMAIN

Arguments: domain

Option	What it does	Default
`--json`	Print the answer 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.

noust deploy keep

Show or set how many deployments of an application's history are kept.

Shell

noust deploy keep [OPTIONS] DOMAIN [N|default]

Arguments: domain, count

Option	What it does	Default
`--json`	Print the setting 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.

noust deploy pause

Hold what deploys an application by itself: its pushes, its tags and its schedules.

Shell

noust deploy pause [OPTIONS] DOMAIN

Arguments: domain

Option	What it does	Default
`--reason`, `-m`	Why, for whoever meets it ('rolled back to 20261001').
`--json`	Print the settings now in force as JSON.

noust deploy pause-on-rollback

Show or set whether going back pauses what deploys the application by itself.

Shell

noust deploy pause-on-rollback [OPTIONS] DOMAIN [on|off]

Arguments: domain, choice

Option	What it does	Default
`--json`	Print the setting 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.

noust deploy queue

Show what is deploying and what is waiting to.

Shell

noust deploy queue [OPTIONS] [DOMAIN]

Arguments: domain

Option	What it does	Default
`--json`	Print the queue 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.

noust deploy resume

Let an application's pushes, tags and schedules deploy it again.

Shell

noust deploy resume [OPTIONS] DOMAIN

Arguments: domain

Option	What it does	Default
`--json`	Print what resuming did 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.

noust deploy schedule

Update an application by itself, on a schedule.

Shell

noust deploy schedule [OPTIONS] COMMAND [ARGS]...

Subcommands: list, remove, run, set, show

noust deploy schedule list

List the applications that update themselves.

Shell

noust deploy schedule list [OPTIONS]

Option	What it does	Default
`--json`	Print the schedules 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.

noust deploy schedule remove

Stop an application updating itself: the timer and the schedule go.

Shell

noust deploy schedule remove [OPTIONS] DOMAIN

Arguments: domain

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.

noust deploy schedule run

Run an application's scheduled update now, once, exactly as its timer does.

Shell

noust deploy schedule run [OPTIONS] DOMAIN

Arguments: domain

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.

noust deploy schedule set

Make an application update itself at a time, with a backup first.

Shell

noust deploy schedule set [OPTIONS] DOMAIN

Arguments: domain

Option	What it does	Default
`--at`	daily, weekly or monthly (at 03:00, Sunday for a week), or a systemd calendar expression such as 'Sun --* 03:00' or '--* 04:30'.
`--backup`, `--no-backup`	Refuse the update when the backup before it does not happen.
`--only-if-new`, `--always`	Do nothing when the branch (or the tags it follows) has nothing new.
`--off`	Keep the schedule and stop its timer.
`--json`	Print the schedule 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.

noust deploy schedule show

Show when an application updates itself, and how its last run ended.

Shell

noust deploy schedule show [OPTIONS] DOMAIN

Arguments: domain

Option	What it does	Default
`--json`	Print the schedule 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.

noust deploy unfreeze

Lift the freeze of an application, or of the whole server without DOMAIN.

Shell

noust deploy unfreeze [OPTIONS] [DOMAIN]

Arguments: domain

Option	What it does	Default
`--id`	Lift this freeze, by its number.
`--json`	Print the freezes that were lifted 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.