Install on Windows

On Windows you don’t type any commands. A small installer — install.bat — downloads the compose file and starts the whole stack on a double-click. The only manual work is two one-time GUI toggles a script can’t safely flip for you.

One-time setup — two toggles

1. Install Docker Desktop (it requires WSL2), then enable Host networking below.
2. In BlueStacks: Settings → Advanced → Android Debug Bridge → Enabled.

That’s the whole list — you don’t install adb or any Android tools on Windows. The bot container ships its own copy and connects to BlueStacks for you.

Docker Desktop — Settings → Resources → Network

1. Open Docker Desktop → Settings.

2. Go to Resources → Network.

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

With host networking on, the containers share Windows’ loopback — the bot starts its own adb bridge there and reaches BlueStacks, so there’s nothing for you to install or start by hand.

Settings → Resources → Network → Enable host networking

Install

⬇ Download install.bat The one-click Windows installer. It checks Docker, downloads docker-compose, starts the bot, and opens the dashboard — re-run it any time to update. If your browser shows it as text, right-click → Save link as…

Then:

1. Set the emulator profile in BlueStacks — 720 × 1280 @ 320 DPI, game language English. See Emulator setup; the dashboard warns you if the resolution or DPI is off, so you don’t have to check it by hand.

2. Double-click the downloaded install.bat. A console window opens and the script:

   • checks that Docker Desktop is installed and running,
   • downloads docker-compose.prod.yml into %USERPROFILE%\autopilot,
   • pulls the images from the GitLab Container Registry mirror (registry.gitlab.com/batazor/autopilot) and starts redis + bot + api + web,
   • opens the dashboard for you.

3. When it finishes, the dashboard is at http://127.0.0.1:3000/overview. Go to Devices (ADB) — your BlueStacks emulator shows up ready to add.

“Windows protected your PC”

Because the installer is downloaded from the web, SmartScreen may show a blue warning the first time. Click More info → Run anyway. install.bat is plain text — open it in Notepad first if you’d like to read exactly what it runs.

First start

The bot service starts automatically — no activation step is needed. The first up pulls a few hundred MB of images, so it can take a couple of minutes.

Updating

To update to the latest release, just run install.bat again. It re-downloads the compose file and pulls the newer images (--pull always) before recreating the containers — your accounts and state in the Docker volumes are kept. See Updating if a container gets stuck on the old version.

Troubleshooting

Bot can't see the emulator

Make sure Host networking is enabled in Docker Desktop and BlueStacks’ Android Debug Bridge is turned on. Then open the dashboard’s Devices (ADB) page and press Rescan — it re-discovers and connects to BlueStacks for you. If it still doesn’t show up, restart BlueStacks and re-run install.bat.

See Troubleshooting for the full list.