diff --git a/get-started/index.md b/get-started/index.md
index 3ddb17f1c..75dc6c5f7 100644
--- a/get-started/index.md
+++ b/get-started/index.md
@@ -60,7 +60,8 @@ sqlite3 -version
 
 ::: code-group
 ```shell [macOS/Linux]
-brew install sapmachine-jdk
+brew tap sap/sapmachine
+brew install sapmachine25-jdk
 brew install maven
 ```
 ```PowerShell [Windows]
diff --git a/java/migration.md b/java/migration.md
index 72b3dbfe1..2d676d743 100644
--- a/java/migration.md
+++ b/java/migration.md
@@ -184,6 +184,11 @@ If your project uses Lombok, you must explicitly add its annotation processor to
 [Learn more about Maven setup with Lombok.](https://projectlombok.org/setup/maven){.learn-more}
 [Learn more about the change in the Java compiler.](https://bugs.java.com/bugdatabase/JDK-8321314/description){.learn-more}
 
+::: warning
+The `cds-services-archetype` and therefore also `cds init --java` is not working with JDK 26, because of an incompatibility of the generic `maven-archetype-plugin` with that Java version. For project creation use JDK 21 or 25 to avoid creation issues.
+Using Homebrew on MacOS to install latest Maven version, will cause also the installation of a JDK 26. Ensure that the environment variable JAVA_HOME points to a JDK 21 or 25.
+:::
+
 ### Removed Repackaged Olingo Dependencies { #removed-olingo-4-to-5 }
 
 The internal Maven modules `repackaged/odata-v4-lib` and `repackaged/odata-v2-lib` have been removed. If your project directly references these modules and does not compile after migrating to CAP Java 5.x, you have three options to maintain compatibility: