budtmo/docker-android

Docker-Android packages an Android emulator inside a Docker container, so you can run a virtual Android phone or tablet on your computer without setting up Android Studio by hand. Docker is a tool that lets you ship and run software in pre-built isolated environments, and this project provides one such environment focused on Android. The README pitches it as useful for developing and testing native, web, and hybrid Android apps. The project publishes a set of Docker images on Docker Hub, one per Android version, ranging from Android 9.0 (API 28) up to Android 14.0 (API 34), plus a separate image that integrates with Genymotion's cloud emulator. Inside each image you can pick from a list of preconfigured device profiles, including Samsung Galaxy S6 through S10, several Nexus phones, the Nexus 7 and Pixel C tablets, with skins taken from Android Studio and the Samsung developer site. The Quick Start section says the host must be running Ubuntu (Windows and macOS users need a virtualisation layer such as a VM or WSL2), and the CPU must support hardware virtualisation, which you can check with kvm-ok from the cpu-checker package. The example docker run command starts a container that exposes port 6080, picks the Samsung Galaxy S10 device, enables the web VNC interface, and passes /dev/kvm through. Once the container is up, you open http://localhost:6080 in a browser to see and interact with the emulator. By default the emulated device is destroyed on restart; mounting a volume at /home/androidusr persists it. The README also includes a WSL2 setup note for hardware acceleration on Windows 11, which requires adding the user to the kvm group and enabling nested virtualisation. The README lists use cases for building Android projects, running UI tests with Appium, controlling the emulator from the host machine, simulating SMS messages, running inside Jenkins, and deploying on Azure, AWS, GCP, or Alibaba Cloud. There is also a sponsor-only Pro version with extra features such as proxy and language configuration, support for newer Android releases, headless mode, Selenium 4 integration, video recording, and root privileges.