Launch the nSelf Admin dashboard — a local-only web UI that runs alongside the CLI at localhost:3021.
# Start the admin UI (opens in your browser automatically)
nself admin start
# Connect to a remote nSelf instance from the admin UI
nself admin connect user@my-server.example.comnself admin <SUBCOMMAND> [FLAGS]The nSelf Admin UI is a Docker-based companion application distributed as nself/nself-admin. It runs locally on port 3021 — it is never deployed to production servers and is not a hosted service. Think of it as a graphical front-end for the same operations the CLI exposes.
Admin is version-locked with the CLI. Both ship the same version number. If your CLI is v1.1.0, your Admin image should be nself/nself-admin:v1.1.0. Running mismatched versions may produce unexpected behavior; use nself update to keep them in sync.
The connect subcommand lets you point the running Admin UI at a remote nSelf instance (staging or production) instead of local. Projects registered via admin connect appear in the Admin project switcher. All write operations still go through the CLI binary, ensuring the nSelf-First Doctrine is respected.
Pull (if needed) and launch the nself/nself-admin Docker image on port 3021. Opens http://localhost:3021 in the default browser.
nself admin start
# Pulling nself/nself-admin:v1.1.0 ...
# Admin UI started at http://localhost:3021Register a remote nSelf host with the local Admin UI. After connecting, you can manage that instance from the Admin project switcher without SSH.
nself admin connect root@staging.example.com
nself admin connect root@prod.example.com --label "Production"| Flag | Type | Default | Description |
|---|---|---|---|
--label | string | hostname | Display name for this host in the Admin UI |
--port | int | 22 | SSH port on the remote host |
--key | string | ~/.ssh/id_rsa | Path to the SSH private key |
Manage the list of projects shown in the Admin UI project switcher.
| Sub-action | Description |
|---|---|
projects list | List all registered projects |
projects add <host> | Add a project (alias for admin connect) |
projects remove <label> | Remove a project from the switcher |
nself admin projects list
nself admin projects remove staging| Flag | Type | Default | Description |
|---|---|---|---|
--no-open | bool | false | Do not open the browser after starting |
--port | int | 3021 | Local port for the Admin UI |
--detach | bool | false | Run the Admin container in the background |
nself admin start --no-open
# Then navigate to http://localhost:3021 manuallynself admin connect root@167.235.233.65 --label "Staging"
nself admin connect root@5.75.235.42 --label "Production"
nself admin projects listnself admin start --port 4021NSELF_ADMIN_PORT — default port for the Admin UI (overrides --port)NSELF_ADMIN_IMAGE — override the Docker image tag (default: nself/nself-admin:<cli-version>)0 — success1 — Docker not running or image pull failed2 — invalid arguments