Skip to content

cmd update

github-actions[bot] edited this page May 15, 2026 · 4 revisions

nself update

Update the ɳSelf CLI binary and admin UI.

Synopsis

nself update [flags]

Description

nself update checks for new releases of the ɳSelf CLI on GitHub (nself-org/cli) and installs the latest version. It replaces the current binary in-place and optionally restarts running services after the update.

By default, nself update updates both the CLI binary and the admin Docker image. Use --cli or --admin to update only one component. Use --check to see if an update is available without installing anything.

If you are running an active ɳSelf project and update the CLI, you may want to run nself build --force && nself restart afterward to regenerate docker-compose.yml with any new defaults from the updated version.

v0.9 legacy detection

When running on a v0.9 CLI (any 0.x.y binary), nself update --check queries ping.nself.org/version, receives a migration block in the response, and surfaces the migration guide URL directly in the terminal:

WARNING: You are running a legacy v0.9 CLI. Migration to v1.1.1 is required.
Upgrade guide: https://docs.nself.org/migrate/from-v0.9

The check is read-only and non-destructive. It does not install anything. See Upgrade-From-v0.9 for the full migration guide.

Flags

Flag Default Description
--check false Check for updates without installing
--cli false Only update the CLI binary
--admin false Only update the admin UI Docker image
--force false Force update even if already on the latest version
--restart false Restart services after update
--version "" Download and install a specific version (e.g. v1.2.3)
--help, -h Show help

Examples

# Check for updates without installing
nself update --check

# Update CLI and admin UI to latest
nself update

# Update only the CLI binary
nself update --cli

# Update only the admin UI
nself update --admin

# Force update even if already up to date
nself update --force

# Install a specific version
nself update --version v1.0.0

# Update and restart services
nself update --restart

Commands | Home

Home


Getting Started


Commands


Features


Configuration


Plugins (87 + 10 monitoring)

Free (25)
Pro (62)
Planned (26)
  • plugin-audit
  • plugin-blog
  • plugin-checkout
  • plugin-commerce
  • plugin-drm
  • plugin-export
  • plugin-flow
  • plugin-import
  • plugin-ldap
  • plugin-mailgun
  • plugin-media
  • plugin-oauth-providers
  • plugin-pages
  • plugin-postmark
  • plugin-rate-limit
  • plugin-reports
  • plugin-saml
  • plugin-scheduler
  • plugin-sendgrid
  • plugin-sso
  • plugin-subscription
  • plugin-thumb
  • plugin-transcoder
  • plugin-twilio
  • plugin-waf
  • plugin-watermark

Guides


Architecture


Reference


Licensing


Security


Brand


Operations


Contributing


Admin


Changelog

Clone this wiki locally