Installation

Installation

Install ɳSelf v1.1.1 on macOS, Linux, or Windows (WSL2). The CLI is a single Go binary distributed via GitHub Releases, Homebrew, and a one-line installer.

Contents

• Prerequisites
• macOS
• Linux
• Manual Install
• Verify Installation
• Uninstall

Prerequisites

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

macOS

Install via Homebrew using the official tap:

brew install nself-org/nself/nself

This installs the latest stable release and keeps it up to date with brew upgrade.

Linux

Install with the official installer script:

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

The script detects your architecture (amd64 or arm64), downloads the appropriate binary, and places it in /usr/local/bin.

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 Installation

nself version

Expected output:

nself v1.1.1 (linux/amd64)

Uninstall

Homebrew:

brew uninstall nself

Linux / manual:

sudo rm /usr/local/bin/nself
rm -rf ~/.nself

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

---

Next: Quick Start · First Project