Pages in Reference

noust 2fa

Enrol, confirm, disable or recover two-factor authentication for logins.

Reference Updated 29 October 2026 View as Markdown

Shell

noust 2fa [OPTIONS] COMMAND [ARGS]...

noust 2fa backup-codes

Regenerate the backup codes, invalidating every one issued before.

Shell

noust 2fa backup-codes [OPTIONS]

Option	What it does	Default
`-f`, `--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.

Verify CODE against the pending secret and activate the second factor.

Shell

noust 2fa confirm [OPTIONS] CODE

Arguments: code

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.

Turn the second factor off, on presentation of a current CODE or an unused backup code.

Shell

noust 2fa disable [OPTIONS] CODE

Arguments: code

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.

Begin enrolment: generate a pending secret. Nothing is enforced until 'noust 2fa confirm CODE' verifies it.

Shell

noust 2fa enroll [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.

Report the two-factor state, without exposing any secret.

Shell

noust 2fa status [OPTIONS]

Option	What it does	Default
`--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.