Remove the nSelf CLI binary and its global config directory (~/.nself/) from your machine. Your project directories, databases, and Docker volumes are left untouched.
# Remove the CLI binary and ~/.nself/
nself uninstallnself uninstall [FLAGS]nself uninstall removes two things:
nself binary from the location it was installed to (typically /usr/local/bin/nself or the Homebrew prefix)~/.nself/, which stores your license key, telemetry preference, and shell completion scriptsIt does not touch your project data. Every nSelf project stores its state in a project directory of your choosing. Docker volumes with your Postgres data, MinIO objects, and plugin state remain on disk unless you explicitly run nself reset --all inside each project first.
If you installed via Homebrew, you can also uninstall with brew uninstall nself. Both paths produce the same result.
| Item | Removed? |
|---|---|
nself binary | Yes |
~/.nself/ global config | Yes |
| Shell completion scripts | Yes (registered inside ~/.nself/) |
| Your project directories | No |
| Docker volumes (Postgres, MinIO, etc.) | No |
| Your license key (copy before uninstalling) | Yes — stored in ~/.nself/config.yaml |
| Trust config (mkcert CA, port forwarding) | No — run nself trust uninstall first if wanted |
| Flag | Type | Default | Description |
|---|---|---|---|
--yes | bool | false | Skip the confirmation prompt |
# Print your current license key
nself license show
# Copy it somewhere safe — it is not recoverable from ~/.nself/ after uninstall# Stop each project before removing the CLI
cd ~/my-project
nself stop# If you want to remove Postgres volumes and plugin state too:
cd ~/my-project
nself reset --all # irreversible — removes all Docker volumes for this project# Via Homebrew
brew install nself-org/tap/nself
# Via the installer script
curl -fsSL https://install.nself.org | bash