Rafael Felipe
05/22/2026, 12:50 PMkapa.ai
05/22/2026, 12:50 PMoctavia apply
# or only one file:
octavia apply -f path/to/your/configuration.yaml
Octavia will validate the YAML, show you a diff, and then update the resource on your running Airbyte instance. [Version control configs]
2. If you changed a Helm values.yaml (self‑managed / Kubernetes) If the YAML is your Helm values.yaml for the deployment, you re‑apply it with `helm upgrade`:
helm upgrade airbyte-enterprise airbyte/airbyte \
--namespace airbyte \
--values ./values.yaml \
--version 2.x.x
(or similar helm upgrade -i command, depending on your setup). [Entra redeploy; Okta deploy]
This updates the running deployment; it is not a full reinstall.
If your YAML is something else (e.g., not Octavia configs or Helm values), the knowledge sources don’t describe how to apply it, so I can’t give a precise command. 👍 0 button 👎 0 button ℹ️ Tip: Mention @kapa.ai in the thread for follow-ups or DM the app for 1-to-1 help.Rafael Felipe
05/22/2026, 12:51 PMkapa.ai
05/22/2026, 12:51 PMabctl, you don’t “apply” a YAML file directly; you pass it again to abctl local install. That command is used both for first install and for updating an existing local instance.
If you changed your Helm values.yaml or secret file, run the same command you used originally, for example:
abctl local install --values ./values.yaml --secret ./secrets.yaml
This will update the existing Airbyte installation with your new YAML configuration; it does not wipe data by default. [Install/manage local]
If you need to pin a specific chart version while updating:
abctl local install \
--chart-version 0.422.2 \
--values ./values.yaml \
--secret ./secrets.yaml [[Install/manage local](https://docs.airbyte.com/platform/deploying-airbyte/abctl#install-and-manage-local-airbyte-instances)]``` 👍 0 button 👎 0 button ℹ️ Tip: Mention @kapa.ai in the thread for follow-ups or DM the app for 1-to-1 help.Rafael Felipe
05/22/2026, 12:54 PMkapa.ai
05/22/2026, 12:54 PMabctl local install issue caused by filesystem permissions on the Postgres data directory. abctl tries to read PG_VERSION, but the pgdata directory is owned by UID/GID 70 with 0700 permissions, so your user can’t access it. [abctl pgdata issue]
You have a few options:
1. Fix permissions (keep existing data) Run:
sudo chmod 755 ~/.airbyte/abctl/data/airbyte-volume-db/pgdata
Then re-run:
abctl local install
This lets abctl read PG_VERSION while keeping the existing database contents. [abctl pgdata issue]
2. Remove the DB volume (reset data) If you don’t need to preserve any previous Airbyte data:
rm -rf ~/.airbyte/abctl/data/airbyte-volume-db
abctl local install
This deletes the old Postgres data and lets abctl recreate it cleanly. [abctl pgdata issue]
If you still hit permission problems on the broader ~/.airbyte/abctl directory, some users resolved similar issues by relaxing permissions there (for example, chmod -R), but the knowledge sources don’t give a precise, recommended pattern beyond the commands above. [Uninstall permissions] 👍 0 button 👎 0 button ℹ️ Tip: Mention @kapa.ai in the thread for follow-ups or DM the app for 1-to-1 help.Rafael Felipe
05/22/2026, 5:10 PMkapa.ai
05/22/2026, 5:10 PMabctl local install --values ~/.airbyte/values.yaml is the correct way to re‑apply config changes when you’re using `abctl`; it always runs an “install”, even when updating an existing cluster. This is expected behavior and is how you apply YAML changes without doing a manual uninstall. [Install/manage local]
A few points based on your log:
• It correctly detects the existing Kind cluster and volumes and then starts a Helm chart installation of airbyte/airbyte 2.1.0 — that’s the update step.
• The “Installing … (this may take several minutes)” phase can take quite a while depending on image pulls and cluster resources; docs mention up to ~30 minutes. [Install/manage local]
• As long as it doesn’t error out, you can just let it run.
If it seems stuck for a long time (e.g., >30–40 minutes) or eventually fails, the GitHub issues suggest:
1. Check pod status in the airbyte-abctl namespace:kubectl get pods -n airbyte-abctl --kubeconfig ~/.airbyte/abctl/abctl.kubeconfigLook for pods in Pending, ImagePullBackOff, or CrashLoopBackOff. [Bootloader hang; Image pull issues]
2. If the bootloader pod is the one hanging/failing, inspect its logs:kubectl logs airbyte-abctl-airbyte-bootloader -n airbyte-abctl --kubeconfig ~/.airbyte/abctl/abctl.kubeconfig(Pod name may differ slightly; use kubectl get pods output.) [Bootloader hang; Bootloader failed]
3. If it fails, you can safely retry:abctl local uninstall
abctl local install --values ~/.airbyte/values.yamlSeveral users report that uninstall + reinstall resolves transient install issues. [abctl stuck; [abctl deploy issues]
If you share the final outcome (success vs. specific error) or any failing pod state/logs, I can narrow down the next step using the relevant issues. 👍 0 button 👎 0 button ℹ️ Tip: Mention @kapa.ai in the thread for follow-ups or DM the app for 1-to-1 help.Rafael Felipe
05/22/2026, 5:22 PMkapa.ai
05/22/2026, 5:22 PMairbyte/airbyte v2.1.0 installed
• ✅ NGINX ingress updated with your new values
• ⚠️ Browser launch failed — this is expected on a headless/server environment with no GUI browser installed; it's just a warning, not an error
Access Airbyte Open your browser and go to: http//localhost8000
To get your login credentials, run:
abctl local credentials
This returns your email, password, client-id, and client-secret. [abctl credentials]
Optional: Suppress the browser warning next time Since you're on a headless machine, add --no-browser to avoid the warning:
abctl local install --values ~/.airbyte/values.yaml --no-browser
[abctl reference]
Recommended: Update abctl The log also suggests updating abctl from v0.30.3 to v0.30.4:
brew upgrade abctl
or via curl if you installed that way:
curl -LsfS https://get.airbyte.com | bash -
[Install abctl] 👍 0 button 👎 0 button ℹ️ Tip: Mention @kapa.ai in the thread for follow-ups or DM the app for 1-to-1 help.Rafael Felipe
05/22/2026, 6:06 PMkapa.ai
05/22/2026, 6:06 PMimages-tar-* temporary directory (e.g., /tmp/images-tar-151202202) that abctl creates during image loading.
However, based on what the knowledge sources do show, this directory is a temporary image archive that abctl creates during installation to load Docker images into the Kind cluster. For example:
DEBUG saving image archive to /tmp/images-tar-3346902064/images.tar
Once the installation has completed successfully (which yours did ✅), this temp directory is no longer needed. You should be safe to delete it:
rm -rf /tmp/images-tar-151202202
That said, I'd recommend confirming no active abctl process is running before deleting it, just to be safe. 👍 0 button 👎 0 button ℹ️ Tip: Mention @kapa.ai in the thread for follow-ups or DM the app for 1-to-1 help.