Tom Dobson
12/10/2025, 4:39 PMkapa.ai
12/10/2025, 4:40 PMairbyte-db-svc.airbyte.svc.cluster.local:5432 refused. Check that the hostname and port are correct and that the postmaster is accepting TCP/IP connections. That means: - The bootloader pod is starting correctly. - It cannot open a TCP connection to the database service hostname/port. - Either the DB pod/service is not up, or the chart’s DB configuration is broken. For Airbyte 2.0.x there was a known problem with the 2.0.0 / 2.0.1 Helm charts. Those chart versions were removed from the repo and are no longer deployable; instead, you must use a 1.x chart version to deploy Airbyte 2.0.1. [[Multiple issues](https://github.com/airbytehq/airbyte/issues/68134); [Chart error](https://github.com/airbytehq/airbyte/issues/68136)] Specifically: - The v2 charts 2.0.0 and 2.0.1 were deleted from the Helm repo and Artifact Hub and should not be used.[[Chart error](https://github.com/airbytehq/airbyte/issues/68136)] - To deploy Airbyte 2.0.1, you should deploy Helm chart v1.9.1 from the v1 Helm repo.[[Chart error](https://github.com/airbytehq/airbyte/issues/68136)] Also, note that the v2 Helm charts live in a different Helm repo than v1: bash # V1 repo helm repo add airbyte <https://airbytehq.github.io/helm-charts> helm repo update # V2 repo helm repo add airbyte-v2 <https://airbytehq.github.io/charts> helm repo update ```[[Add Helm repo](<https://docs.airbyte.com/platform/deploying-airbyte#1-add-the-helm-repository>); [Multiple issues](<https://github.com/airbytehq/airbyte/issues/68134>)] ### What to do 1. **Stop using Helm chart v2.0.19 for 2.0.1**; instead: 2. Add/update the **v1** Helm repo: ```bash helm repo add airbyte <https://airbytehq.github.io/helm-charts> helm repo update 3. Install / upgrade using chart airbyte/airbyte version 1.9.1, which is the supported chart for Airbyte 2.0.1 (per the GitHub issue): bash helm upgrade --install airbyte airbyte/airbyte \ --version 1.9.1 \ --namespace airbyte \ --create-namespace \ -f your-values.yaml 4. After redeploying with chart 1.9.1, check that the Postgres pod and service are up: bash kubectl get pods,svc -n airbyte If, after switching to chart 1.9.1, the DB is still not coming up, the knowledge sources don’t provide further detail on additional DB-specific misconfigurations; at that point you’d need to inspect the Postgres pod logs and your custom values, but that’s beyond what’s covered in the provided docs/issues.Tom Dobson
12/10/2025, 4:45 PMkapa.ai
12/10/2025, 4:45 PMkapa.ai
12/10/2025, 4:46 PMyaml spec: url: <https://airbytehq.github.io/charts> That is the documented v2 repo (airbyte-v2), distinct from the v1 repo (airbyte).[[Add repo](https://docs.airbyte.com/platform/deploying-airbyte#1-add-the-helm-repository)] However, in this repo, the chart is conventionally referenced as airbyte-v2/airbyte when installing via helm.[[Install v2](https://docs.airbyte.com/platform/deploying-airbyte/chart-v2-community#deploy-airbyte); [Next install](https://docs.airbyte.com/platform/next/deploying-airbyte/chart-v2-community#deploy-airbyte)] Flux’s HelmRelease uses the repository URL + chart: airbyte, which is fine as long as the chart actually exists there under that name—which it does according to the docs—so this part is probably okay and consistent with the “airbyte-v2/airbyte” chart in that repo. ### 2. Version compatibility: chart vs. app The crucial mismatch is: yaml version: 2.0.19 # Helm chart ... global.image.tag: 2.0.1 # Airbyte app The v2 docs stress that Helm chart versions and Airbyte platform versions do not match and that each chart is designed for a specific Airbyte app version (shown as APP VERSION). You must choose the chart version first, based on the APP VERSION column of helm search repo airbyte-v2 --versions, and then deploy that chart version; the chart itself pulls the correct Airbyte image version.[[Chart v2 mapping](https://docs.airbyte.com/platform/deploying-airbyte/chart-v2-community#deploy-airbyte); [Next chart v2 mapping](https://docs.airbyte.com/platform/next/deploying-airbyte/chart-v2-community#deploy-airbyte); [Enterprise chart v2](https://docs.airbyte.com/platform/enterprise-setup/chart-v2-enterprise#deploy-airbyte)] The docs show (for example): text NAME CHART VERSION APP VERSION airbyte-v2/airbyte 2.0.18 2.0.0 airbyte-v2/airbyte 2.0.17 1.8.5 ... airbyte-v2/airbyte 2.0.1 1.6.1 airbyte-v2/airbyte 2.0.0 1.6.0 ```[[Chart v2 mapping](<https://docs.airbyte.com/platform/deploying-airbyte/chart-v2-community#deploy-airbyte>)] So: - To run **Airbyte 2.0.0**, you use **chart `2.0.18`**. - To run **Airbyte 1.8.5**, you use **chart `2.0.17`**. The knowledge sources you provided **do not list a chart 2.0.19** at all, so there is no documented mapping from chart `2.0.19` to a particular Airbyte APP VERSION. I cannot find any official confirmation that chart `2.0.19` is intended for Airbyte `2.0.1` or any guidance to override the image tag the way you’re doing. The maintainers explicitly warn that for Helm v2 you must: - Look up the chart/App mapping with `helm search repo airbyte-v2 --versions`. - Deploy using the **Helm chart version**, *not* by trying to force a different platform version.[[Multiple issues](<https://github.com/airbytehq/airbyte/issues/68134>)] This makes your combo (chart 2.0.19 + image tag 2.0.1) unsupported per the docs, and it’s a plausible root cause for DB-related failures. ### 3. Known 2.0.x chart issues For v1 charts and 2.0.x platform, maintainers removed chart versions `2.0.0` and `2.0.1` from the **v1** repo because they were problematic and clarified that you must deploy 2.0.1 using `v1.9.1` instead.[[Chart error](<https://github.com/airbytehq/airbyte/issues/68136>)] Separately, they emphasise: > Helm chart V2 and Airbyte version 2.0 aren’t the same thing. You can still use your old Helm chart V1 with Airbyte 2.0, or Helm Chart V2 with Airbyte 1.x. If you are ready to migrate to Helm chart V2, you can, but it’s not obligatory until Airbyte 2.1.[[Multiple issues](<https://github.com/airbytehq/airbyte/issues/68134>)] So for **Airbyte 2.0.1**, the documented safe path is: - Use **v1 Helm chart** with a supported version (e.g. `1.9.1`) to run 2.0.1.[[Chart error](<https://github.com/airbytehq/airbyte/issues/68136>)] - Or, if using v2 charts, pick a chart version whose `APP VERSION` matches a supported 1.x or 2.0.0 per the mapping in the docs; there is no official statement in these sources that 2.0.19 is meant for 2.0.1. ### 4. Why this could manifest as DB connection failures Your logs (from the previous message) show the bootloader cannot reach `airbyte-db-svc.airbyte.svc.cluster.local:5432`. The provided sources do not give a line‑by‑line mapping of all `values.yaml` keys for v2.0.19, but they do say that v2 Helm charts are significantly different and require careful migration of values.[[Multiple issues](<https://github.com/airbytehq/airbyte/issues/68134>)] Running an **undocumented chart version** (`2.0.19`) together with a **manually forcibly-set image tag** (`2.0.1`) means: - You have no guarantee that the DB service / statefulset / env vars / probes in chart 2.0.19 match what the 2.0.1 image expects. - If the chart’s built‑in Postgres config changed (e.g., service name, port, timing, init containers), the bootloader could fail to connect exactly as you’re seeing. Because the docs you shared don’t include 2.0.19 or its `values`, I can’t definitively point to a specific mis‑keyed value in your snippet. But the **version mismatch itself is already outside the documented, supported matrix** and is a sufficient explanation for “mysterious” bootloader/DB failures. ### 5. Concrete next steps (within what the docs support) Within the constraints of the knowledge you provided, the safest options are: 1. **If you must stay on Airbyte 2.0.1:** Use *v1* Helm chart `1.9.1` from the `<https://airbytehq.github.io/helm-charts>` repo, as the maintainers explicitly recommend for 2.0.1.[[Chart error](<https://github.com/airbytehq/airbyte/issues/68136>)] 2. **If you want to use Helm chart v2:** - List v2 charts and their `APP VERSION` with: ```bash helm search repo airbyte-v2 --versions [[Chart v2 mapping](https://docs.airbyte.com/platform/deploying-airbyte/chart-v2-community#deploy-airbyte)] - Pick the chart version whose APP VERSION is officially the one you want (e.g. chart 2.0.18 → app 2.0.0). - Let the chart manage the Airbyte image tag instead of overriding global.image.tag to 2.0.1. Given the docs and issues you shared, I can’t confirm that 2.0.19 is a valid or recommended chart version for 2.0.1, and the maintainers explicitly advise against assuming chart and app versions line up. That’s the main reason your deployment is likely failing.