feat: [#415] add GF_SERVER_ROOT_URL to Grafana service in generated docker-compose

Author: josecelano

src/application/services/rendering/docker_compose.rs

@@ -318,9 +318,18 @@ impl DockerComposeTemplateRenderingService {
     /// Apply Grafana credentials to environment context if Grafana is configured
     fn apply_grafana_env_context(env_context: EnvContext, user_inputs: &UserInputs) -> EnvContext {
         if let Some(grafana_config) = user_inputs.grafana() {
+            let server_root_url = grafana_config.domain().map(|domain| {
+                let scheme = if grafana_config.use_tls_proxy() {
+                    "https"
+                } else {
+                    "http"
+                };
+                format!("{scheme}://{}", domain.as_str())
+            });
             env_context.with_grafana(
                 grafana_config.admin_user().to_string(),
                 grafana_config.admin_password().expose_secret().to_string(),
+                server_root_url,
             )
         } else {
             env_context

src/infrastructure/templating/docker_compose/template/wrappers/docker_compose/context/grafana.rs

@@ -23,6 +23,14 @@ pub struct GrafanaServiceContext {
     /// Flattened for template compatibility - serializes ports/networks at top level.
     #[serde(flatten)]
     pub topology: ServiceTopology,
+
+    /// Server root URL for public dashboard share links (optional)
+    ///
+    /// When set, this is injected as `GF_SERVER_ROOT_URL` env var so that
+    /// Grafana generates correct absolute URLs for shared dashboards.
+    /// Derived from the configured domain and TLS setting.
+    #[serde(skip_serializing_if = "Option::is_none")]
+    pub server_root_url: Option<String>,
 }
 
 impl GrafanaServiceContext {
@@ -43,8 +51,17 @@ impl GrafanaServiceContext {
             .iter()
             .map(PortDefinition::from)
             .collect();
+        let server_root_url = config.domain().map(|domain| {
+            let scheme = if config.use_tls_proxy() {
+                "https"
+            } else {
+                "http"
+            };
+            format!("{scheme}://{}", domain.as_str())
+        });
         Self {
             topology: ServiceTopology::new(ports, networks),
+            server_root_url,
         }
     }
 

src/infrastructure/templating/docker_compose/template/wrappers/env/context.rs

@@ -49,6 +49,12 @@ pub struct GrafanaServiceConfig {
     pub admin_user: String,
     /// Grafana admin password (exposed from secrecy wrapper)
     pub admin_password: String,
+    /// Grafana server root URL for correct public dashboard share links (optional)
+    ///
+    /// Derived from the configured domain and TLS setting.
+    /// Maps to the `GF_SERVER_ROOT_URL` environment variable.
+    #[serde(skip_serializing_if = "Option::is_none")]
+    pub server_root_url: Option<String>,
 }
 
 /// Context for rendering the .env template
@@ -186,11 +192,19 @@ impl EnvContext {
     ///
     /// * `admin_user` - Grafana admin username
     /// * `admin_password` - Grafana admin password (plain String, already exposed)
+    /// * `server_root_url` - Optional full URL (e.g. `https://grafana.example.com`) for
+    ///   public dashboard share links; derived from domain + TLS setting
     #[must_use]
-    pub fn with_grafana(mut self, admin_user: String, admin_password: String) -> Self {
+    pub fn with_grafana(
+        mut self,
+        admin_user: String,
+        admin_password: String,
+        server_root_url: Option<String>,
+    ) -> Self {
         self.grafana = Some(GrafanaServiceConfig {
             admin_user,
             admin_password,
+            server_root_url,
         });
         self
     }

templates/docker-compose/.env.tera

@@ -55,4 +55,8 @@ MYSQL_PASSWORD='{{ mysql.password }}'
 # WARNING: Change default credentials in production deployments for security
 GF_SECURITY_ADMIN_USER='{{ grafana.admin_user }}'
 GF_SECURITY_ADMIN_PASSWORD='{{ grafana.admin_password }}'
+{%- if grafana.server_root_url %}
+# Grafana server root URL — used to generate correct public dashboard share links
+GF_SERVER_ROOT_URL='{{ grafana.server_root_url }}'
+{%- endif %}
 {%- endif %}

templates/docker-compose/docker-compose.yml.tera

@@ -173,6 +173,9 @@ services:
     environment:
       - GF_SECURITY_ADMIN_USER=${GF_SECURITY_ADMIN_USER}
       - GF_SECURITY_ADMIN_PASSWORD=${GF_SECURITY_ADMIN_PASSWORD}
+{%- if grafana.server_root_url %}
+      - GF_SERVER_ROOT_URL=${GF_SERVER_ROOT_URL}
+{%- endif %}
     volumes:
       - ./storage/grafana/data:/var/lib/grafana
       - ./storage/grafana/provisioning:/etc/grafana/provisioning:ro