diff --git a/docs/src/main/asciidoc/security-openid-connect-dev-services.adoc b/docs/src/main/asciidoc/security-openid-connect-dev-services.adoc
index f12469eb6bb57..39bdb13491a11 100644
--- a/docs/src/main/asciidoc/security-openid-connect-dev-services.adoc
+++ b/docs/src/main/asciidoc/security-openid-connect-dev-services.adoc
@@ -51,6 +51,11 @@ include::{includes}/devtools/dev.adoc[]
 ...
 ----
 
+[NOTE]
+====
+Timeout for starting a Keycloak container is 60 secs. You will see an error, `Timed out waiting for log output matching '.*Keycloak.*started.*` if the container failed to start in 60 seconds which may happen due to an image download taking a long time. You can increate the timeout, for example, to 2 minutes: `quarkus.devservices.timeout=2M`.
+====
+
 Note that you can disable sharing the containers with `quarkus.keycloak.devservices.shared=false`.
 
 Now open the main link:http://localhost:8080/q/dev-v1[Dev UI (v1) page], and you will see the `OpenID Connect Card` linking to a Keycloak page: