diff --git a/java/developing-applications/building.md b/java/developing-applications/building.md
index 5916fb860..904a2a747 100644
--- a/java/developing-applications/building.md
+++ b/java/developing-applications/building.md
@@ -337,7 +337,7 @@ It supports the following command-line options:
 | `-DodataVersion=[v2\|v4]` | Specify which protocol adapter is activated by default. Defaults to `v4`|
 | `-DtargetPlatform=cloudfoundry` | Adds CloudFoundry target platform support to the project. |
 | `-DinMemoryDatabase=[h2\|sqlite]` | Specify which in-memory database is used for local testing. If not specified, the default value is `h2`. |
-| `-DjdkVersion=[17\|21\|25]` | Specifies the target JDK version. Defaults to `21`. |
+| `-DjdkVersion=[21\|25]` | Specifies the target JDK version. Defaults to `25`. |
 | `-Dpersistence=[true\|false]` | Specify whether persistence is enabled (`true`) or disabled (`false`). Defaults to `true`. |
 | `-DcdsdkVersion=<a valid cds-dk version>` | Sets the provided cds-dk version in the project. If not specified, the default of CAP Java is used. |
 
diff --git a/java/migration.md b/java/migration.md
index 7d6b4d281..01d4fcbd3 100644
--- a/java/migration.md
+++ b/java/migration.md
@@ -67,6 +67,7 @@ CAP Java 5.0 increased some minimum required versions:
 
 | Dependency | Minimum Version |
 | --- | --- |
+| Java / JDK | 21 |
 | Spring Boot | 4.0 |
 | XSUAA (BTP Security Library) | 4.0.0 |
 | Maven | 3.9.10 |
@@ -144,7 +145,7 @@ The `cds-services-archetype` is used by the `@sap/cds-dk` to generate initial CA
 
 #### Default JDK Version
 
-The default JDK version of new CAP Java projects has been changed to JDK **25**. The minimum required JDK version hasn't changed and is still 17.
+The default JDK version of new CAP Java projects has been changed to JDK **25**. The minimum required JDK version has changed to **21**.
 
 ### Removed repackaged Olingo Dependencies { #removed-olingo-4-to-5 }