c6b8279386
* 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
66 lines
2.5 KiB
Markdown
66 lines
2.5 KiB
Markdown
# 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](https://www.docker.com/products/docker-desktop)\). Make sure you're on the latest version of `docker-compose`.
|
|
- After Docker is installed, you can immediately get started locally by running:
|
|
|
|
```bash
|
|
git clone https://github.com/airbytehq/airbyte.git
|
|
cd airbyte
|
|
docker compose up
|
|
```
|
|
|
|
- In your browser, just visit [http://localhost:8000](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](/operator-guides/security):
|
|
|
|
```yaml
|
|
# 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](https://docs.docker.com/desktop/windows/install/).**
|
|
|
|
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](https://docs.docker.com/desktop/windows/install/) 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!**
|
|
|
|
```bash
|
|
git clone https://github.com/airbytehq/airbyte.git
|
|
cd airbyte
|
|
docker compose up
|
|
```
|
|
|
|
- In your browser, just visit [http://localhost:8000](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](/operator-guides/security).
|
|
- Start moving some data!
|
|
|
|
## Troubleshooting
|
|
|
|
If you encounter any issues, just connect to our [Slack](https://slack.airbyte.io). Our community will help! We also have a [troubleshooting](../troubleshooting/on-deploying.md) section in our docs for common problems.
|