budtmo /docker-android
Android in docker solution with noVNC supported, video recording, mcp server and AI-agent
★ 16,138⑂ 1,791👁 182⑃ 251● 383▤ 118
+3
Daily
16,138
stars
1,791
forks
182
watchers
251
prs
383
issues
118
releases
README
Docker-Android is a docker image built to be used for everything related to Android. It can be used for Application development and testing (native, web and hybrid-app).
Sponsors
--------
Webshare offers premium residential, ISP, and datacenter proxies at the lowest prices, with HTTP(S) and SOCKS5 support. 80M+ IPs in 195 countries, a 99.97% success rate, and 10 free proxies to start (no card required). Get 20% off your first purchase with code BUDTMO20. Try this now!.
Proxy-Seller gives you reliable proxy infrastructure for any workflow: private residential, mobile (4G/5G/LTE), ISP, and datacenter IPv4/IPv6 proxies, all with HTTP(S) and SOCKS5 support. Tap into 47M+ residential IPs across 220+ locations, target exactly the country, city, or ISP you need, and count on 99.7% uptime backed by 24/7 support. Get 15% off with promo code BUDTMO.
Advantages of using this project
--------------------------------
1. Emulator with different device profile and skins, such as Samsung Galaxy S6, LG Nexus 4, HTC Nexus One and more.
2. Support vnc to be able to see what happen inside docker container
3. Support log sharing feature where all logs can be accessed from web-UI
4. Ability to control emulator from outside container by using adb connect
5. Integrated with other cloud solutions, e.g. Genymotion Cloud
6. It can be used to build Android project
7. It can be used to run unit and UI-Test with different test-frameworks, e.g. Appium, Espresso, etc.
8. It support (http) docker-android MCP-Server (beta-version)
9. It support Appium MCP
10. It support AI-Agent (beta-version) - supported local-LLM server: Ollama, VLLM
List of Docker-Images
---------------------
|Android |API |Image with latest release version |Image with specific release version|
|:---|:---|:---|:---|
|9.0|28|budtmo/docker-android:emulator_9.0|budtmo/docker-android:emulator_9.0_|
|10.0|29|budtmo/docker-android:emulator_10.0|budtmo/docker-android:emulator_10.0_|
|11.0|30|budtmo/docker-android:emulator_11.0|budtmo/docker-android:emulator_11.0_|
|12.0|32|budtmo/docker-android:emulator_12.0|budtmo/docker-android:emulator_12.0_|
|13.0|33|budtmo/docker-android:emulator_13.0|budtmo/docker-android:emulator_13.0_|
|14.0|34|budtmo/docker-android:emulator_14.0|budtmo/docker-android:emulator_14.0_|
|-|-|budtmo/docker-android:genymotion|budtmo/docker-android:genymotion_|
|-|-|budtmo/docker-android:mcp|budtmo/docker-android:mcp_|
List of Devices
---------------
Type | Device Name
----- | -----
Phone | Samsung Galaxy S10
Phone | Samsung Galaxy S9
Phone | Samsung Galaxy S8
Phone | Samsung Galaxy S7 Edge
Phone | Samsung Galaxy S7
Phone | Samsung Galaxy S6
Phone | Nexus 4
Phone | Nexus 5
Phone | Nexus One
Phone | Nexus S
Tablet | Nexus 7
Tablet | Pixel C
Requirements
------------
1. Docker is installed on your system.
Quick Start
-----------
1. If you use Ubuntu OS on your host machine, you can skip this step. For OSX and Windows OS user, you nTop issues
#231atd entered FATAL state, too many start retries too quickly31 comments · 2020-03-25#395[🐛 Bug ]: Device data reset when docker restart22 comments · 2023-11-09#405[🐛 Bug ]: Windows 11 -> VMware -> Ubuntu 22 -> Docker -> BOOTING11 comments · 2024-01-27#245Run arm version of APP10 comments · 2020-05-22#128Moving inside emulator virtualscene keys not working10 comments · 2018-10-30#476[🐛 PRO | Bug ]: “sudo docker run -d -p 6085:6080 -p 5558:5554 -p 5559:5555 -e EMULATOR_DEVICE="Samsung Galaxy S10" -e WEB_VNC=true --device /dev/kvm --name android-container2 -v android-data2:/home/androidusr budtmo/docker-android-pro”, It worked the first time, but after running docker restart container2, only the background is displayed, and the Android system doesn't show up.9 comments · 2024-12-24#458[🐛 Bug ]: port 6080 page has no android UI, just a backgroud 9 comments · 2024-09-04#136[Web test] Error in Appium server: 'app' option is required for reinstall 9 comments · 2019-01-09
Latest release
v3.9.0-p2 v3.9.0-p2 2026-11-10Changes: - Using the latest base image v3.9.0-p2 - Able to pass gpu mode via environment variable - Disable Animations for better performance - Bump click to version 8.5.1 - Bump coverage to version 7.17.2 - Bump fastmcp to version 4.1.7 - Bump pytest to version 9.2.0