Prerequisites
Pick your platform
Section titled “Pick your platform”The exact prerequisites depend on what you’re running. Pick the platform you’ll install on, then jump to the install steps when you’re ready.
macOS Docker Desktop with the Host networking beta toggle enabled.
Linux Docker Engine + Compose v2 — native host networking, no extra toggles.
Windows Docker Desktop + WSL2, Platform Tools on PATH, BlueStacks ADB enabled.
Required software
Section titled “Required software”| Requirement | Version | Notes |
|---|---|---|
| Docker Desktop | latest | Toggle Settings → Resources → Network → Enable host networking (beta). Without this, the bot container can’t talk to the host’s adb. |
| BlueStacks | 5 or newer | Apple-silicon and Intel both supported. |
Android Platform Tools (adb) | latest | brew install --cask android-platform-tools is fine. |
| Requirement | Version | Notes |
|---|---|---|
| Docker Engine + Compose v2 | latest | network_mode: host works out of the box, no extra toggles. |
| BlueStacks | 5 or newer | Or any 720 × 1280 / 320 DPI Android emulator with ADB. |
Android Platform Tools (adb) | latest | Distro package (apt install android-tools-adb / pacman -S android-tools) is fine. |
| Requirement | Version | Notes |
|---|---|---|
| Docker Desktop | latest | Requires WSL2. Toggle Settings → Resources → Network → Enable host networking (beta). |
| BlueStacks | 5 or newer | Settings → Advanced → Android Debug Bridge → Enabled. |
Android Platform Tools (adb) | latest | Unzip to e.g. %LOCALAPPDATA%\Android\Sdk\platform-tools\, then add to PATH (System Properties → Environment Variables). Some AVs flag adb.exe — whitelist the folder. |
Get the compose file
Section titled “Get the compose file”The autopilot bot is distributed as Docker images. You only need docker-compose.prod.yml to run it:
curl -fsSL https://batazor.github.io/autopilot-page/docker-compose.prod.yml -o docker-compose.prod.ymlOr save it manually from the link above.