Update the nSelf CLI binary and the Admin Docker image in a single step. CLI and Admin always ship the same version — updating one without the other is not supported.
# Update CLI + Admin to the latest release
nself update
# Update only the Admin Docker image
nself update imagesnself update [images] [FLAGS]nself update (without subcommands) performs a full update: it fetches the latest CLI binary from GitHub Releases, replaces the current binary in place, and pulls the matchingnself/nself-admin Docker image. Both the CLI and Admin always share the same version number — this is a hard invariant.
nself update images only refreshes the Docker images without touching the CLI binary. Use this if you installed the CLI via Homebrew and want to keep Homebrew as the update manager for the binary itself.
After updating, if any of your running projects need config regeneration (for example, because a new service was added in the new version), the CLI will prompt you to run nself build. Nothing changes in your project files automatically.
Full update: CLI binary + Admin Docker image.
nself update
# Current version: v1.1.0
# Latest version: v1.1.0
# Downloading CLI v1.1.0... done
# Pulling nself/nself-admin:v1.1.0... done
# Updated to v1.1.0.
#
# Run nself build in any active project to pick up config changes.Pull the latest Docker images without replacing the CLI binary. Useful when the CLI is managed by Homebrew.
nself update images
# Pulling nself/nself-admin:v1.1.0... done
# Images updated.| Flag | Type | Default | Description |
|---|---|---|---|
--version <v> | string | latest | Update to a specific version instead of the latest |
--yes | bool | false | Skip the confirmation prompt |
--check | bool | false | Print the latest available version and exit without updating |
CLI and Admin always share the same version number. Running a v1.0.12 CLI with a v1.0.11 Admin image — or any other mismatch — is unsupported and will produce a warning on nself admin start. Always update both together.
# If you installed via Homebrew, update the binary through Homebrew
brew upgrade nself
# Then pull the matching Docker images
nself update images# Roll back to a specific patch
nself update --version v1.0.11
# Check what the latest available version is
nself update --check
# Latest: v1.1.0NSELF_UPDATE_CHANNEL — stable (default) or edge (pre-release builds)