diff --git a/doc/settings/configuration.md b/doc/settings/configuration.md
index 08aab128ed738492176497d76fad088a20c1f3a9_ZG9jL3NldHRpbmdzL2NvbmZpZ3VyYXRpb24ubWQ=..5fc0b64be82c93e89fc0a848dadfbbe5aa460e3f_ZG9jL3NldHRpbmdzL2NvbmZpZ3VyYXRpb24ubWQ= 100644
--- a/doc/settings/configuration.md
+++ b/doc/settings/configuration.md
@@ -579,6 +579,10 @@
 used as SaaS or on-premise. It's Open Source, and you can
 [browse its source code repositories](https://github.com/getsentry).
 
+WARNING:
+From GitLab 17.0, only Sentry versions 21.5.0 or later will be supported. If you use an earlier version of a Sentry instance that you host, you must
+[upgrade Sentry](https://develop.sentry.dev/self-hosted/releases/) to continue collecting errors from your GitLab environments.
+
 To configure Sentry:
 
 1. Edit `/etc/gitlab/gitlab.rb`: