Skip to main content

Troubleshooting & FAQ

Welcome to the Airbyte troubleshooting guide! Like any platform, you may experience issues when using Airbyte. This guide is designed to help you diagnose and resolve any problems you may encounter while using Airbyte. By following the troubleshooting steps outlined in this guide, you can quickly and effectively identify the root cause of the issue and take steps to resolve it. We recommend checking this guide whenever you encounter an issue with Airbyte to help ensure a smooth and uninterrupted experience with our platform. Let's dive in!

Step 1: Check the logs. The logs provide detailed information about what's happening behind the scenes, and they can help pinpoint the root cause of the problem.

Step 2: Check the documentation. Our documentation covers a wide range of topics, including common issues and their solutions, troubleshooting tips, and best practices.

Step 3: Reach out to the community. Our community forum is a great place to ask for help, share your experiences, and learn from others who have faced similar issues.

Step 4: Open a Github ticket. If you're still unable to resolve the issue after reaching out to the community, it's time to open a support ticket. Our support team is here to help you with any issues you're facing with Airbyte.

Airbyte is an open source project with a vibrant community that fosters collaboration and mutual support. To ensure accessible troubleshooting guidance, Airbyte offers multiple platforms for users to ask and discuss issues, including the Airbyte Github, Airbyte Community Slack (which is over 10,000 users), and the Airbyte Forum. In addition, Airbyte hosts daily office hours that include topic demonstrations and dedicated space for issue discussion in Zoom meetings. In addition to these community resources, Airbyte also offers premium support packages for users who require additional assistance beyond what is provided by the community.

OSS Premium Support

Open source premium support packages are a great option for who use Airbyte OSS and need additional assistance beyond what is provided by the community. These packages typically include access to a dedicated support team that can provide assistance with installation, configuration, troubleshooting, and other technical issues. Premium support packages also often include faster response times, guaranteed issue resolution, and access to updates and patches. By opting for a premium support package, users can enjoy the benefits of open source software while also receiving the peace of mind they need to keep their systems running smoothly.

Premier Support comes with:

  • 1-business-day SLA for your Severity 0 and 1
  • 2-business-day SLA for your Severity 2 and 3
  • 1-week Pull Request review SLA for first comment If you need better SLA times, we can definitely discuss this, don't hesitate to talk to our team about it. You can also see more details about it in our pricing page.

Office Hour

Airbyte provides a Daily Office Hour to discuss issues. It is a 45 minute meeting, the first 20 minutes are reserved to a weekly topic presentation about Airbyte concepts and the others 25 minutes are for general questions. The schedule is:

  • Monday, Wednesday and Fridays: 1 PM PST/PDT
  • Tuesday and Thursday: 4 PM CEST

Github Issues

Whenever you face an issue using a connector or with the platform you're welcome to report opening a Github issue.

Airbyte Slack

You can access Airbyte Slack here.

Before posting on a channel this please first check if a similar question was already answered.

The existing categories:

  • #help-connections-issues: for any questions or issues on your connections
  • #help-infrastructure-deployment: for any questions or issues on your deployment and infrastructure
  • #help-connector-development: for any questions about on the CDKs and issues while building a custom connector
  • #help-api-cli-orchestration: for any questions or issues about the API, CLI, any scheduling effort.
  • #help-contributions: for any questions about contributing to Airbyte’s codebase

Airbyte Forum

We are driving our community support from our forum.

Before posting on this forum please first check if a similar question was already answered.

The existing categories:

  • 🙏 Questions: Ask the community for help on your question. As a reminder, the Airbyte team won’t provide help here, as our support is part of our Airbyte Cloud and Airbyte Enterprise offers.
  • 💡 Ideas: Share ideas for new features, improvements, or feedback.
  • 🙌 Show & Tell: Share projects, tutorials, videos, and articles you are working on.
  • 🫶 Kind words: Show off something you love about Airbyte
  • 🐙 General: For anything that doesn’t fit in the above categories