Install on Windows

One-time setup

1. Install Docker Desktop with WSL2, then enable Host networking below.
2. Install Android Platform Tools, unzip to e.g. %LOCALAPPDATA%\Android\Sdk\platform-tools\, and add that folder to your PATH (System Properties → Environment Variables).
3. In BlueStacks: Settings → Advanced → Android Debug Bridge → Enabled.

Docker Desktop — Settings → Resources → Network

1. Open Docker Desktop → Settings.

2. Go to Resources → Network.

3. Tick Enable host networking (beta), then Apply & restart.

The bot container needs this toggle to reach the host’s adb server on 127.0.0.1:5037.

Settings → Resources → Network → Enable host networking

1. Verify the tools

Open PowerShell and confirm Docker (with Compose v2) and adb are ready:

docker compose version   # Compose v2.x
adb version

If adb isn’t found, the platform-tools folder isn’t on your PATH yet — re-check step 2 above and open a new terminal.

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

   start 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

Antivirus flags adb.exe

ADB is a legitimate dev tool but can open root shells, so some scanners flag adb.exe as PUA. Whitelist the Android Platform Tools folder.

Bot can't see the emulator

Check that Host networking is enabled in Docker Desktop and that BlueStacks Android Debug Bridge is on, then:

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

See Troubleshooting for the full list.