diff --git a/base-java-micro/Readme.md b/base-java-micro/Readme.md
index d814a480ca..28eefcd042 100644
--- a/base-java-micro/Readme.md
+++ b/base-java-micro/Readme.md
@@ -49,9 +49,11 @@ This project uses `maven-assembly-plugin` and `dockerfile-maven-plugin` to build
 To build SNAPSHOT images, configure `.m2/settings.xml` for SNAPSHOT dependencies. These must be available at build time.
 
 ```
-mvn clean package -Pdocker -DskipTests # Build local images
+mvn clean package -P docker-fabric8 -DskipTests # Build local images
 ```
 
+`-Pdocker` alone doesn't pin the `io.fabric8:docker-maven-plugin` version, so Maven hangs trying to resolve it. Use the `docker-fabric8` profile instead, which pins it correctly.
+
 ## License
 
 Usage of this image is subject to the license terms of the software contained within. Please refer to Confluent's Docker images documentation [reference](https://docs.confluent.io/platform/current/installation/docker/image-reference.html) for further information. The software to extend and build the custom Docker images is available under the Apache 2.0 License.
diff --git a/base-java/README.md b/base-java/README.md
index 00c763c1ab..423d5f36cd 100644
--- a/base-java/README.md
+++ b/base-java/README.md
@@ -35,9 +35,11 @@ This project uses `maven-assembly-plugin` and `dockerfile-maven-plugin` to build
 To build SNAPSHOT images, configure `.m2/settings.xml` for SNAPSHOT dependencies. These must be available at build time.
 
 ```
-mvn clean package -Pdocker -DskipTests # Build local images
+mvn clean package -P docker-fabric8 -DskipTests # Build local images
 ```
 
+`-Pdocker` alone doesn't pin the `io.fabric8:docker-maven-plugin` version, so Maven hangs trying to resolve it. Use the `docker-fabric8` profile instead, which pins it correctly.
+
 ## License
 
 Usage of this image is subject to the license terms of the software contained within. Please refer to Confluent's Docker images documentation [reference](https://docs.confluent.io/platform/current/installation/docker/image-reference.html) for further information. The software to extend and build the custom Docker images is available under the Apache 2.0 License.