getlago · IxDay · Jun 16, 2026 · Jun 16, 2026
diff --git a/charts/lago-data-api/README.md b/charts/lago-data-api/README.md
@@ -99,6 +99,7 @@ A Helm chart for Kubernetes
 | nodeSelector | object | `{}` | Node selector constraints |
 | tolerations | list | `[]` | Pod tolerations |
 | affinity | object | `{}` | Pod affinity rules |
+| topologySpreadConstraints | list | `[]` | Pod topology spread constraints |
 
 ### Service
 

diff --git a/charts/lago-data-api/templates/deployment.yaml b/charts/lago-data-api/templates/deployment.yaml
@@ -142,6 +142,10 @@ spec:
       affinity:
         {{- toYaml . | nindent 8 }}
       {{- end }}
+      {{- with .Values.topologySpreadConstraints }}
+      topologySpreadConstraints:
+        {{- toYaml . | nindent 8 }}
+      {{- end }}
       {{- with .Values.tolerations }}
       tolerations:
         {{- toYaml . | nindent 8 }}

diff --git a/charts/lago-data-api/values.yaml b/charts/lago-data-api/values.yaml
@@ -254,6 +254,10 @@ tolerations: []
 # @section -- Pod
 affinity: {}
 
+# -- Pod topology spread constraints
+# @section -- Pod
+topologySpreadConstraints: []
+
 # -- Array of extra K8s manifests to deploy
 # @section -- Extra Objects
 extraObjects: []
diff --git a/charts/lago-data-worker/README.md b/charts/lago-data-worker/README.md
@@ -117,6 +117,7 @@ A Helm chart for Kubernetes
 | nodeSelector | object | `{}` | Node selector constraints |
 | tolerations | list | `[]` | Pod tolerations |
 | affinity | object | `{}` | Pod affinity rules |
+| topologySpreadConstraints | list | `[]` | Pod topology spread constraints |
 
 ### Autoscaling
 

diff --git a/charts/lago-data-worker/templates/deployment.yaml b/charts/lago-data-worker/templates/deployment.yaml
@@ -132,6 +132,10 @@ spec:
       affinity:
         {{- toYaml . | nindent 8 }}
       {{- end }}
+      {{- with .Values.topologySpreadConstraints }}
+      topologySpreadConstraints:
+        {{- toYaml . | nindent 8 }}
+      {{- end }}
       {{- with .Values.tolerations }}
       tolerations:
         {{- toYaml . | nindent 8 }}

diff --git a/charts/lago-data-worker/values.yaml b/charts/lago-data-worker/values.yaml
@@ -206,3 +206,7 @@ tolerations: []
 # -- Pod affinity rules
 # @section -- Pod
 affinity: {}
+
+# -- Pod topology spread constraints
+# @section -- Pod
+topologySpreadConstraints: []
diff --git a/charts/lago-events-processor-worker/README.md b/charts/lago-events-processor-worker/README.md
@@ -77,6 +77,7 @@ A Helm chart for Kubernetes
 | nodeSelector | object | `{}` | Node selector constraints |
 | tolerations | list | `[]` | Pod tolerations |
 | affinity | object | `{}` | Pod affinity rules |
+| topologySpreadConstraints | list | `[]` | Pod topology spread constraints |
 
 ### Autoscaling
 

diff --git a/charts/lago-events-processor-worker/templates/deployment.yaml b/charts/lago-events-processor-worker/templates/deployment.yaml
@@ -130,6 +130,10 @@ spec:
       affinity:
         {{- toYaml . | nindent 8 }}
       {{- end }}
+      {{- with .Values.topologySpreadConstraints }}
+      topologySpreadConstraints:
+        {{- toYaml . | nindent 8 }}
+      {{- end }}
       {{- with .Values.tolerations }}
       tolerations:
         {{- toYaml . | nindent 8 }}

diff --git a/charts/lago-events-processor-worker/values.yaml b/charts/lago-events-processor-worker/values.yaml
@@ -249,6 +249,10 @@ tolerations: []
 # @section -- Pod
 affinity: {}
 
+# -- Pod topology spread constraints
+# @section -- Pod
+topologySpreadConstraints: []
+
 # -- Array of extra K8s manifests to deploy
 # @section -- Extra Objects
 extraObjects: []
diff --git a/charts/lago-front/README.md b/charts/lago-front/README.md
@@ -105,6 +105,7 @@ A Helm chart for Kubernetes
 | nodeSelector | object | `{}` | Node selector constraints |
 | tolerations | list | `[]` | Pod tolerations |
 | affinity | object | `{}` | Pod affinity rules |
+| topologySpreadConstraints | list | `[]` | Pod topology spread constraints |
 
 ### Service
 

diff --git a/charts/lago-front/templates/deployment.yaml b/charts/lago-front/templates/deployment.yaml
@@ -117,6 +117,10 @@ spec:
       affinity:
         {{- toYaml . | nindent 8 }}
       {{- end }}
+      {{- with .Values.topologySpreadConstraints }}
+      topologySpreadConstraints:
+        {{- toYaml . | nindent 8 }}
+      {{- end }}
       {{- with .Values.tolerations }}
       tolerations:
         {{- toYaml . | nindent 8 }}

diff --git a/charts/lago-front/values.yaml b/charts/lago-front/values.yaml
@@ -260,6 +260,10 @@ tolerations: []
 # @section -- Pod
 affinity: {}
 
+# -- Pod topology spread constraints
+# @section -- Pod
+topologySpreadConstraints: []
+
 # -- Array of extra K8s manifests to deploy
 # @section -- Extra Objects
 extraObjects: []
diff --git a/charts/lago-mcp-server/README.md b/charts/lago-mcp-server/README.md
@@ -82,6 +82,7 @@ A Helm chart for Kubernetes
 | nodeSelector | object | `{}` | Node selector constraints |
 | tolerations | list | `[]` | Pod tolerations |
 | affinity | object | `{}` | Pod affinity rules |
+| topologySpreadConstraints | list | `[]` | Pod topology spread constraints |
 
 ----------------------------------------------
 Autogenerated from chart metadata using [helm-docs v1.14.2](https://github.com/norwoodj/helm-docs/releases/v1.14.2)
diff --git a/charts/lago-mcp-server/templates/deployment.yaml b/charts/lago-mcp-server/templates/deployment.yaml
@@ -100,6 +100,10 @@ spec:
       affinity:
         {{- toYaml . | nindent 8 }}
       {{- end }}
+      {{- with .Values.topologySpreadConstraints }}
+      topologySpreadConstraints:
+        {{- toYaml . | nindent 8 }}
+      {{- end }}
       {{- with .Values.tolerations }}
       tolerations:
         {{- toYaml . | nindent 8 }}

diff --git a/charts/lago-mcp-server/values.yaml b/charts/lago-mcp-server/values.yaml
@@ -142,3 +142,7 @@ tolerations: []
 # -- Pod affinity rules
 # @section -- Pod
 affinity: {}
+
+# -- Pod topology spread constraints
+# @section -- Pod
+topologySpreadConstraints: []
diff --git a/charts/lago-pdf/README.md b/charts/lago-pdf/README.md
@@ -75,6 +75,7 @@ A Helm chart for the Lago PDF stack (Gotenberg + optional Rails worker)
 | gotenberg.nodeSelector | object | `{}` | Node selector constraints |
 | gotenberg.tolerations | list | `[]` | Pod tolerations |
 | gotenberg.affinity | object | `{}` | Pod affinity rules |
+| gotenberg.topologySpreadConstraints | list | `[]` | Pod topology spread constraints |
 | gotenberg.imagePullSecrets | list | `[]` | Image pull secrets for private registries |
 | gotenberg.nameOverride | string | `""` | Override the Gotenberg chart name |
 | gotenberg.fullnameOverride | string | `""` | Override the Gotenberg full release name |

diff --git a/charts/lago-pdf/templates/deployment.yaml b/charts/lago-pdf/templates/deployment.yaml
@@ -94,6 +94,10 @@ spec:
       affinity:
         {{- toYaml . | nindent 8 }}
       {{- end }}
+      {{- with .Values.gotenberg.topologySpreadConstraints }}
+      topologySpreadConstraints:
+        {{- toYaml . | nindent 8 }}
+      {{- end }}
       {{- with .Values.gotenberg.tolerations }}
       tolerations:
         {{- toYaml . | nindent 8 }}

diff --git a/charts/lago-pdf/values.yaml b/charts/lago-pdf/values.yaml
@@ -482,6 +482,10 @@ gotenberg:
   # @section -- Gotenberg
   affinity: {}
 
+  # -- Pod topology spread constraints
+  # @section -- Gotenberg
+  topologySpreadConstraints: []
+
   # -- Image pull secrets for private registries
   # @section -- Gotenberg
   imagePullSecrets: []

diff --git a/charts/lago-rails/README.md b/charts/lago-rails/README.md
@@ -90,6 +90,7 @@ A Helm chart for Kubernetes
 | nodeSelector | object | `{}` | Node selector constraints |
 | tolerations | list | `[]` | Pod tolerations |
 | affinity | object | `{}` | Pod affinity rules |
+| topologySpreadConstraints | list | `[]` | Pod topology spread constraints |
 
 ### Service
 

diff --git a/charts/lago-rails/templates/deployment.yaml b/charts/lago-rails/templates/deployment.yaml
@@ -357,6 +357,10 @@ spec:
       affinity:
         {{- toYaml . | nindent 8 }}
       {{- end }}
+      {{- with .Values.topologySpreadConstraints }}
+      topologySpreadConstraints:
+        {{- toYaml . | nindent 8 }}
+      {{- end }}
       {{- with .Values.tolerations }}
       tolerations:
         {{- toYaml . | nindent 8 }}

diff --git a/charts/lago-rails/values.yaml b/charts/lago-rails/values.yaml
@@ -594,6 +594,10 @@ tolerations: []
 # @section -- Pod
 affinity: {}
 
+# -- Pod topology spread constraints
+# @section -- Pod
+topologySpreadConstraints: []
+
 # -- Array of extra K8s manifests to deploy
 # @section -- Extra Objects
 extraObjects: []
diff --git a/tests-common/deployment/common_patterns_test.yaml b/tests-common/deployment/common_patterns_test.yaml
@@ -109,6 +109,40 @@ tests:
       - notExists:
           path: spec.template.spec.containers[0].resources
 
+  # ============================================================================
+  # topologySpreadConstraints Tests
+  # ============================================================================
+  - it: should include topologySpreadConstraints when specified
+    values:
+      - ./fixtures/required.yaml
+    set:
+      topologySpreadConstraints:
+        - maxSkew: 1
+          topologyKey: kubernetes.io/hostname
+          whenUnsatisfiable: DoNotSchedule
+          labelSelector:
+            matchLabels:
+              app.kubernetes.io/name: test-app
+    asserts:
+      - equal:
+          path: spec.template.spec.topologySpreadConstraints[0].maxSkew
+          value: 1
+      - equal:
+          path: spec.template.spec.topologySpreadConstraints[0].topologyKey
+          value: kubernetes.io/hostname
+      - equal:
+          path: spec.template.spec.topologySpreadConstraints[0].whenUnsatisfiable
+          value: DoNotSchedule
+
+  - it: should not include topologySpreadConstraints when empty
+    values:
+      - ./fixtures/required.yaml
+    set:
+      topologySpreadConstraints: []
+    asserts:
+      - notExists:
+          path: spec.template.spec.topologySpreadConstraints
+
   # ============================================================================
   # Combined Test - All Common Patterns
   # ============================================================================