The nself cloud command group manages ɳSelf Cloud instances from your local terminal. Provision servers, switch contexts, install plugins, manage backups, and monitor hosted stacks without touching the web dashboard.
nself command works on Cloud instancesAuthenticate with ɳSelf Cloud. Opens a browser OAuth flow or accepts an API token.
nself cloud login
# Options:
# --token <token> Use a static API token instead of OAuth
# Examples
nself cloud login # Browser OAuth (default)
nself cloud login --token nsc_xxxxx... # Token auth (useful in CI)Show current authenticated Cloud account details.
nself cloud whoami
# Output:
# Authenticated as: user@example.com
# Plan: Business
# Instances: 2
# Renewal: 2026-06-01Remove cached Cloud credentials.
nself cloud logoutList all Cloud instances in your account.
nself cloud list
# Output:
# NAME PLAN REGION STATUS DOMAIN
# myapp Pro fsn1 running myapp.cloud.nself.org
# staging Starter hel1 running staging.cloud.nself.orgProvision a new Cloud instance. Provisioning takes 5–8 minutes.
nself cloud create <name> [options]
# Options:
# --plan <plan> starter, pro, business, max
# --region <region> fsn1 (Falkenstein DE), hel1 (Helsinki FI), ash1 (Ashburn VA), sin1 (Singapore)
# --domain <domain> Custom domain (optional; defaults to <name>.cloud.nself.org)
# --plugins <list> Comma-separated plugin names to install at provision time
# Examples
nself cloud create myapp --plan pro --region fsn1
nself cloud create prod --plan business --region fsn1 --plugins ai,mux,claw
nself cloud create dev --plan starter --region hel1 --domain dev.mycompany.comDestroy a Cloud instance. This is irreversible after the confirmation step.
nself cloud delete <name> [options]
# Options:
# --force Skip confirmation prompt
# Example
nself cloud delete staging --forceSwitch the active Cloud context. After this command, all nself commands run against the specified instance until you switch again.
nself cloud use <name>
# Example
nself cloud use prod
# Confirm active context
nself cloud contextRun a single nself command on a Cloud instance without switching context.
nself cloud exec <name> -- <command>
# Examples
nself cloud exec prod -- nself status
nself cloud exec prod -- nself logs hasura --tail 100
nself cloud exec prod -- nself db backup
nself cloud exec staging -- nself plugin listOpen an SSH session into the VPS. For diagnostics only — do not run docker commands directly.
nself cloud ssh <name>
# Example
nself cloud ssh prodShow the health of a Cloud instance (services, disk, RAM, CPU).
nself cloud status [name]
# Output:
# Instance: prod (Business, Hetzner CX31)
# Region: fsn1 (Falkenstein DE)
# Uptime: 14d 3h 22m
# CPU: 12%
# RAM: 2.1/8 GB
# Disk: 41/80 GB
#
# Services:
# postgres running
# hasura running
# auth running
# nginx running
# redis runningStream or tail logs from a Cloud instance service.
nself cloud logs <name> [service] [options]
# Options:
# --tail <n> Number of lines (default: 50)
# --follow Follow log stream
# Examples
nself cloud logs prod hasura --follow
nself cloud logs prod postgres --tail 200
nself cloud logs prod nginxRestart all services or a specific service on a Cloud instance.
nself cloud restart <name> [service]
# Examples
nself cloud restart prod # Restart all
nself cloud restart prod hasura # Restart one serviceChange the VPS size. Hetzner supports live resize. Downgrade applies at the next billing cycle; upgrades are immediate.
nself cloud resize <name> --plan <plan>
# Plans:
# starter Hetzner CX11 (1 vCPU, 2 GB RAM, 20 GB SSD)
# pro Hetzner CX21 (2 vCPU, 4 GB RAM, 40 GB SSD)
# business Hetzner CX31 (2 vCPU, 8 GB RAM, 80 GB SSD)
# max Hetzner CX41+ with ɳTV Cloud MAX features
# Example
nself cloud resize prod --plan businessInstall a plugin on a Cloud instance. Triggers a rebuild and rolling restart.
nself cloud plugin install <name> <plugin>
# Examples
nself cloud plugin install prod ai
nself cloud plugin install prod "ai,mux,claw" # Multiple at onceList installed plugins on a Cloud instance.
nself cloud plugin list <name>
# Output:
# PLUGIN VERSION STATUS
# ai 1.3.2 enabled
# mux 1.1.0 enabled
# claw 2.0.1 enabledTrigger an on-demand backup. Nightly backups run automatically; this creates an extra snapshot immediately.
nself cloud backup create <name>
# Example
nself cloud backup create prodList available backups. Backups are retained for 7 days.
nself cloud backup list <name>
# Output:
# ID CREATED SIZE TYPE
# bk-019 2026-05-07 03:00 4.2 GB nightly
# bk-018 2026-05-06 03:00 4.1 GB nightly
# bk-017 2026-05-05 14:32 4.1 GB manualRestore an instance from a backup. The restore runs in-place; the stack goes offline briefly.
nself cloud backup restore <name> --backup <id>
# Example
nself cloud backup restore prod --backup bk-018Add a custom domain to a Cloud instance. Point a CNAME at <name>.cloud.nself.org before running this command. SSL is provisioned automatically via Let's Encrypt.
nself cloud domain add <name> --domain <your-domain>
# Example
nself cloud domain add prod --domain api.mycompany.com
# Before running:
# Set DNS: api.mycompany.com CNAME prod.cloud.nself.orgShow current billing details: plan, renewal date, and last invoice.
nself cloud billing
# Output:
# Plan: Business ($39/mo + infra)
# Renewal: 2026-06-01
# Last invoice: $53.99 on 2026-05-01
# Stripe portal: https://billing.stripe.com/...| Variable | Description | Default |
|---|---|---|
| NSELF_CLOUD_TOKEN | API token for CLI auth (CI use) | — |
| NSELF_CLOUD_INSTANCE | Default instance name for commands | — |
| NSELF_CLOUD_API | Cloud API base URL | https://api.cloud.nself.org |