Skip to content

Latest commit

 

History

History
46 lines (30 loc) · 2.73 KB

local-deployment.md

File metadata and controls

46 lines (30 loc) · 2.73 KB
Raw

Local Deployment

{% hint style="info" %} These instructions have been tested on MacOS, Windows 10 and Ubuntu 20.04. {% endhint %}

Setup & launch Airbyte

  • Install Docker on your workstation (see instructions). Note: There is a known issue with docker-compose 1.27.3. If you are using that version, please upgrade to 1.27.4.
  • After Docker is installed, you can immediately get started locally by running:
git clone https://github.com/airbytehq/airbyte.git
cd airbyte
docker-compose up

Deploy on Windows

We recommend following this guide to install Docker 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.

If you are cloning the repo, you might run into a problem where git indicates that certain Filenames are too long and it therefore can't create the local file. Running the following command in git bash:

git config --system core.longpaths true

and performing a system reboot seems to solve this limitation. However it's worth pointing out that the above setting is defaulted to false for a reason, so use with caution. Find more details on this stack overflow question.

Instead of cloning the repo, you can alternatively download the latest Airbyte release here. Unzip the downloaded file, access the unzipped file using PowerShell terminal, and run docker-compose up. After this, you should see the Airbyte containers in the Docker application as in the image below.

Troubleshooting

I have a Mac with the M1 chip. Is it possible to run Airbyte?

Some users using Macs with an M1 chip are facing some problems running Airbyte. The problem is related with the chip and Docker. Issue #2017 was created to follow up the problem, you can subscribe to it and get updates about the resolution. If you can successfully run Airbyte using a MacBook with the M1 chip, let us know so that we can share the process with the community!

Other issues

If you encounter any issues, just connect to our Slack. Our community will help! We also have a FAQ section in our docs for common problems.