Pages in Reference

noust context

Save and choose the servers this machine operates through their API.

Reference Updated 29 October 2026 View as Markdown

Shell

noust context [OPTIONS] COMMAND [ARGS]...

noust context add

Save a server.

Shell

noust context add [OPTIONS] NAME

Arguments: name

Option	What it does	Default
`--url`	The server's address, such as https://noust.example.com.
`--token`	Keep the token in a private file of its own, read from standard input (-), a file (@FILE) or a variable (env:NAME). Never the token itself.
`--token-file`	A private file that already holds the token.
`--token-env`	A variable that holds the token.
`--ca-file`	Trust this certificate authority.
`--use`	Also make it the server commands run on.
`--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.

Print the server commands run on, or say they run here.

Shell

noust context current [OPTIONS]

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.

List the saved servers, marking the one in use.

Shell

noust context list [OPTIONS]

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

Forget a saved server, and the token file this tool kept for it.

Shell

noust context remove [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.

Run commands on this server from now on.

Shell

noust context use [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.

Check that a saved server answers and the token is accepted.

Shell

noust context verify [OPTIONS] [NAME]

Arguments: name

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.

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

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