From 75a261c6e3a9e508da9468101f2dfa1e1734a442 Mon Sep 17 00:00:00 2001 From: Alexander Dinauer Date: Thu, 12 Nov 2026 11:14:36 +0100 Subject: [PATCH 1/3] docs(java): Document Java 11 minimum Add the Java 11 runtime requirement to the Java setup and v8-to-v9 migration documentation. Refs getsentry/sentry-java#6459 Co-Authored-By: OpenAI --- docs/platforms/java/common/index.mdx | 6 ++++++ docs/platforms/java/common/migration/8.x-to-9.0.mdx | 4 ++++ 2 files changed, 10 insertions(+) diff --git a/docs/platforms/java/common/index.mdx b/docs/platforms/java/common/index.mdx index 2f8445f0ca87d..3a7de188f71be 100644 --- a/docs/platforms/java/common/index.mdx +++ b/docs/platforms/java/common/index.mdx @@ -1,5 +1,11 @@ + + +Sentry Java SDK version 9 requires Java 11 or newer. Use SDK version 8.x for applications that must run on Java 8. + + + On this page, we get you up and running with Sentry's SDK. diff --git a/docs/platforms/java/common/migration/8.x-to-9.0.mdx b/docs/platforms/java/common/migration/8.x-to-9.0.mdx index 932e2977a42c8..33da01a8ef5f0 100644 --- a/docs/platforms/java/common/migration/8.x-to-9.0.mdx +++ b/docs/platforms/java/common/migration/8.x-to-9.0.mdx @@ -6,6 +6,10 @@ sidebar_order: 994 Version 9 removes deprecated Hub compatibility and OpenTelemetry APIs, along with the global Logs and Metrics enable options. Migrate remaining Hub and OpenTelemetry references, then update your telemetry configuration. +## Minimum Java Version + +The Sentry Java SDK is now compiled for Java 11. Applications running on Java 8 must upgrade their runtime to Java 11 or newer before using version 9. Stay on Sentry Java SDK 8.x if you can't upgrade the runtime. + ## Removed Hub APIs Version 8 deprecated Hub and introduced Scopes. Version 9 removes the Hub compatibility layer: From 2d1f9593d249a23819deecdc02a3a650206cc337 Mon Sep 17 00:00:00 2001 From: Alexander Dinauer Date: Thu, 12 Nov 2026 13:51:35 +0100 Subject: [PATCH 2/3] docs(java): Add Java 11 warning to Spring setup pages Show the Java 11 minimum on the Spring and Spring Boot setup pages so Java 8 users see the compatibility requirement before installing SDK v9. Co-Authored-By: Claude --- docs/platforms/java/guides/spring-boot/index.mdx | 6 ++++++ docs/platforms/java/guides/spring/index.mdx | 6 ++++++ 2 files changed, 12 insertions(+) diff --git a/docs/platforms/java/guides/spring-boot/index.mdx b/docs/platforms/java/guides/spring-boot/index.mdx index fedb5bdefc6e3..cadde6d2dc943 100644 --- a/docs/platforms/java/guides/spring-boot/index.mdx +++ b/docs/platforms/java/guides/spring-boot/index.mdx @@ -6,6 +6,12 @@ sdk: sentry.java.spring-boot + + +Sentry Java SDK version 9 requires Java 11 or newer. Use SDK version 8.x for applications that must run on Java 8. + + + On this page, we get you up and running with Sentry's SDK. Don't already have an account and Sentry project established? Head over to [sentry.io](https://sentry.io/signup/), then return to this page. diff --git a/docs/platforms/java/guides/spring/index.mdx b/docs/platforms/java/guides/spring/index.mdx index 1907d6bcc77ee..44c291832bc9c 100644 --- a/docs/platforms/java/guides/spring/index.mdx +++ b/docs/platforms/java/guides/spring/index.mdx @@ -6,6 +6,12 @@ sdk: sentry.java.spring + + +Sentry Java SDK version 9 requires Java 11 or newer. Use SDK version 8.x for applications that must run on Java 8. + + + On this page, we get you up and running with Sentry's SDK. Don't already have an account and Sentry project established? Head over to [sentry.io](https://sentry.io/signup/), then return to this page. From 73364fcd5fd8867b37fcbc2b8f91b933164d5c17 Mon Sep 17 00:00:00 2001 From: Alexander Dinauer Date: Thu, 12 Nov 2026 13:54:08 +0100 Subject: [PATCH 3/3] docs(java): Clarify Java 11 build requirement Document that SDK v9 requires a Java 11 compiler or toolchain in addition to a Java 11 application runtime. Co-Authored-By: Claude --- docs/platforms/java/common/migration/8.x-to-9.0.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/platforms/java/common/migration/8.x-to-9.0.mdx b/docs/platforms/java/common/migration/8.x-to-9.0.mdx index 33da01a8ef5f0..9af9abfeea39a 100644 --- a/docs/platforms/java/common/migration/8.x-to-9.0.mdx +++ b/docs/platforms/java/common/migration/8.x-to-9.0.mdx @@ -8,7 +8,7 @@ Version 9 removes deprecated Hub compatibility and OpenTelemetry APIs, along wit ## Minimum Java Version -The Sentry Java SDK is now compiled for Java 11. Applications running on Java 8 must upgrade their runtime to Java 11 or newer before using version 9. Stay on Sentry Java SDK 8.x if you can't upgrade the runtime. +The Sentry Java SDK is now compiled for Java 11. To use version 9, configure your build to use a Java 11 or newer compiler/toolchain and run your application on Java 11 or newer. Stay on Sentry Java SDK 8.x if either environment must remain on Java 8. ## Removed Hub APIs