[!IMPORTANT] This repository is no longer under active development, as our new CLI will soon be replacing this one.
We are therefore no longer accepting feature requests for this repo. Also, we will generally only fix bugs in this repo when there is a concrete reason preventing adoption of the new CLI. Please raise new issues in the new CLI's repository, instead.
Sentry CLI
This is the repository for Sentry CLI, the official command line interface for Sentry.
Sentry CLI can be used for many tasks, including uploading debug symbols and source maps to Sentry, managing releases, and viewing Sentry data such as issues and logs.
Installation and Usage
Please refer to Sentry CLI's documentation page.
Compatibility
Sentry CLI officially supports Sentry SaaS and Sentry Self-Hosted versions 24.11.1 and above.
Self-Hosted Sentry
For self-hosted installations, only those features which were available in Sentry CLI at the time of the release of the given self-hosted version are supported, as new features may require server-side support. Additionally, some features, like the sentry-cli build commands, are restricted to Sentry SaaS.
Users who are using Sentry Self-Hosted versions older than 24.11.1 are encouraged to upgrade their Sentry Self-Hosted installations before using Sentry CLI versions 3.0.0 and above. For users who cannot upgrade, please use the version indicated in the table below.
| Sentry Self-Hosted Version | Newest Compatible Sentry CLI Version |
|---|---|
| ≥ 24.11.1 | latest |
| < 24.11.1 | 2.58.6 |
Note that we can only provide support for officially-supported Sentry Self-Hosted versions. We will not backport fixes for older Sentry CLI versions, even if they should be compatible with your self-hosted version.
Versioning
Sentry CLI follows semantic versioning, according to this versioning policy.
Compiling
In case you want to compile this yourself, you need to install at minimum the following dependencies:
- Rust stable and Cargo
- Make, CMake and a C compiler
Use cargo to compile:
$ cargo build
Also, there is a Dockerfile that builds an Alpine-based Docker image with
sentry-cli in the PATH. To build and use it, run:
docker build -t sentry-cli .
docker run --rm -v $(pwd):/work sentry-cli --helpInternal docs
Snapshot: Sentry CLI distribution as of 2026-01-29.