* Revert "Revert "Add dependencies to docker-compose (#19257)" (#19306)" This reverts commitb16f28fd4d. * Bump docker-compose version * test * Revert "test" This reverts commitc3b28c9ec3. * Bump docker compose version to 3.8 * test * test * Use a newer docker for platform build * test * Use docker compose v2 * Update docker for frontend e2e * Use docker compose v2 for e2e tests * Update tools to use docker compose v2 * Update more docker compose references to v2 * Update docker compose usage in docs * Update deploying airbyte docs * Fix permission * Case insensistive check * Add extra mention for docker compose in upgrading airbyte * Improve upgrade docker note
2.5 KiB
Local Deployment
:::info These instructions have been tested on MacOS, Windows 10 and Ubuntu 20.04.
:::
Setup & launch Airbyte
- Install Docker on your workstation (see instructions). Make sure you're on the latest version of
docker-compose. - 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
- In your browser, just visit http://localhost:8000
- You will be asked for a username and password. By default, that's username
airbyteand passwordpassword. Once you deploy airbyte to your servers, be sure to change these:
# 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:
- Enable Hyper-V Windows Features
- Install required Windows components for WSL 2
when prompted. After installation, it will require to reboot your computer.
3. You're done!
git clone https://github.com/airbytehq/airbyte.git
cd airbyte
docker compose up
- In your browser, just visit http://localhost:8000
- You will be asked for a username and password. By default, that's username
airbyteand passwordpassword. Once you deploy airbyte to your servers, be sure to change these. - Start moving some data!
Troubleshooting
If you encounter any issues, just connect to our Slack. Our community will help! We also have a troubleshooting section in our docs for common problems.