ɳ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

Self-host your own complete backend in just seconds.

Complete modular backend infrastructure with PostgreSQL, GraphQL, Auth, Storage, Real-time Subscriptions, Multi-tenancy, Billing, Security, Migrations, and more - all with just a single command.

Get startedView on GitHub
Terminal
Docker Compose
1
2
3
4
5
6
7
8
9
10
11
# Initialize your backend infrastructure
nself init
# Enable admin UI (optional)
ɳSelf admin enable
# Start all services (builds automatically)
nself up
# View all service URLs
nself urls

Installation

Step-by-step guides to setting up your system and installing nself.

Database Tools

Learn how to use the database management suite.

Plugins

87 plugins for payments, AI, notifications, scheduling, and more.

CLI Reference

34 commands, 323+ subcommands. Complete CLI reference.

ɳSelf Documentation

Complete guide to deploying enterprise-grade backend infrastructure with ɳSelf CLI. Learn how to set up PostgreSQL, Hasura GraphQL, Redis, authentication, storage, real-time subscriptions, multi-tenancy, billing, security, and microservices in minutes.

New in v1.0.0

mux: Rule-based message routing across email, Telegram, SMS, and webhooks

ai: Unified AI inference gateway for OpenAI, Anthropic, Gemini, and Ollama

license: Membership key management for Pro and Max plugin tiers

claw: Autonomous AI assistant CLI with configurable identity

Fully Managed Solution - Coming Soon

Don't want to manage your own infrastructure? Our fully managed hosting solution is coming soon.Join the waitlist →


Quick start

Get your backend infrastructure running in minutes. ɳSelf handles all the complexity of orchestrating multiple services, configuring databases, and setting up authentication.

Installing the CLI

Install the ɳSelf CLI with our simple installer script. This will download the latest version and add it to your PATH automatically.

curl -sSL https://install.nself.org | bash

The installer detects your operating system and architecture, downloads the appropriate binary, and sets up shell completions for an enhanced developer experience.

System Requirements

Make sure you have Docker and Docker Compose installed before running nself. The CLI will check for these dependencies during initialization.

Creating your first project

Initialize a new ɳSelf project with default configuration. This creates all necessary files and validates your environment.

# Initialize with smart defaults (v1.0.0)
nself init

# Enable admin UI (optional)
ɳSelf admin enable

# Start all services (builds automatically)
nself up

# View all service URLs
nself urls

Your backend is now running! Access your services at:

  • Admin UI: http://localhost:3021
  • Hasura GraphQL Console: http://localhost:8080
  • MinIO Console: http://localhost:9001
  • Database: localhost:5432
  • Redis: localhost:6379

Pro Tip

Use nself logs -f to stream logs from all services, or nself logs hasura -f to follow logs from a specific service.


Basic usage

ɳSelf provides a complete set of commands for managing your backend infrastructure. Here are the most common operations you'll use daily.

Managing your services

Control your backend services with simple commands. ɳSelf handles orchestration, health checks, and graceful shutdowns automatically.

# Start all services
nself up

# Stop all services
nself down

# Enable and access admin UI
ɳSelf admin enable
ɳSelf admin open

# Restart a specific service
nself restart hasura

# View service status and URLs
nself status
nself urls

Database operations

ɳSelf provides database management tools. Work with schema-first development using DBML and automatic migrations.

# Create sample schema
nself db sample

# Generate migrations from schema changes
nself db migrate

# Apply migrations safely
nself db update

# Rollback last migration
nself db rollback

# Seed your database
nself db seed

# Check database status
nself db status

# Sync with dbdiagram.io
nself db sync

Adding microservices

Extend your backend with additional microservices. ɳSelf provides templates for common patterns and frameworks.

# Enable optional services in .env.local
# NESTJS_ENABLED=true
# BULLMQ_ENABLED=true
# GOLANG_ENABLED=true
# PYTHON_ENABLED=true

# Rebuild with new services
nself build
nself up

# View all running services
nself status

Getting help

We're here to help you succeed with ɳSelf. Find answers, report issues, and connect with the community.

Submit an issue

Found a bug or have a feature request? Open an issue on our GitHub repository. We actively monitor and respond to all issues.

Before submitting, please check existing issues to avoid duplicates. Include as much detail as possible, including your nself version, OS, and steps to reproduce.

Join the community

Connect with other ɳSelf users, share your projects, and get help from the community. We maintain active discussions on GitHub where you can ask questions and share knowledge.

Follow the project on GitHub to stay updated with new releases, and consider starring the repository if you find ɳSelf useful!