Skip to main content

​
Installation

Sentry CLI can be installed in several ways depending on your environment and preferences. Choose the method that works best for your workflow. The install script is the fastest way to get started. It automatically detects your platform, downloads the appropriate binary, and configures your shell. 
curl -fsSL https://cli.sentry.dev/install | bash
The install script supports macOS, Linux, and Windows (via Git Bash/WSL). It requires curl and standard Unix utilities.

​
Install Script Options

The install script supports several options for customization: 
# Install a specific version
curl -fsSL https://cli.sentry.dev/install | bash -s -- --version 0.15.0

# Install nightly build (latest development version)
curl -fsSL https://cli.sentry.dev/install | bash -s -- --version nightly

# Skip modifying shell configuration files
curl -fsSL https://cli.sentry.dev/install | bash -s -- --no-modify-path

# Skip installing shell completions
curl -fsSL https://cli.sentry.dev/install | bash -s -- --no-completions

# Custom installation directory
SENTRY_INSTALL_DIR=~/.local/bin curl -fsSL https://cli.sentry.dev/install | bash

​
What the Install Script Does

1

Platform Detection

Detects your operating system and CPU architecture (x64 or ARM64).
2

Binary Download

Downloads the appropriate native binary from GitHub Releases (for stable versions) or GHCR (for nightly builds). The script attempts to download gzip-compressed binaries first (~60% smaller) before falling back to uncompressed versions.
3

Installation & Setup

Delegates to the binary’s built-in sentry cli setup --install command, which:
  • Installs the binary to an appropriate directory (~/.sentry/bin or custom location)
  • Updates your shell configuration files (.bashrc, .zshrc, etc.) to add the binary to your PATH
  • Installs shell completions for Bash, Zsh, and Fish
  • Displays a welcome message with next steps

​
Error Reporting

The install script includes automatic error reporting to help improve installation reliability. Errors are sent to Sentry using a write-only DSN.
Opt out of telemetry by setting SENTRY_CLI_NO_TELEMETRY=1 before running the install script.

​
Homebrew

For macOS users, Homebrew provides an easy installation method: 
brew install getsentry/tools/sentry
Homebrew automatically:
  • Installs the binary to your Homebrew bin directory
  • Adds it to your PATH
  • Manages updates with brew upgrade

​
Updating via Homebrew

brew upgrade sentry

​
Package Managers

Sentry CLI is available on npm and compatible package managers. This is ideal for Node.js projects or when you want to pin a specific version in your project’s dependencies. 
npm install -g sentry
Package manager installations require Node.js 22 or higher. The npm package includes the bundled CLI code that runs on Node.js.

​
Project-Local Installation

You can also install Sentry CLI as a project dependency: 
npm install --save-dev sentry
Then run it via npm scripts or npx:
package.json
{
  "scripts": {
    "sentry": "sentry"
  }
}

npm run sentry -- issue list

​
Run Without Installing

Use npx to run Sentry CLI without installing it globally. This is useful for one-off commands or testing: 
npx sentry@latest auth login
npx sentry@latest issue list
npx sentry@latest issue explain PROJ-ABC
npx downloads and caches the package on first run, so subsequent commands are faster.

​
Platform Support

Sentry CLI provides native binaries for the following platforms:
Operating SystemArchitectureInstall ScriptHomebrewnpm/npx
macOSx64 (Intel)✅✅✅
macOSARM64 (M1+)✅✅✅
Linuxx64✅❌✅
LinuxARM64✅❌✅
Windowsx64✅*❌✅
*Windows support via Git Bash, WSL, or MSYS2.

​
Nightly Builds

Nightly builds contain the latest features and fixes but may be less stable than official releases. They’re distributed via GitHub Container Registry (GHCR).

​
Installing Nightly Builds

# Via install script
curl -fsSL https://cli.sentry.dev/install | bash -s -- --version nightly

# Via package managers
npm install -g sentry@nightly
pnpm add -g sentry@nightly
bun add -g sentry@nightly
Nightly builds use versioned tags (:nightly-<version>) on GHCR to support delta upgrades, which download only the changes between versions (~50KB vs ~29MB full download).

​
Verifying Installation

After installation, verify that Sentry CLI is available: 
sentry --version
You should see output like: 
sentry 0.15.0

​
Upgrading

To upgrade to the latest version: 
sentry cli upgrade
The sentry cli upgrade command remembers your installation method and upgrade channel (stable or nightly) for seamless updates.

​
Uninstalling

To remove Sentry CLI from your system: 
rm -rf ~/.sentry
# Then remove the PATH entry from your shell config

​
Configuration Directory

Sentry CLI stores authentication tokens, cached data, and configuration in ~/.sentry/: 
~/.sentry/
├── bin/           # Binary (install script method)
├── config.db      # SQLite database (auth, cache, settings)
└── config.db-wal  # SQLite write-ahead log
The database file has restricted permissions (mode 600) to protect your authentication tokens.
You can override the config directory by setting SENTRY_CONFIG_DIR environment variable.

​
Next Steps

Quick Start

Learn how to authenticate and run your first commands

Commands

Explore all available commands and their options

Build docs developers (and LLMs) love

Get started for freeTalk to us