Install on macOS

One-time setup — Host networking

The bot container reaches the host’s adb server through host networking. Turn it on once in Docker Desktop — without it the bot can’t see the emulator on 127.0.0.1:5037.

Show me where to click — Settings → Resources → Network

1. Open Settings — the ⚙️ gear icon in Docker Desktop’s top bar.

2. Go to Resources → Network.

3. Tick Enable host networking, then Apply & restart.

Settings → Resources → Network → Enable host networking

1. Install Docker Desktop + ADB

You need Docker Desktop (ships with Compose v2) and adb on your PATH.

Homebrew

brew install --cask docker                       # Docker Desktop
brew install --cask android-platform-tools       # adb

Launch Docker Desktop once so the engine starts, then enable Host networking (note above).

Manual

1. Download Docker Desktop for Mac (pick the Apple silicon or Intel build for your Mac) and install it.
2. Download Android Platform Tools, unzip, and add the platform-tools folder to your PATH.

Verify both are ready:

docker compose version   # Compose v2.x
adb version

2. Run the stack

1. Fetch the compose file

   curl -fsSL https://batazor.github.io/autopilot-page/docker-compose.prod.yml -o docker-compose.prod.yml

2. Start ADB and confirm BlueStacks is visible

   adb start-server
   adb devices        # BlueStacks should be listed as "device"

3. Verify the display profile — must be 720 × 1280 @ 320 DPI, game language English:

   adb shell wm size
   adb shell wm density

   See Emulator setup for the full list.

4. Pull and start redis + bot + api + web:

   docker compose -f docker-compose.prod.yml up -d --pull always

5. Open the dashboard

   open http://127.0.0.1:3000/overview

First start

The bot service starts automatically — no activation step is needed. Open the dashboard and you’re ready to add a device and your accounts.

Troubleshooting

Bot can't see the emulator

Almost always the Host networking toggle is off. Re-check Docker Desktop → Settings → Resources → Network, Apply & restart, then:

adb kill-server && adb start-server
docker compose -f docker-compose.prod.yml exec bot adb devices

See Troubleshooting for the full list.