ɳSelfɳSELFDOCS
  • Getting Started

    • Introduction
    • Quick Start
    • Installation
    • Your First Project
  • Core Concepts

    • Architecture Overview
    • Project Structure
    • Configuration
    • Environments
  • Services

    • PostgreSQL Database
    • Hasura GraphQL
    • Authentication
    • Real-Time Communication
    • Storage (MinIO)
    • Email Configuration
    • Redis Cache
    • Search Engines
    • Functions
    • MLflow (ML Tracking)
    • Monitoring & Metrics
    • Admin UI
    • Dashboard
  • Database Tools

    • Schema Management
    • Migrations
    • Seeding Data
    • Backup & Restore
    • dbdiagram.io Sync
  • Microservices

    • NestJS Services
    • BullMQ Workers
    • Go Services
    • Python Services
  • CLI Reference

    • All Commands
    • Core Commands
    • Database Commands
    • Service Management
    • Production Commands
  • Deployment

    • Local Development
    • Production Setup
    • SSL/TLS Configuration
    • Domain Configuration
    • Environment Variables
  • Advanced Topics

    • Multi-Tenancy & SaaS
    • Security & Hardening
    • Custom Actions
    • Webhooks
    • Performance Tuning
    • Troubleshooting
  • ɳClaw

    • Backend Manager
    • API Gateway
    • Voice Input
    • Threads & Projects
  • Migration Guides

    • From Supabase
    • From Nhost
    • From Firebase
  • Plugins

    • Plugin catalog (87)
    • Installation
    • Free plugins (25)
    • Pro plugins (62)
  • Reference

    • Stack & Hosting
    • API Reference
    • Guides
    • RFCs
    • Legal
    • Contributing
  • Resources

    • Changelog
    • Licensing
    • FAQ
    • Support

CLI Reference

Complete reference for every nself top-level command.

Auto-generated from SPORT F02-COMMAND-INVENTORY and cli/.github/wiki/cmd-*.md on 2026-04-18. Counts: 47 top-level commands, 25 with wiki, 22 wiki-missing.


nself admin

> Open the nSelf Admin UI in your browser.

Subcommands: connect <host>, projects (subgroup: list, add, remove <id>)

nself build

> Generate `docker-compose.yml`, nginx configs, and SSL certificates from `.env`.

nself clean

> Remove Docker resources associated with the current nSelf project.

nself completion

> Generate shell completion scripts.

Subcommands: (positional: bash|zsh|fish|powershell)

nself config

> View and manage project configuration.

Subcommands: show, get <key>, set <key> <value>, list, validate, export, import <file>

nself db

> Database operations: migrations, backups, restore, seed, and shell.

Subcommands: migrate (subgroup: up, down, status, create <name>, verify-checksums, reset-checksum <id>), seed (subgroup: run, list, verify, graph), backup [file], restore <file>, shell, drop, reset, list, hasura (subgroup: console, metadata → apply, export, reload, diff, validate, lint)

nself doctor

> Run full system diagnostics.

Subcommands: (single command, ~14 internal checks; AI report opt-in via doctor_ai)

nself exec

> Execute a command inside a running service container.

Subcommands: (positional: <SERVICE> [COMMAND...])

nself health

> Health check management with continuous monitoring.

Subcommands: check, service <name>, endpoint <url>, watch, history, config

nself init

> Initialize a new nSelf project with an interactive configuration wizard.

nself license

> Manage your nSelf Pro membership license key.

Subcommands: set <key>, add <key> [key...], remove <key-or-product>, status, list, show, validate, clear, upgrade, refresh, export, import <file>, migrate, simulate-offline <days>

nself logs

> View and filter service logs with color and formatting.

Subcommands: (single command, accepts [SERVICE])

nself migrate

> Detect and migrate nSelf v0.x artifacts to v1.0.0.

Subcommands: detect, run, rollback

nself plugin

> Install, remove, update, and manage nSelf plugins.

Subcommands: list, install <name>, remove <name>, update [name], updates, refresh, start <name>, stop <name>, disable <name>, enable <name>, status [name], inventory, info <name>, new <name>, submit [path]

nself reset

> Stop containers and remove generated configuration files.

nself restart

> Smart restart with config change detection.

Subcommands: (single command, [SERVICES...])

nself security

Security audit, setup, and status commands for hardening your nSelf deployment.

Subcommands: audit, status, setup

nself service

> Enable, disable, and list optional nSelf services.

Subcommands: list, enable <name>, disable <name>

nself ssl

> Manage SSL certificates for nSelf services and custom domains.

Subcommands: status, renew [domain], setup, add <domain>

nself start

> Boot the nSelf stack with health checks and automatic database initialization.

nself status

> Show health status of all services.

Subcommands: (single command, [SERVICE])

nself stop

> Gracefully shut down all services or specific named services.

Subcommands: (single command, [SERVICES...])

nself update

> Update the nSelf CLI binary and admin UI.

Subcommands: images

nself urls

> Display all service URLs with route conflict detection.

nself version

> Show version and system information.

nself ai

> Manage the nSelf AI plugin and local LLM stack.

Subcommands: local, install, models (subgroup: list, add <model>, remove <model>, recommend), health, swap <model>, benchmark [model], chat <message>, pool (subgroup: init, status, provision, add, remove, rotate, test, daily-reset)

nself alerts

> Manage Prometheus alert rules and silences.

Subcommands: list, silence <alert-name>, test <alert-name>

nself backup

> Backup operations: create, list, restore, verify, prune, config, status, init-key.

Subcommands: create, list, restore <backup-id|latest>, verify <backup-id|latest>, prune, config, status, init-key

nself billing

> Billing operations: usage, invoice-preview, report, retry-event.

Subcommands: usage <tenant-id>, invoice-preview <tenant-id>, report, retry-event <id>

nself claw

> Manage nClaw AI assistant.

Subcommands: pair, unlock, chat, config (subgroup: set <key> <value>), keys (subgroup: create, revoke <id>), mcp, memories (subgroup: search <query>), topics (subgroup: search <query>), status, prompt [question], proxy [port], export

nself dev

> Start development environment.

nself dns-setup

> Add project domains to /etc/hosts (run with sudo).

nself dogfood

> Production dogfood audit and reporting.

Subcommands: audit, report

nself down

> Alias for `nself stop`. Shuts down the nSelf stack.

Subcommands: (hidden alias for nself stop)

nself dr

> Disaster recovery operations: drill, promote-standby, reconfigure-dns, rollback, fence.

Subcommands: drill, promote-standby, reconfigure-dns, rollback, fence

nself env

> Multi-environment management: switch, list, diff, copy.

Subcommands: use <env>, list, show, diff <env-a> <env-b>, copy <from> <to>

nself monitor

> Monitoring stack management.

Subcommands: upgrade-dashboards

nself promote

> Promote one environment to another (e.g. staging to prod).

Subcommands: (positional: <source> <target>), rollback

nself queue

> Manage async job queues (pg-boss).

Subcommands: list, jobs <queue>, retry <job-id>, purge <queue>, cron (subgroup: list)

nself secrets

> Manage encrypted project secrets (age encryption).

Subcommands: init, set <KEY> [VALUE], get <KEY>, list, edit, rotate <KEY>, retire <KEY>, schedule, decrypt-on-deploy, audit, lint, rekey --remove <pubkey>

nself tenant

> Tenant management: create, upgrade, suspend, destroy, audit.

Subcommands: create <slug>, upgrade <slug>, suspend <slug>, destroy <slug>, audit <tenant-id>

nself trust

> Set up local dev trust (DNS, SSL, port forwarding).

nself up

> Alias for `nself start`. Boots the nSelf stack.

Subcommands: (hidden alias for nself start)

nself upgrade

> Upgrade the nSelf CLI (detects install method).

nself waf

> Manage the Web Application Firewall (Coraza + OWASP CRS).

Subcommands: enable, mode <detection|blocking>, report

nself watchdog

> Self-healing container watchdog with circuit breaker.

Subcommands: status, reset-breakers, history, test-alert

nself webhooks

> Manage webhook processing and outbox.

Subcommands: outbox, status