diff --git a/readme.md b/readme.md
index 9a81d2b1ea01024f13ff10a7c75b1e2414d407c7..a6b20ba8b306ec30bee17fc05cafa193c0783a92 100644
--- a/readme.md
+++ b/readme.md
@@ -330,6 +330,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.