Installation - nself-org/cli GitHub Wiki

Installation

Upgrading from v0.9? See the Upgrade-From-v0.9 guide for step-by-step migration instructions.

OS Support

Platform Architecture Status Guide
macOS Apple Silicon (arm64) Supported macOS Apple Silicon
macOS Intel (amd64) Supported macOS Intel
Linux x86_64 (amd64) Supported Linux x86_64
Linux arm64 (aarch64) Supported Linux arm64
Windows WSL2 Supported Windows WSL2
Windows Native amd64 Supported v1.1.0+ Windows Native
Windows Native arm64 Supported v1.1.0+ Windows Native
Raspberry Pi arm64 Supported Raspberry Pi

Windows native binaries (windows-amd64.zip, windows-arm64.zip) ship from v1.1.0 onward. Download from GitHub Releases or use the PowerShell installer. WSL2 remains the simplest path if Docker Desktop is already running. See install/windows-native for native install and install/windows-wsl2 for WSL2.

Platform Guides

Platform Architecture Description
macOS Apple Silicon darwin/arm64 M1/M2/M3/M4 , OrbStack vs Docker Desktop, VirtioFS
macOS Intel darwin/amd64 Intel Mac , Homebrew, binary download
Linux x86_64 linux/amd64 Ubuntu, Debian, Fedora, Rocky, Amazon Linux
Linux arm64 linux/arm64 Graviton, Ampere Altra, Hetzner CAX, Pi
Windows WSL2 linux/amd64 WSL2 + Docker Desktop
Windows Native windows/amd64, windows/arm64 Native .exe via PowerShell installer or manual download
Raspberry Pi linux/arm64 Pi 4/5; RAM budgeting; minimal preset

Prerequisites

  • Docker 24 or later
  • Docker Compose v2 (included with Docker Desktop)
  • curl and bash (for Linux/macOS installer)

Quick Install

macOS

brew install nself-org/nself/nself

See install/macos-apple-silicon or install/macos-intel for platform-specific notes.

Linux

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

The script detects your architecture (amd64 or arm64) and downloads the correct binary. See install/linux-x86_64 or install/linux-arm64 for manual install and verification.

Windows (Native, v1.1.0+)

Download nself-<version>-windows-amd64.zip from GitHub Releases, extract, and add the directory to your PATH. Or use the PowerShell installer:

irm https://install.nself.org/install.ps1 | iex

See install/windows-native for the full guide including SHA-256 verification and PATH setup.

Windows (WSL2)

WSL2 + Docker Desktop is the simplest Windows path. See install/windows-wsl2 for the full step-by-step guide covering WSL2 setup, Docker integration, and troubleshooting.

Raspberry Pi

See install/raspberry-pi for RAM budgeting, SSD recommendations, and the minimal services preset.

Manual Install

  1. Download the binary for your platform from GitHub Releases.
  2. Make it executable and place it on your PATH:
chmod +x nself-linux-amd64
sudo mv nself-linux-amd64 /usr/local/bin/nself

Verify Your Install

nself version

Expected output:

nself v1.0.9 (linux/amd64)

nself doctor

Expected output (all green):

✓ Docker: running (v26.1.0)
✓ Docker Compose: v2.27.0
✓ curl: available
✓ bash: available
✓ Architecture: amd64

If nself doctor reports a problem, see Errors for remediation steps.

Uninstall

See install/uninstall for full per-OS instructions including Docker cleanup steps.

Quick uninstall:

# macOS (Homebrew)
brew uninstall nself

# Linux / manual
sudo rm /usr/local/bin/nself
rm -rf ~/.nself

This removes the CLI binary and local state. Your project .env files and Docker volumes are preserved.

← Home | Quick-Start →

ɳSelf CLI v1.0.9. MIT licensed. Docs CC BY 4.0.

GitHub · Issues · Discussions · nself.org · docs.nself.org

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