diff --git a/doc/source/developer-docs/installation-hosts-limited-connectivity.rst b/doc/source/developer-docs/installation-hosts-limited-connectivity.rst
index 3e505bbaee..ad8a38964b 100644
--- a/doc/source/developer-docs/installation-hosts-limited-connectivity.rst
+++ b/doc/source/developer-docs/installation-hosts-limited-connectivity.rst
@@ -98,6 +98,12 @@ HTTP or SOCKS proxy server(s). OpenStack-Ansible may be used to configure
 target hosts to use the proxy server(s). OpenStack-Ansible does not provide
 automation for creating the proxy server(s).
 
+.. note::
+
+   We recommend you set your ``/etc/environment`` variables with proxy
+   settings before launching ``scripts/run-playbooks.sh`` to avoid
+   failure.
+
 Basic proxy configuration
 -------------------------