Romain Roux
03/24/2026, 8:49 PMkapa.ai
03/24/2026, 8:49 PMabctl as a built-in option.
A GitHub issue (#58636) was filed specifically requesting the ability to prevent abctl from exposing port 8000 on all network interfaces (i.e., 0.0.0.0:8000). The response from an Airbyte contributor was: [abctl port expose issue]
> "I don't think this is a use case for abctl which is a tool for dev-quick deploys. You can probably configure this with a custom values.yaml and helm chart."
The abctl local install command does support a --port flag to change the port number, but there is no documented --bind-address or equivalent flag to restrict the listening address to 127.0.0.1 only. [abctl reference]
The suggested workaround from the issue discussion was to use a custom values.yaml with the Helm chart, though the knowledge sources do not provide specific details on how to configure this to bind only to 127.0.0.1.
If your goal is to secure the deployment, Airbyte's documentation recommends deploying Airbyte behind a reverse proxy (e.g., nginx) to handle SSL and access control, rather than relying on `abctl`'s port binding behavior. [abctl port expose issue]
In summary: no native abctl flag exists to restrict binding to 127.0.0.1 only, and this use case is considered outside the intended scope of abctl. š 0 button š 0 button ā¹ļø Tip: Mention @kapa.ai in the thread for follow-ups or DM the app for 1-to-1 help.Romain Roux
03/24/2026, 8:51 PMkapa.ai
03/24/2026, 8:52 PMserver {
listen 443 ssl;
server_name airbyte.<your-domain>.com;
client_max_body_size 200M; # required for Airbyte API
ssl_certificate <path-to-your-cert>.crt.pem;
ssl_certificate_key <path-to-your-key>.key.pem;
location / {
proxy_pass http://127.0.0.1:8000;
proxy_set_header Cookie $http_cookie; # if you use Airbytes basic auth
proxy_read_timeout 3600; # set a number in seconds suitable for you
}
}
This config proxies traffic from HTTPS (port 443) to Airbyte running on 127.0.0.1:8000, which aligns with your goal of having the reverse proxy on the same VM.
However, as noted in the previous answer, abctl itself does not provide a flag to bind only to 127.0.0.1 ā it exposes on 0.0.0.0:8000 by default. The knowledge sources do not provide a documented method to restrict this at the abctl level. The Airbyte contributor's suggestion was to use a custom values.yaml with the Helm chart for more advanced network configuration, but no specifics are provided in the available documentation. [abctl port expose issue]
For the reverse proxy setup itself (nginx config, Docker networking details, etc.), you would need to consult resources beyond what Airbyte's documentation covers. š 0 button š 0 button ā¹ļø Tip: Mention @kapa.ai in the thread for follow-ups or DM the app for 1-to-1 help.Romain Roux
03/24/2026, 8:53 PMkapa.ai
03/24/2026, 8:53 PMingress:
enabled: true
className: "nginx"
hosts:
- host: airbyte.example.com
paths:
- path: /
pathType: Prefix
backend: server
- path: /connector-builder
pathType: Prefix
backend: connector-builder-server
tls:
- secretName: airbyte-tls
hosts:
- airbyte.example.com
For TLS certificate management, Airbyte's docs recommend tools like cert-manager or your cloud provider's certificate service. [ingress docs] 3. AWS ALB + AWS Certificate Manager If deployed on AWS/EKS, you can use an Application Load Balancer combined with AWS Certificate Manager (ACM) for TLS. [ingress docs] 4. Cloud Provider IAM Proxies ⢠GCP: Use Identity-Aware Proxy
⢠AWS: Use AWS Systems Manager Session Manager
[security docs] Since you're using abctl on a single VM, the reverse proxy approach (option 1) is the most applicable. The Helm-based ingress options (2 & 3) require a Kubernetes cluster setup beyond what abctl is designed for. š 0 button š 0 button ā¹ļø Tip: Mention @kapa.ai in the thread for follow-ups or DM the app for 1-to-1 help.Romain Roux
03/24/2026, 8:54 PMkapa.ai
03/24/2026, 8:55 PMabctl, you can pass a custom values.yaml file using the --values flag:
abctl local install --values values.yaml
You can also combine it with Kubernetes secrets if needed:
abctl local install --secret YOUR_SECRET --values values.yaml
[abctl docs]
This allows you to customize the Airbyte Helm chart installation, including ingress/TLS configuration. However, there is an important caveat noted in a GitHub issue: for abctl specifically, the ingress rules are already wrapped by abctl internally, which means not all ingress-related values can be overridden via values.yaml the same way a pure Helm deployment would allow. [abctl ingress issue]
So while --values gives you some customization ability, the extent to which you can control networking details like TLS or port binding through it may be limited compared to a full Helm chart deployment. š 0 button š 0 button ā¹ļø Tip: Mention @kapa.ai in the thread for follow-ups or DM the app for 1-to-1 help.Romain Roux
03/26/2026, 6:40 PMkapa.ai
03/26/2026, 6:40 PMabctl on the same machine.
What the documentation does describe is that abctl creates a single Kubernetes cluster named airbyte-abctl using kind, and installs Airbyte into it. [abctl docs] There is no mention of multi-instance support or flags to isolate separate instances.
Given this limitation in the available documentation, I cannot confirm whether this is possible or not. For a more definitive answer, I'd suggest checking the Airbyte GitHub repository or the Airbyte community forum. š 0 button š 0 button ā¹ļø Tip: Mention @kapa.ai in the thread for follow-ups or DM the app for 1-to-1 help.Romain Roux
03/26/2026, 6:42 PMkapa.ai
03/26/2026, 6:42 PMkind clusters with abctl or running multiple Airbyte instances on the same machine.
abctl is documented as a tool that creates a single cluster named airbyte-abctl and manages a single local Airbyte instance. [abctl docs] There is no mention of flags or options to create additional named clusters or isolated instances.
For a definitive answer on whether multiple clusters are supported, I'd recommend checking the Airbyte GitHub repository or the Airbyte community forum. š 0 button š 0 button ā¹ļø Tip: Mention @kapa.ai in the thread for follow-ups or DM the app for 1-to-1 help.Romain Roux
05/20/2026, 1:10 PMkapa.ai
05/20/2026, 1:11 PMerrors.http.default error you're seeing, this appears to be a generic HTTP error from the Airbyte UI. The knowledge sources do mention a similar HTTP 409 error related to database access issues in Airbyte itself [HTTP 409 error], but not specifically tied to MSSQL source setup.
Could you share more details from the logs or the full error message? That would help narrow down the root cause. You can also check the Airbyte community forum for more specific guidance. š 0 button š 0 button ā¹ļø Tip: Mention @kapa.ai in the thread for follow-ups or DM the app for 1-to-1 help.Romain Roux
05/20/2026, 1:11 PMRomain Roux
05/20/2026, 1:12 PMkapa.ai
05/20/2026, 1:12 PMapiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
name: airbyte-ingress
namespace: airbyte
annotations:
nginx.ingress.kubernetes.io/proxy-read-timeout: '600'
nginx.ingress.kubernetes.io/proxy-send-timeout: '600'
This solved the issue for several users. [Google Analytics 504 fix]
If Using abctl With abctl, an NGINX ingress is automatically provided and you don't configure it directly. [ingress docs] Some users reported that downgrading to version 1.6.4 resolved networking/504 issues with `abctl`:
abctl local install --chart-version 1.6.4
[abctl 504 issue]
Other Things to Check ⢠If no pod is being scheduled in the background when you run the connection test, the issue may be deeper than just a timeout ā it could be a workload launcher or scheduler problem. [connection test issue]
⢠For MSSQL specifically, also verify that the TCP/IP connection to the host is not blocked by a firewall, as a network-level timeout can also manifest as a 504 in the UI. [MSSQL TCP error] š 0 button š 0 button ā¹ļø Tip: Mention @kapa.ai in the thread for follow-ups or DM the app for 1-to-1 help.Romain Roux
05/20/2026, 1:15 PMkapa.ai
05/20/2026, 1:15 PMabctl without downgrading, since abctl manages the ingress internally and doesn't expose direct ingress annotation configuration through values.yaml. [abctl ingress issue]
However, one workaround that has been reported is to increase the server-side timeouts via a custom values.yaml passed to `abctl`:
server:
httpIdleTimeout: 20m
extraEnv:
- name: READ_TIMEOUT
value: 30m
Then install with:
abctl local install --values values.yaml
[scaling docs]
Additionally, for MSSQL with a very large number of tables (10,000+), you can also add the discover job timeout:
worker:
env:
- name: DISCOVER_JOB_TIMEOUT_MINUTES
value: "60"
[MSSQL 413 issue]
Beyond these server-side settings, the knowledge sources do not document a supported method to override the nginx ingress timeout annotations when using abctl without downgrading or switching to a full Helm deployment. š 0 button š 0 button ā¹ļø Tip: Mention @kapa.ai in the thread for follow-ups or DM the app for 1-to-1 help.Romain Roux
05/20/2026, 2:02 PMkapa.ai
05/20/2026, 2:03 PMabctl, the ingress is managed internally and the documentation does not confirm that ingress annotations can be overridden via values.yaml in the same way as a pure Helm deployment. [abctl ingress issue]
However, for a Helm-based deployment, you can add ingress annotations directly in values.yaml like this:
ingress:
enabled: true
className: "nginx"
annotations:
nginx.ingress.kubernetes.io/proxy-read-timeout: "600"
nginx.ingress.kubernetes.io/proxy-send-timeout: "600"
hosts:
- host: airbyte.example.com
paths:
- path: /
pathType: Prefix
backend: server
- path: /connector-builder
pathType: Prefix
backend: connector-builder-server
tls: []
[ingress docs]
For abctl specifically, a GitHub issue reported that passing ingress configuration via values.yaml did not override the internally managed ingress ā it still defaulted to `abctl`'s own ingress settings. [abctl ingress issue] The knowledge sources do not confirm a supported way to inject ingress annotations through values.yaml when using abctl.
If you need full control over ingress annotations (e.g., for timeout settings), switching to a full Helm deployment would be the recommended path. š 0 button š 0 button ā¹ļø Tip: Mention @kapa.ai in the thread for follow-ups or DM the app for 1-to-1 help.Romain Roux
05/20/2026, 3:17 PMkapa.ai
05/20/2026, 3:17 PMvalues.yaml to abctl with the following settings:
global:
env_vars:
MICRONAUT_SERVER_MAX_REQUEST_SIZE: "104857600" # 100MB
server:
httpIdleTimeout: 20m
extraEnv:
- name: READ_TIMEOUT
value: 30m
worker:
env:
- name: DISCOVER_JOB_TIMEOUT_MINUTES
value: "60"
Then apply it:
abctl local install --values values.yaml
[scaling docs; MSSQL 413 issue]
Additional Note The issue report also shows that adding nginx ingress annotations via values.yaml was attempted:
webapp:
ingress:
annotations:
nginx.ingress.kubernetes.io/proxy-body-size: "50m"
However, as discussed earlier in our conversation, abctl manages the ingress internally, so these annotations may not take effect reliably. [MSSQL 413 issue]
Alternative Workaround If the above doesn't fully resolve the issue, consider filtering the schemas you want to sync. The MSSQL connector allows you to limit which schemas are discovered, which would reduce the size of the catalog returned. This avoids the need to discover all 10,000+ tables at once. [MSSQL 413 issue]
> ā ļø Note: The GitHub issue was closed as stale without a confirmed fix, so results may vary depending on your Airbyte version. š 0 button š 0 button ā¹ļø Tip: Mention @kapa.ai in the thread for follow-ups or DM the app for 1-to-1 help.