ɳ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

    • Complete Command Reference
    • 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
  • Migration Guides

    • From Supabase
    • From Nhost
    • From Firebase
  • Resources

    • Changelog
    • Licensing
    • FAQ
    • Contributing
    • Support

Complete CLI Commands Reference

ɳSelf v0.9.8

Complete reference for all 31 top-level ɳSelf CLI commands with 295+ subcommands. After v0.9.6's command consolidation, ɳSelf now features a clean, hierarchical command structure organized by domain.

What's New in v0.9.6 - Command Consolidation

  • • 79 → 31 Commands: 60.8% reduction in top-level commands
  • • 295+ Subcommands: Organized into logical hierarchies
  • • 100% Backward Compatible: All old commands work with warnings
  • • Improved Discoverability: Commands grouped by domain

Command Categories Overview

CategoryCommandsDescriptionVersion
Core5init, build, start, stop, restartv0.1.0+
Utilities15status, logs, help, admin, urls, exec, doctor, monitor, health, version, update, completion, metrics, history, auditv0.1.0+
Database14migrate, schema, seed, mock, backup, restore, shell, query, types, inspect, optimize, vacuum, reindex, pgbenchv0.3.9+
Multi-Tenancy60+Tenant management, billing, branding, custom domains, compliance (GDPR/HIPAA/SOC2)v0.9.0+
Authentication38OAuth (13 providers), MFA, roles, devices, webhooks, securityv0.9.0+
Service Management43email, search, storage, cache, functions, mlflow, admin-devv0.4.2+
Deployment23staging, production, preview, canary, blue-green, server, syncv0.4.3+
Infrastructure38provider (26+ clouds), k8s, helm, server managementv0.4.5+
Configuration20env, secrets, vault managementv0.4.3+
Performance5profiling, benchmarking, scaling, optimizationv0.4.6+
Backup & Recovery6backup, restore, snapshots, schedulingv0.3.8+
Developer Tools16scaffolding, templates, CI/CD generationv0.4.2+
Plugins8Stripe, GitHub, Shopify integrationsv0.4.8+

⚠️ Command Consolidation (v0.9.6)

Many top-level commands have been reorganized as subcommands. Old commands still work but show deprecation warnings:

  • • ɳSelf billing → nself tenant billing
  • • nself cloud → nself provider (renamed)
  • • ɳSelf oauth → nself auth oauth
  • • ɳSelf mfa → nself auth mfa
  • • nself storage → nself service storage
  • • nself email → nself service email

All deprecated commands will be removed in v1.0 (estimated Q2 2026).

Core Commands (5)

Essential project lifecycle operations:

  • nself init - Initialize new ɳSelf project with configuration wizard
  • nself build - Generate Docker Compose configs, Nginx configs, and service files
  • nself start - Start all services or specific services
  • nself stop - Stop all services or specific services
  • nself restart - Restart all services or specific services

Utilities (15)

Day-to-day development tools:

  • nself status - Service health and status
  • nself logs - View service logs
  • nself help - Help system
  • ɳSelf admin - Admin UI access
  • nself urls - Service URLs
  • nself exec - Execute commands in containers
  • nself doctor - System diagnostics
  • nself monitor - Monitoring dashboards
  • nself health - Health checks
  • nself version - Version information
  • nself update - Update ɳSelf
  • nself completion - Shell completions
  • nself metrics - Metrics and profiling
  • nself history - Command history and audit trail
  • ɳSelf audit - Security audit logging

Feature Commands (11)

Domain-specific functionality with rich subcommands:

db - Database Operations (14 subcommands)

  • nself db migrate - Database migrations
  • nself db schema - Schema management
  • nself db seed - Seed data
  • nself db backup - Create backups
  • nself db restore - Restore from backup
  • nself db shell - PostgreSQL shell
  • nself db query - Execute SQL queries
  • nself db types - Generate TypeScript/Go/Python types

tenant - Multi-Tenancy (60+ subcommands)

  • nself tenant create - Create new tenant
  • nself tenant list - List all tenants
  • nself tenant billing - Billing management
  • nself tenant branding - White-label branding
  • nself tenant domains - Custom domain management
  • nself tenant compliance gdpr - GDPR compliance (v0.9.7)
  • nself tenant compliance hipaa - HIPAA compliance (v0.9.7)
  • nself tenant compliance soc2 - SOC2 compliance (v0.9.7)

deploy - Deployment (23 subcommands)

  • nself deploy staging - Deploy to staging
  • nself deploy production - Deploy to production
  • nself deploy preview - Ephemeral preview environments
  • nself deploy canary - Percentage-based rollout
  • nself deploy blue-green - Zero-downtime deployment
  • nself deploy server - VPS lifecycle management
  • nself deploy sync - Environment synchronization

infra - Infrastructure (38 subcommands)

  • ɳSelf infra provider - 26+ cloud providers (v0.9.6: renamed from "cloud")
  • ɳSelf infra k8s - Kubernetes management
  • ɳSelf infra helm - Helm chart management
  • ɳSelf infra provider server create - Provision VPS
  • ɳSelf infra provider cost estimate - Cost estimation

service - Service Management (43 subcommands)

  • nself service email - Email configuration (16+ providers)
  • nself service search - Search engine setup (6 engines)
  • nself service storage - MinIO storage management
  • nself service cache - Redis cache operations
  • nself service functions - Serverless functions
  • nself service mlflow - ML experiment tracking
  • nself service admin-dev - Admin UI development mode

config - Configuration (20 subcommands)

  • nself config env - Environment management
  • nself config secrets - Secrets management
  • nself config vault - Vault integration (v0.9.7)
  • nself config vault init - Initialize secrets vault
  • nself config vault rotate - Rotate secrets

auth - Authentication & Security (38 subcommands)

  • nself auth oauth - OAuth provider management (13 providers)
  • nself auth mfa - Multi-factor authentication
  • nself auth roles - Role management
  • nself auth devices - Device management
  • nself auth webhooks - Authentication webhooks
  • nself auth security - Security hardening

perf - Performance (5 subcommands)

  • nself perf profile - Performance profiling
  • nself perf bench - Benchmarking
  • nself perf scale - Auto-scaling
  • nself perf optimize - Optimization recommendations

backup - Backup & Recovery (6 subcommands)

  • nself backup create - Create backup
  • nself backup restore - Restore from backup
  • nself backup list - List backups
  • nself backup schedule - Schedule automated backups

dev - Developer Tools (16 subcommands)

  • ɳSelf dev scaffold - Scaffold new services
  • ɳSelf dev templates - Template management
  • ɳSelf dev ci - CI/CD workflow generation
  • ɳSelf dev docs - Documentation generation

plugin - Plugin System (8 subcommands)

  • nself plugin list - List available plugins
  • nself plugin install - Install plugin (Stripe, GitHub, Shopify)
  • nself plugin remove - Remove plugin
  • nself plugin update - Update plugins
  • nself plugin status - Plugin status

Infrastructure Management

destroy - Safe Infrastructure Destruction

Safe destruction of project infrastructure with configurable scope and safety features:

  • ɳSelf destroy - Interactive destruction (safest)
  • ɳSelf destroy --dry-run - Preview what would be destroyed
  • ɳSelf destroy --keep-volumes - Preserve data volumes
  • ɳSelf destroy --containers-only - Only remove containers

Detailed Documentation

For detailed documentation on each command, use ɳSelf <command> --help or visit our individual command pages.