Pages in Reference

noust site

Manage the nginx and apache virtual hosts on this server.

Reference Updated 29 October 2026 View as Markdown

Shell

noust site [OPTIONS] COMMAND [ARGS]...

Subcommands: create, delete, diff, disable, enable, history, list, logs, restore, show, unknown-hosts

noust site create

Create a site and secure it with a certificate.

Shell

noust site create [OPTIONS]

Option	What it does	Default
`--domain`, `-d`	Domain to serve, such as example.com.
`--webserver`, `-w`	Web server to configure.	`nginx`
`--template`, `-t`	Configuration template to render.	`proxy`
`--port`, `-p`	Port the application listens on behind the proxy.	`3000`
`--no-ssl`	Serve plain HTTP and request no certificate.
`--www`	Also serve www. and cover it with the certificate.
`--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 site delete

Delete a site, its configuration and its certificate.

Shell

noust site delete [OPTIONS] DOMAIN

Arguments: domain

Option	What it does	Default
`--force`, `-f`, `-y`	Delete without asking 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.

noust site diff

Show what changed between a version of a site's file and the file now.

Shell

noust site diff [OPTIONS] DOMAIN VERSION

Arguments: domain, version

Option	What it does	Default
`--against`	Compare with this version instead of the file now.
`--webserver`, `-w`	The web 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.

noust site disable

Stop serving a site, keeping its configuration.

Shell

noust site disable [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 site enable

Start serving a site that is configured but off.

Shell

noust site enable [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 site history

List the versions kept of a site's file, newest first, and say if it has drifted.

Shell

noust site history [OPTIONS] DOMAIN

Arguments: domain

Option	What it does	Default
`--webserver`, `-w`	The web server.
`--json`	Print the versions 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 site list

List the sites configured on this server.

Shell

noust site list [OPTIONS]

Option	What it does	Default
`--webserver`, `-w`	Only show sites from this web server.	`all`
`--team`	Only this team's.
`--project`	Only what lives in the projects with this name.
`--env`	Only what lives in the environments with this name.
`--json`	Print the site list 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 site logs

Show the end of what the web server logged for a site.

Shell

noust site logs [OPTIONS] DOMAIN

Arguments: domain

Option	What it does	Default
`--kind`	The web server's access log or its error log.	`access`
`-n`, `--lines`		`100`
`--contains`	Only lines with this text, whatever its case.
`--json`	Print the log 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 site restore

Put an earlier version of a site's file back.

Shell

noust site restore [OPTIONS] DOMAIN VERSION

Arguments: domain, version

Option	What it does	Default
`--reload`	Reload the web server after.
`--webserver`, `-w`	The web 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.

noust site show

Print the configuration file of a site.

Shell

noust site show [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 site unknown-hosts

What answers a request for a name no site serves: nothing, a 503, or a redirect.

Shell

noust site unknown-hosts [OPTIONS] COMMAND [ARGS]...

Subcommands: reset, set, show

noust site unknown-hosts reset

Take the site away: the first site answers an unknown name again.

Shell

noust site unknown-hosts reset [OPTIONS]

Option	What it does	Default
`--webserver`, `-w`	The web server.
`--json`	Print the status now in force 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 site unknown-hosts set

Answer an unknown name with ACTION: close, refuse (503) or redirect.

Shell

noust site unknown-hosts set [OPTIONS] {close|refuse|redirect}

Arguments: action

Option	What it does	Default
`--redirect-to`	Where a redirect goes (http or https).
`--switch-off-default-site`	Switch off the web server's own default site if it is in the way (put back on reset).
`--webserver`, `-w`	The web server.
`--json`	Print the status now in force 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 site unknown-hosts show

Say what answers an unknown name now, and what else claims to be the default.

Shell

noust site unknown-hosts show [OPTIONS]

Option	What it does	Default
`--webserver`, `-w`	The web server.
`--json`	Print the status 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.