From fc6b8f9c6c69053eb241ca33c33b22f8a001751b Mon Sep 17 00:00:00 2001 From: "Grot (@grafanabot)" <43478413+grafanabot@users.noreply.github.com> Date: Thu, 30 Mar 2023 19:34:10 +0200 Subject: [PATCH] [v9.4.x] Give more detail and context on http_addr in grafana.ini (#65644) Give more detail and context on http_addr in grafana.ini (#65187) * Give more detail and context on http_addr in grafana.ini This particular configuration item is misleadingly named (it's about networking addresses rather than HTTP) and there are a bunch of ways users can misread, misconfigure, and create a situation where grafana won't start due to a bind error. I'm trying to outline a couple of extra things about what this covers and provide good default advice, leaving room for specialists who know what they're doing to still use this, with more clarity. * Update _index.md * Apply suggestions from code review Co-authored-by: Christopher Moyer <35463610+chri2547@users.noreply.github.com> * Update _index.md removed recommendation note about http_addr * makes prettier --------- Co-authored-by: Christopher Moyer <35463610+chri2547@users.noreply.github.com> Co-authored-by: Chris Moyer (cherry picked from commit 765073a7769cbf94eb3252998a4c99eb29796c28) Co-authored-by: David Allen --- docs/sources/setup-grafana/configure-grafana/_index.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/docs/sources/setup-grafana/configure-grafana/_index.md b/docs/sources/setup-grafana/configure-grafana/_index.md index 0047eeb3a1a..acb416b452e 100644 --- a/docs/sources/setup-grafana/configure-grafana/_index.md +++ b/docs/sources/setup-grafana/configure-grafana/_index.md @@ -191,7 +191,9 @@ Folder that contains [provisioning]({{< relref "../../administration/provisionin ### http_addr -The IP address to bind to. If empty will bind to all interfaces +The host for the server to listen on. If your machine has more than one network interface, you can use this setting to expose the Grafana service on only one network interface and not have it available on others, such as the loopback interface. An empty value is equivalent to setting the value to `0.0.0.0`, which means the Grafana service binds to all interfaces. + +In environments where network address translation (NAT) is used, ensure you use the network interface address and not a final public address; otherwise, you might see errors such as `bind: cannot assign requested address` in the logs. ### http_port