Skip to content
Docs GitHub

upgrade

Self-update the Sentry CLI to the latest or a specific version.

Usage

Terminal window
sentry upgrade # Update to latest version
sentry upgrade 0.5.0 # Update to specific version
sentry upgrade --check # Check for updates without installing
sentry upgrade --method npm # Force using npm to upgrade

Alias: sentry update

Options

OptionDescription
<version>Target version to install (defaults to latest)
--checkCheck for updates without installing
--method <method>Force installation method: curl, npm, pnpm, bun, yarn

Installation Detection

The CLI auto-detects how it was installed and uses the same method to upgrade:

MethodDetection
curlBinary located in ~/.sentry/bin (installed via cli.sentry.dev)
npmGlobally installed via npm install -g sentry
pnpmGlobally installed via pnpm add -g sentry
bunGlobally installed via bun install -g sentry
yarnGlobally installed via yarn global add sentry

Examples

Check for updates

Terminal window
sentry upgrade --check
Installation method: curl
Current version: 0.4.0
Latest version: 0.5.0
Run 'sentry upgrade' to update.

Upgrade to latest

Terminal window
sentry upgrade
Installation method: curl
Current version: 0.4.0
Latest version: 0.5.0
Upgrading to 0.5.0...
Successfully upgraded to 0.5.0.

Upgrade to specific version

Terminal window
sentry upgrade 0.5.0

Force installation method

If auto-detection fails or you want to switch installation methods:

Terminal window
sentry upgrade --method npm