Skip to main content

Local Deployment

info

These instructions have been tested on MacOS, Windows 10 and Ubuntu 22.04.

Setup & launch Airbyte

  • Install Docker Engine and the Docker Compose plugin on your workstation (see instructions).
  • After Docker is installed, you can immediately get started locally by running:
# clone Airbyte from GitHub
git clone --depth=1 https://github.com/airbytehq/airbyte.git

# switch into Airbyte directory
cd airbyte

# start Airbyte
./run-ab-platform.sh
  • In your browser, visit http://localhost:8000
  • You will be asked for a username and password. By default, that's username airbyte and password password. Once you deploy Airbyte to your servers, be sure to change these in your .env file:
# Proxy Configuration
# Set to empty values, e.g. "" to disable basic auth
BASIC_AUTH_USERNAME=your_new_username_here
BASIC_AUTH_PASSWORD=your_new_password_here
  • Start moving some data!

Deploy on Windows

After installing the WSL 2 backend and Docker you should be able to run containers using Windows PowerShell. Additionally, as we note frequently, you will need docker-compose to build Airbyte from source. The suggested guide already installs docker-compose on Windows.

Setup Guide

1. Check out system requirements from Docker documentation.

Follow the steps on the system requirements, and necessarily, download and install the Linux kernel update package.

2. Install Docker Desktop on Windows.

Install Docker Desktop from here.

Make sure to select the options:

  1. Enable Hyper-V Windows Features
  2. Install required Windows components for WSL 2 when prompted. After installation, it will require to reboot your computer.

3. You're done!

git clone --depth=1 https://github.com/airbytehq/airbyte.git
cd airbyte
bash run-ab-platform.sh
  • In your browser, just visit http://localhost:8000
  • You will be asked for a username and password. By default, that's username airbyte and password password. Once you deploy airbyte to your servers, be sure to change these.
  • Start moving some data!

Troubleshooting

If you have any questions about the local setup and deployment process, head over to our Getting Started FAQ on our Airbyte Forum that answers the following questions and more:

  • How long does it take to set up Airbyte?
  • Where can I see my data once I've run a sync?
  • Can I set a start time for my sync?

If you encounter any issues, check out Getting Support documentation for options how to get in touch with the community or us.