diff --git a/contrib/docker/docker-compose.yml b/contrib/docker/docker-compose.yml
index 23b54ed8a79..e883e33d222 100644
--- a/contrib/docker/docker-compose.yml
+++ b/contrib/docker/docker-compose.yml
@@ -1,4 +1,8 @@
 # docker-compose build && docker-compose up
+# If you experience problems with the CKAN container not being
+# able to connect to the DB, then most likely the DB has not
+# started up quickly enough. Just do "docker-compose up ckan"
+# again to retry
 ckan:
   container_name: ckan
   # Note, if you are working on CKAN core, change this to