From 5c3df54e90f9e6d9360e55aba32d99244878a0bb Mon Sep 17 00:00:00 2001
From: Dominik <dguhr@redhat.com>
Date: Mon, 6 Sep 2021 10:11:39 +0200
Subject: [PATCH] KEYCLOAK-17812 extend building.md to prevent build errors

---
 docs/building.md | 19 ++++++++++++++++++-
 1 file changed, 18 insertions(+), 1 deletion(-)

diff --git a/docs/building.md b/docs/building.md
index 3b3259f1a88..9565a398002 100644
--- a/docs/building.md
+++ b/docs/building.md
@@ -5,7 +5,24 @@ Ensure you have JDK 8 (or newer), Maven 3.5.4 (or newer) and Git installed
     java -version
     mvn -version
     git --version
-    
+
+**NOTE**
+
+If you use Maven 3.8.1 or newer, please add the following mirror to your local
+`~/.m2/settings.xml` to avoid build errors:
+```
+<mirrors>
+  <mirror>
+    <id>jboss-public-repository-group-https</id>
+    <mirrorOf>jboss-public-repository-group</mirrorOf>
+    <name>Jboss public https</name>
+    <url>https://repository.jboss.org/nexus/content/groups/public/</url>
+  </mirror>
+</mirrors>
+```
+See [KEYCLOAK-17812](https://issues.redhat.com/browse/KEYCLOAK-17812) for more details.
+
+---    
 First clone the Keycloak repository:
     
     git clone https://github.com/keycloak/keycloak.git