feat: add dnsConfig and clickhouse.database values; update docs

Author: mozesgaal-seon

TROUBLESHOOTING.md

@@ -15,9 +15,14 @@ or
 ```
 2025.06.27 09:30:06.335559 [ 47 ] {} <Error> DynamicQueryHandler: Code: 194. DB::Exception: default: Authentication failed: password is incorrect, or there is no user with such name.
 ```
+or
+```
+error: failed to open database: driver: bad connection
+Applying clickhouse migrations failed. This is mostly caused by the database being unavailable.
+```
 it is often due to a ClickHouse password that contains special characters.
 
-Known bad characters include (but are not limited to): `%, @, :`
+Known bad characters include (but are not limited to): `%, @, :, &, #, ?, $`
 
 ## Data randomly disappears within the Langfuse UI
 

charts/langfuse/templates/_helpers.tpl

@@ -404,6 +404,10 @@ Return ClickHouse protocol (http or https)
 - name: CLICKHOUSE_URL
   value: "{{ include "langfuse.clickhouse.protocol" . }}://{{ include "langfuse.clickhouse.hostname" . }}:{{ .Values.clickhouse.httpPort }}"
 {{- end }}
+{{- if or (hasKey .Values.clickhouse "database") .Values.clickhouse.deploy }}
+- name: CLICKHOUSE_DB
+  value: {{ .Values.clickhouse.database | quote }}
+{{- end }}
 {{- if or .Values.clickhouse.auth.username .Values.clickhouse.deploy }}
 - name: CLICKHOUSE_USER
   {{- if .Values.clickhouse.deploy }}

charts/langfuse/templates/web/deployment.yaml

@@ -129,3 +129,7 @@ spec:
       topologySpreadConstraints:
         {{- toYaml . | nindent 8 }}
       {{- end }}
+      {{- with .Values.langfuse.dnsConfig }}
+      dnsConfig:
+        {{- toYaml . | nindent 8 }}
+      {{- end }}

charts/langfuse/templates/worker/deployment.yaml

@@ -112,3 +112,7 @@ spec:
       topologySpreadConstraints:
         {{- toYaml . | nindent 8 }}
       {{- end }}
+      {{- with .Values.langfuse.dnsConfig }}
+      dnsConfig:
+        {{- toYaml . | nindent 8 }}
+      {{- end }}

charts/langfuse/values.yaml

@@ -117,6 +117,8 @@ langfuse:
   tolerations: []
   # -- Affinity for all langfuse deployments
   affinity: {}
+  # -- DNS configuration for all langfuse deployments
+  dnsConfig: {}
   pod:
     # -- Annotations for all langfuse pods
     annotations: {}
@@ -509,6 +511,8 @@ clickhouse:
   httpPort: 8123
   # -- ClickHouse native port to connect to.
   nativePort: 9000
+  # -- ClickHouse database to use.
+  database: default
 
   image:
     # -- Overwrite default repository of helm chart to point to non-paid bitnami images.