Skip to content

docs(readme): Set minimum self-hosted version #3027

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
szokeasaurusrex wants to merge 1 commit into
base: master
Choose a base branch
from
Open

docs(readme): Set minimum self-hosted version #3027

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
docs(readme): Set minimum self-hosted version (#3027) 
### Description
Set minimum supported self-hosted version, and add this to README.

### Issues
- Resolves #3026
- Resolves [CLI-246](https://linear.app/getsentry/issue/CLI-246/mention-minimum-supported-self-hosted-version-in-readme)
  • Loading branch information
@szokeasaurusrex
szokeasaurusrex committed Dec 12, 2025
commit b9001c5705c7b43af8f154056ead22b032a5cc00
6 changes: 6 additions & 0 deletions CHANGELOG.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,5 +1,11 @@
# Changelog

## Unreleased

### New Sentry Support Policy

`sentry-cli` 3.0.0 and above only officially supports Sentry SaaS and Sentry self-hosted versions [25.11.1](https://github.com/getsentry/sentry/releases/tag/25.11.1) and higher. While many Sentry CLI features may, in practice, continue working with some older Sentry versions, continued support for Sentry versions older than 25.11.1 is not guaranteed. Changes which break support for Sentry versions below 25.11.1 may occur in minor or patch releases.

## 2.58.4

### Fixes
Expand Down
17 changes: 17 additions & 0 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -18,6 +18,23 @@ Sentry CLI can be used for many tasks, including uploading debug symbols and sou

Please refer to [Sentry CLI's documentation page](https://docs.sentry.io/cli/).

## Compatibility

Sentry CLI officially supports [Sentry SaaS](https://sentry.io/) and [Sentry Self-Hosted](https://github.com/getsentry/self-hosted) versions 25.11.1 and above.

### Self-Hosted Sentry

Although some Sentry CLI features may work with versions of Sentry Self-Hosted prior to 25.11.1, we recommend users upgrade their self-hosted installations to a compatible version.

For users who cannot upgrade their self-hosted installation, we recommend using the latest compatible Sentry CLI version, per the table below:

| **Sentry Self-Hosted Version** | **Newest Compatible Sentry CLI Version** |
| ------------------------------ | --------------------------------------------------------------------- |
| ≥ 25.11.1 | [latest](https://github.com/getsentry/sentry-cli/releases/latest) |
| < 25.11.1 | [2.58.4](https://github.com/getsentry/sentry-cli/releases/tag/2.58.4) |

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.

## Compiling

In case you want to compile this yourself, you need to install at minimum the
Expand Down