diff --git a/docs/guides/deploy-guide/services/index.md b/docs/guides/deploy-guide/services/index.md
index c3ee4594a1..9f9dec1218 100644
--- a/docs/guides/deploy-guide/services/index.md
+++ b/docs/guides/deploy-guide/services/index.md
@@ -27,3 +27,22 @@ In the examples, the pull of images (if supported by a role) is always run first
 this is optional, it is recommended to speed up the execution of the deploy action in
 the second step. This significantly reduces the time required for the deployment of new
 services.
+
+Before service deployment the network connectivity with the given MTU needs to
+be validated.
+This is done by running
+
+```bash
+osism validate kolla-connectivity
+```
+
+The command will check the connection using ICMP echo request/reply between all
+hosts with the configured MTU and for all configured networks.
+A successful run is a strong indicator that the network configuration is correct.
+When ceph is used also run
+
+```bash
+osism validate ceph-connectivity
+```
+
+to additionally check ceph networks in the same way.