diff --git a/spring-ai-docs/src/main/antora/modules/ROOT/pages/getting-started.adoc b/spring-ai-docs/src/main/antora/modules/ROOT/pages/getting-started.adoc
index 2cf86a61f3..e4f2f43914 100644
--- a/spring-ai-docs/src/main/antora/modules/ROOT/pages/getting-started.adoc
+++ b/spring-ai-docs/src/main/antora/modules/ROOT/pages/getting-started.adoc
@@ -70,6 +70,13 @@ repositories {
   }  
 }
 ----
+**NOTE:** If you're using Maven mirror settings (typically in `settings.xml`), ensure your `<mirrorOf>` configuration excludes Spring repositories:
+```xml
+<mirror>
+    <mirrorOf>*,!spring-snapshots,!central-portal-snapshots</mirrorOf>
+    <!-- other mirror configurations -->
+</mirror>
+```
 ======
 
 [[dependency-management]]