From ba94cb8370e47f1a4a1e4ffc107359fe6677827d Mon Sep 17 00:00:00 2001 From: vstempen <147086176+vstempen@users.noreply.github.com> Date: Mon, 7 Oct 2024 15:53:48 -0400 Subject: [PATCH] Documented Docker container OpenSSL abilities being affected by Host network proxy services (#440) * Documented Docker container OpenSSL abilities being affected by host network proxy services, causing network certificates verification problem during Docker container build stage of Grafana server setup. Signed-off-by: Vladimir Stempen * Update docs/install/grafana-setup.rst Co-authored-by: Peter Park Signed-off-by: vstempen <147086176+vstempen@users.noreply.github.com> --------- Signed-off-by: Vladimir Stempen Signed-off-by: vstempen <147086176+vstempen@users.noreply.github.com> Co-authored-by: Peter Park --- docs/install/grafana-setup.rst | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/docs/install/grafana-setup.rst b/docs/install/grafana-setup.rst index a7486d286d..39dca6e888 100644 --- a/docs/install/grafana-setup.rst +++ b/docs/install/grafana-setup.rst @@ -79,6 +79,13 @@ directory to begin. $ sudo docker-compose build $ sudo docker-compose up -d +.. note:: + + To troubleshoot Docker container build failures related to certificate verification, try + disabling any network proxy services on the host system. These proxy services can interfere + with OpenSSL's ability to retrieve a correct certificate chain when the container accesses + external websites. + The TCP ports for Grafana (``4000``) and MongoDB (``27017``) in the Docker container are mapped to ``14000`` and ``27018``, respectively, on the host side.