cmd admin

nself admin

Manage the ɳSelf Admin UI: open, start, stop, inspect logs, or health-check.

Synopsis

nself admin [subcommand] [flags]

Description

nself admin manages the local ɳSelf Admin dashboard at http://localhost:3021. With no subcommand, it opens the dashboard in your default browser. Use subcommands to control the Admin container lifecycle directly.

The Admin UI is a local-only web interface (Docker container) on your machine. It is not a hosted service.

Admin is a builtin plugin family. Use nself remove admin to disable its command and nself add admin to enable it again.

stop

logs

In v1.5, remote admin connections capture host keys through SSH, honouring ssh_config aliases, jump hosts and an explicit port. Unknown keys fail with E487. Verify the displayed fingerprint independently, then add the verified public key to your ~/.ssh/known_hosts under the effective hostname (or HostKeyAlias), using [hostname]:port for a non-default port. E487 prints the exact lookup name. This trust path works for IP addresses and needs no nSelf environment or deploy target. Scanning alone never enrolls a key.

Flags

Name	Shorthand	Type	Default	Env	Escalates to	JSON override	Description
--help	-h	bool	false				Show help

Subcommands

Name	Description
connect	Connect to a remote ɳSelf Admin via SSH tunnel
health	Check Admin service liveness
logs	Tail Admin container logs
projects	Manage multi-project admin configuration
serve	Serve the authenticated ɳSelf HTTP API
start	Start the Admin service
stop	Stop the Admin container

Contract

• Side effect: read
• Output: document
• JSON: envelope (data schema)
• Exit codes: none declared

Examples

# Open the Admin UI in your browser
nself admin

# Start the Admin service (idempotent)
nself admin start

# Stop the Admin container
nself admin stop

# Force-stop immediately
nself admin stop --force

# Tail the last 50 log lines
nself admin logs --tail 50

# Stream logs continuously
nself admin logs --follow

# Check Admin health
nself admin health

See Also

• Commands — full command index
• Core-Services — what a stack is made of

← Commands | Home →