Skip to content

Commit 05ebaad

Browse files
authored
docs(self-hosted): update Linux compatibility with Amazon Linux 2023 (#14476)
Previously, it was stated that RHEL-based distro is a no-go for installing self-hosted Sentry. But somebody did it with Amazon Linux 2023 (which is a Fedora derivative, very similar to RHEL). interestingly with SELinux enabled, and... you can just read the screenshot below. I'm adding that to the docs since that is so useful. <img width="1168" height="905" alt="image" src="https://github.com/user-attachments/assets/85dc9b25-d176-4166-8f98-1f56ca8d727b" />
1 parent 58a5177 commit 05ebaad

File tree

1 file changed

+7
-1
lines changed

1 file changed

+7
-1
lines changed

develop-docs/self-hosted/index.mdx

Lines changed: 7 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -40,7 +40,13 @@ Depending on your traffic volume, you may want to increase your system specifica
4040

4141
If increasing the disk storage space isn't possible, you can migrate your storage to use external storage such as AWS S3 or Google Cloud Storage (GCS). Decreasing your `SENTRY_RETENTION_DAYS` environment variable to lower numbers will save some storage space from being full, at the cost of having shorter data retention period. See [Event Retention](/self-hosted/configuration#event-retention) section.
4242

43-
There are known issues on installing self-hosted Sentry on RHEL-based Linux distros, such as CentOS, Rocky Linux, and Alma Linux. It is also not possible to install on an Alpine Linux distro. Most people succeed with Debian/Ubuntu-based distros. If you successfully install on another distro, please let us know on the [Sentry's Discord](https://discord.gg/sentry)!
43+
Below is a breakdown of self-hosted Sentry installation compatibility with various Linux distributions:
44+
* **Debian/Ubuntu-based** distros are preferred; most users succeed with them, and they're used on Sentry's dogfood instance.
45+
* **RHEL-based Linux** distributions (e.g., CentOS, Rocky Linux, Alma Linux) have known installation issues. While some users have made it work by disabling SELinux, this is highly discouraged.
46+
* **Amazon Linux 2023**, a Fedora Linux derivative, has seen one person successfully run self-hosted Sentry. This was achieved with SELinux enabled and by adding their user to the `docker` group.
47+
* **Alpine Linux** is unsupported due to install script compatibility.
48+
49+
If you successfully install Sentry on a different distribution, please share your experience on the [Sentry's Discord](https://discord.gg/sentry)!
4450

4551
## Getting Started
4652

0 commit comments

Comments
 (0)