diff --git a/readme.md b/readme.md
index d328b89b1d39b1ff875896aa37e6681c5ce0b0f9..98ea9e14d291d3045659cd75d4a9c0dd4b9fe47f 100644
--- a/readme.md
+++ b/readme.md
@@ -291,6 +291,9 @@ In order to authenticate a local development machine, Develocity offers automate
 
 When executed, the automated provisioning launches a web browser to [develocity-staging.eclipse.org](https://develocity-staging.eclipse.org/) and asks you to sign in. All Eclipse Foundation committers can log in using their Eclipse account: email / password.
 
+Be aware that the develocity Maven plugin waits only a very short time for the browser process to finish the authentication.
+If you get a Socket timeout or similar in the Maven console, just repeat the command and confirm more quickly in the browser.
+
 #### Unauthenticated Builds
 
 Builds that are not authenticated to Develocity will simply not publish a Build Scan®. A lack of authentication will not cause the build to fail and will not be shown to the user. This includes builds by unauthenticated Eclipse committers, unauthenticated CI systems, or community contributors.