From 4a5673362cae196c1ba9728509c6481cbd537f4a Mon Sep 17 00:00:00 2001
From: Leonardo Arena <qcst@bsod.eu>
Date: Mon, 3 Aug 2026 17:03:44 +0200
Subject: [PATCH] feat: add IPv6 dual-stack support

- Add host parameter for binding interface configuration
- Add service.ipFamilyPolicy for dual-stack control
- Add service.ipFamilies array for IP family selection
- All parameters optional for backward compatibility
---
 templates/config.yaml  |  3 +++
 templates/service.yaml |  6 ++++++
 values.yaml            | 15 +++++++++++++++
 3 files changed, 24 insertions(+)

diff --git a/templates/config.yaml b/templates/config.yaml
index ef97b7c..e7c51eb 100644
--- a/templates/config.yaml
+++ b/templates/config.yaml
@@ -6,6 +6,9 @@ data:
     # This is pgdog.toml. You can configure anything here, incl. databases.
     pgdog.toml: |
         [general]
+        {{- if hasKey .Values "host" }}
+        host                      =   {{ .Values.host | quote }}
+        {{- end }}
         {{- if hasKey .Values "port" }}
         port                      =   {{ include "pgdog.intval" .Values.port }}
         {{- end }}
diff --git a/templates/service.yaml b/templates/service.yaml
index eae92af..ca2634a 100644
--- a/templates/service.yaml
+++ b/templates/service.yaml
@@ -41,6 +41,12 @@ spec:
   {{- if .Values.service.internalTrafficPolicy }}
   internalTrafficPolicy: {{ .Values.service.internalTrafficPolicy | quote }}
   {{- end }}
+  {{- if .Values.service.ipFamilyPolicy }}
+  ipFamilyPolicy: {{ .Values.service.ipFamilyPolicy }}
+  {{- end }}
+  {{- if .Values.service.ipFamilies }}
+  ipFamilies: {{- toYaml .Values.service.ipFamilies | nindent 4 }}
+  {{- end }}
   ports:
     - name: pgdog
       protocol: TCP
diff --git a/values.yaml b/values.yaml
index 6614105..c79f598 100644
--- a/values.yaml
+++ b/values.yaml
@@ -54,6 +54,11 @@ image:
   # If set, this takes precedence over repository and tag for backward
   # compatibility
   # name: ghcr.io/pgdogdev/pgdog:main
+# host specifies the network interface IP address to bind to.
+# Default: "0.0.0.0" (IPv4 only)
+# For IPv6 dual-stack support, use "::"
+# Not set by default to maintain backward compatibility.
+# host: "::"
 # port on which PgDog will run.
 port: 6432
 # healthcheckPort on which PgDog will expose healthcheck endpoint
@@ -342,6 +347,16 @@ service:
   # routed (Cluster or Local).
   # see https://kubernetes.io/docs/reference/networking/virtual-ips/#internal-traffic-policy for more details.
   internalTrafficPolicy: ""
+  # ipFamilyPolicy controls IP family behavior for the service.
+  # Valid values: SingleStack, PreferDualStack, RequireDualStack
+  # Leave empty to use cluster defaults.
+  # Ref: https://kubernetes.io/docs/concepts/services-networking/dual-stack/
+  ipFamilyPolicy: ""
+  # ipFamilies specifies which IP families to use for the service.
+  # Example for dual-stack: ["IPv4", "IPv6"]
+  # Leave empty to use cluster defaults.
+  # Note: Order matters - first family is primary.
+  ipFamilies: []
   # aws configures AWS Load Balancer Controller annotations
   # When enabled, service type is automatically set to LoadBalancer
   aws: