diff --git a/.circleci/config.yml b/.circleci/config.yml
index 5212dd91..ac8b41b7 100644
--- a/.circleci/config.yml
+++ b/.circleci/config.yml
@@ -219,17 +219,28 @@ workflows:
       - check-dependencies
       - check-licenses
       - check-generate-site
+      # Java tests matrix for JDK under 25
       - tests-java:
           matrix:
+            alias: tests-java-jdk-old
             parameters:
               exe: [ docker-amd64-image, docker-arm64-image ]
-              maven-image: [ << pipeline.parameters.default-maven-image >>, "cimg/openjdk:17.0", "cimg/openjdk:20.0", "cimg/openjdk:21.0" ]
+              maven-image: [ << pipeline.parameters.default-maven-image >>, "cimg/openjdk:17.0", "cimg/openjdk:21.0" ]
+      # Java test matrix for JDK 25+
+      - tests-java:
+          matrix:
+            alias: tests-java-jdk-25+
+            parameters:
+              exe: [ docker-amd64-image, docker-arm64-image ]
+              maven-image: [ "cimg/openjdk:25.0" ]
+              arg-line: [ "--add-opens=java.base/java.nio=ALL-UNNAMED --sun-misc-unsafe-memory-access=allow" ]
       - deploy-snapshot:
           requires:
             - check-dependencies
             - check-licenses
             - check-generate-site
-            - tests-java
+            - tests-java-jdk-old
+            - tests-java-jdk-25+
           filters:
             branches:
               only: main
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 97fe3e8d..31358ef6 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,9 @@
 ## 1.8.0 [unreleased]
 
+### CI
+
+1. [#313](https://github.com/InfluxCommunity/influxdb3-java/pull/313): Clarify JDK 25+ requirements.
+
 ## 1.7.0 [2025-11-21]
 
 ### Bug Fixes
diff --git a/README.md b/README.md
index fe2d2083..d14e44de 100644
--- a/README.md
+++ b/README.md
@@ -33,12 +33,14 @@ which allows you to execute SQL queries against InfluxDB IOx.
 
 We offer this [Getting Started: InfluxDB 3.0 Java Client Library](https://www.youtube.com/watch?v=EFnG7rUDvR4) video for learning more about the library.
 
-> :warning: This client requires Java 11 and is compatible up to and including Java 21.
+> :warning: This client requires Java 11 and is compatible up to and including Java 25.
 
 ## Installation
 
 > :warning: Some JDK internals must be exposed by adding `--add-opens=java.base/java.nio=ALL-UNNAMED` to your JVM arguments.
 
+If you are using JDK 25 or later, you also need to add `--sun-misc-unsafe-memory-access=allow`.
+
 Add the latest version of the client to your project:
 
 ### Maven dependency