Commands - nself-org/cli GitHub Wiki

Commands

ɳSelf CLI provides 58 documented commands with wiki pages. Each command links to a dedicated page with full usage, flags, and examples.

Lifecycle

Command Description
cmd-init Initialize a new ɳSelf project , generates .env configuration via interactive wizard
cmd-build Compose infrastructure from .env , generates docker-compose.yml, Nginx config, and SSL certificates
cmd-start Boot the ɳSelf stack with health checks and automatic database initialization (alias: up)
cmd-stop Gracefully shut down all services or specific named services (alias: down)
cmd-restart Smart restart with config change detection , only restarts affected services
cmd-dev Start development environment with optional plugin hot-reload
cmd-reset Stop containers and remove generated files (preserves .env and data)
cmd-clean Remove Docker resources associated with the current project

Monitoring & Diagnostics

Command Description
cmd-status Show health status of all services with exit code signaling
cmd-logs View and filter service logs with color, search, and tail support
cmd-health Health check management , check, watch, history, single service or endpoint
cmd-doctor Run full system diagnostics: infrastructure, Docker, config, network
cmd-urls Display all service URLs grouped by type with route conflict detection
cmd-monitor Monitoring stack management (Grafana dashboard upgrades)
cmd-alerts Manage Prometheus alert rules and silences
cmd-watchdog Self-healing container watchdog with circuit breaker
cmd-dogfood Production dogfood audit and reporting

Data

Command Description
cmd-db Database operations , migrate, seed, backup, restore, shell, reset, Hasura metadata
cmd-backup Backup operations: create, list, restore, verify, prune, config, status, init-key
cmd-dr Disaster recovery: drill, promote-standby, reconfigure-dns, rollback, fence
cmd-queue Manage async job queues (pg-boss)
cmd-webhooks Manage webhook processing and outbox

Configuration & Environments

Command Description
cmd-config Manage project configuration , show, get, set, list, validate, export, import
cmd-env Multi-environment management: switch, list, diff, copy
cmd-federation Manage GraphQL Federation for multi-service nSelf deployments
cmd-infra Provision nSelf infrastructure on cloud providers via Terraform
cmd-promote Promote one environment to another (e.g. staging to prod)
cmd-region Manage multi-region Postgres replicas for a self-hosted nSelf deployment
cmd-service Enable, disable, and list optional services (Redis, MinIO, email, search, monitoring)

Networking & SSL

Command Description
cmd-ssl Manage SSL certificates , status and force renewal
cmd-trust Set up local dev trust (DNS, SSL, port forwarding)
cmd-dns-setup Add project domains to /etc/hosts (run with sudo)

Security

Command Description
cmd-encryption Manage BYOK per-tenant encryption for nSelf Cloud (Enterprise tier only)
cmd-secrets Manage encrypted project secrets (age encryption)
cmd-security Security audit, setup, and status for hardening your deployment
cmd-waf Manage the Web Application Firewall (Coraza + OWASP CRS)

Multi-tenancy & Billing

Command Description
cmd-tenant Tenant management: create, upgrade, suspend, destroy, audit
cmd-billing Billing operations: usage, invoice-preview, report, retry-event

Plugins & Licensing

Command Description
cmd-plugin Manage ɳSelf plugins , install, remove, update, list, start, stop, status
cmd-license Manage Pro membership license key , set, show, validate, clear, upgrade

Release

Command Description
cmd-release Orchestrate a full versioned release across all nSelf distribution surfaces
cmd-release-check Run pre-flight validation before a release
cmd-release-rollback Roll back distribution surfaces to a prior release version
cmd-release-status View the live deployment status of all release distribution surfaces

AI & ɳClaw

Command Description
cmd-ai Manage the ɳSelf AI plugin and local LLM stack
cmd-ai-studio Google AI Studio integration for local nSelf instances via a secure Cloudflare Tunnel
cmd-claw Manage ɳClaw AI assistant
cmd-mcp Start the nSelf MCP server and expose infrastructure tools to Claude Code and other MCP clients
cmd-ollama Deprecated alias — use nself model --provider ollama instead

Utilities

Command Description
cmd-admin Open the ɳSelf Admin dashboard in browser at localhost:3021
cmd-completion Generate shell completion scripts for bash, zsh, fish, or PowerShell
cmd-costs Show an itemized breakdown of estimated monthly operational costs for your nSelf install
cmd-exec Execute a command inside a running service container
cmd-feature Manage CLI-built-in feature flags for build-time and install-time capability gates
cmd-help-topics Browse built-in help topics for common nSelf tasks
cmd-k8s Deploy and manage nSelf on any Kubernetes cluster using the official Helm chart
cmd-man Generate man pages for all nself commands
cmd-migrate Detect and migrate v1 (Bash CLI) artifacts to v2
cmd-migrate-from-v099 Migrate v0.9.9 home-level state (license key, update channel, SSH keys) to the v1.x layout
cmd-self-heal Run targeted repair routines for nSelf components without a full stack rebuild
cmd-uninstall Remove nSelf-generated files and containers from the current project directory
cmd-update Update the ɳSelf CLI binary and admin Docker image
cmd-upgrade Upgrade the ɳSelf CLI (detects install method)
cmd-version Show version and system information

Home | _Sidebar

⚠️ **GitHub.com Fallback** ⚠️