Note
We're building a new Sentry CLI with AI-powered workflows, built-in AI skills, and first-class support for use by agents. It already covers several sentry-cli features (including source maps) and is planned to become the next major version — the APIs are closely aligned, so migration will be smooth when the time comes.
If you're using sentry-cli in CI/CD pipelines today, you're in the right place — nothing is changing yet. If you want AI capabilities or agent integration, give the new CLI a try.
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.
Please refer to Sentry CLI's documentation page.
Sentry CLI officially supports Sentry SaaS and Sentry Self-Hosted versions 24.11.1 and above.
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.5 |
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.
Sentry CLI follows semantic versioning, according to this versioning policy.
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 --helpSnapshot: Sentry CLI distribution as of 2026-01-29.