Troubleshooting

Permission denied / sudo / PATH

If you see "permission denied" after running the install script, the binary wasn't placed in your PATH correctly.

# Verify install location
which nself

# If empty, add to PATH
export PATH="/usr/local/bin:$PATH"
source ~/.zshrc # or ~/.bashrc

# Re-run install if needed
curl -sSL https://install.nself.org/install.sh | bash

macOS users: The installer uses Homebrew, so ensure brew is installed first.

Signature verify failure (cosign)

Our binaries are signed with cosign. If verification fails, ensure you have cosign installed.

# Install cosign (macOS)
brew install sigstore/tap/cosign

# Or via Go
go install github.com/sigstore/cosign/v2/cmd/cosign@latest

See cosign installation docs for your platform.

Offline / airgapped install

For airgapped environments, download the binary and signature file directly.

# Download the binary and signature
curl -o nself https://github.com/nself-org/cli/releases/latest/download/nself-darwin-amd64
curl -o nself.sig https://github.com/nself-org/cli/releases/latest/download/nself-darwin-amd64.sig

# Make executable
chmod +x nself

# Move to PATH
sudo mv nself /usr/local/bin/

Windows / WSL

For native Windows (not WSL), we recommend using PowerShell. For WSL, use the Linux installer.

# PowerShell (Windows native)
iwr -useb https://install.nself.org/install.ps1 | iex

# WSL (Linux subsystem)
curl -sSL https://install.nself.org/install.sh | bash

Docker fallback

If installation fails, you can run nself via Docker.

docker run -it nself/cli:latest nself --help

Learn more: Docker installation guide

Back to install · Support