Skip to content
Back to search

docker-android

Android in docker solution with noVNC supported, video recording, mcp server and AI-agent

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/budtmo/docker-android with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/budtmo/docker-android'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/budtmo--docker-android/badge.svg)](/listings/budtmo--docker-android)

HTML

<a href="/listings/budtmo--docker-android"><img src="/api/listings/budtmo--docker-android/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

1. If you use ***Ubuntu OS*** on your host machine, you can skip this step. For ***OSX*** and ***Windows OS*** user, you need to use Virtual Machine that support Virtualization with Ubuntu OS because the image can be run under ***Ubuntu OS only***.

2. Your machine should support virtualization. To check if the virtualization is enabled is: ``` sudo apt install cpu-checker kvm-ok ```

3. Run Docker-Android container ``` docker run -d -p 6080:6080 -e EMULATOR_DEVICE="Samsung Galaxy S10" -e WEB_VNC=true --device /dev/kvm --name android-container budtmo/docker-android:emulator_11.0 ```

4. Open ***http://localhost:6080*** to see inside running container.

5. To check the status of the emulator ``` docker exec -it android-container cat device_status ```

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 241 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. <p align="center">
  2. <img id="header" src="./images/logo_docker-android.png" />
  3. </p>
  4. [![Paypal Donate](https://img.shields.io/badge/paypal-donate-blue.svg)](http://paypal.me/budtmo) [![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat-square)](http://makeapullrequest.com) [![codecov](https://codecov.io/gh/budtmo/docker-android/branch/master/graph/badge.svg)](https://codecov.io/gh/budtmo/docker-android) [![Join the chat at https://gitter.im/budtmo/docker-android](https://badges.gitter.im/budtmo/docker-android.svg)](https://gitter.im/budtmo/docker-android?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge) [![GitHub release](https://img.shields.io/github/release/budtmo/docker-android.svg)](https://github.com/budtmo/docker-android/releases)
  5. 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).
  6. Sponsors
  7. --------
  8. <p align="center">
  9. <a href="https://www.webshare.io/?referral_code=0f7q99htymgf">
  10. <img src="./images/sponsor_webshare.png" alt="WebShare" width="500">
  11. </a>
  12. </p>
  13. [Webshare](https://www.webshare.io/?referral_code=0f7q99htymgf) **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!.
  14. <p align="center">
  15. <a href="https://proxy-seller.com/?utm_source=github&utm_medium=referral&utm_campaign=budtmo&utm_term=github">
  16. <img src="./images/sponsor_proxyseller.png" alt="ProxySeller" width="500">
  17. </a>
  18. </p>
  19. [Proxy-Seller](https://proxy-seller.com/?utm_source=github&utm_medium=referral&utm_campaign=budtmo&utm_term=github) 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**.
  20. Advantages of using this project
  21. --------------------------------
  22. 1. Emulator with different device profile and skins, such as Samsung Galaxy S6, LG Nexus 4, HTC Nexus One and more.
  23. 2. Support vnc to be able to see what happen inside docker container
  24. 3. Support log sharing feature where all logs can be accessed from web-UI
  25. 4. Ability to control emulator from outside container by using adb connect
  26. 5. Integrated with other cloud solutions, e.g. [Genymotion Cloud](https://www.genymotion.com/cloud/)
  27. 6. It can be used to build Android project
  28. 7. It can be used to run unit and UI-Test with different test-frameworks, e.g. Appium, Espresso, etc.
  29. 8. It support (http) docker-android MCP-Server (beta-version)
  30. 9. It support Appium MCP
  31. 10. It support AI-Agent (beta-version) - supported local-LLM server: Ollama, VLLM
  32. <p align="center">
  33. <img src="./images/mcp_and_ai_agent.png">
  34. </p>
  35. <p align="center">
  36. <img src="./images/mcp_appium_and_ai_agent.png">
  37. </p>
  38. List of Docker-Images
  39. ---------------------
  40. |Android |API |Image with latest release version |Image with specific release version|
  41. |:---|:---|:---|:---|
  42. |9.0|28|budtmo/docker-android:emulator_9.0|budtmo/docker-android:emulator_9.0_<release_version>|
  43. |10.0|29|budtmo/docker-android:emulator_10.0|budtmo/docker-android:emulator_10.0_<release_version>|
  44. |11.0|30|budtmo/docker-android:emulator_11.0|budtmo/docker-android:emulator_11.0_<release_version>|
  45. |12.0|32|budtmo/docker-android:emulator_12.0|budtmo/docker-android:emulator_12.0_<release_version>|
  46. |13.0|33|budtmo/docker-android:emulator_13.0|budtmo/docker-android:emulator_13.0_<release_version>|
  47. |14.0|34|budtmo/docker-android:emulator_14.0|budtmo/docker-android:emulator_14.0_<release_version>|
  48. |-|-|budtmo/docker-android:genymotion|budtmo/docker-android:genymotion_<release_version>|
  49. |-|-|budtmo/docker-android:mcp|budtmo/docker-android:mcp_<release_version>|
  50. List of Devices
  51. ---------------
  52. Type | Device Name
  53. ----- | -----
  54. Phone | Samsung Galaxy S10
  55. Phone | Samsung Galaxy S9
  56. Phone | Samsung Galaxy S8
  57. Phone | Samsung Galaxy S7 Edge
  58. Phone | Samsung Galaxy S7
  59. Phone | Samsung Galaxy S6
  60. Phone | Nexus 4
  61. Phone | Nexus 5
  62. Phone | Nexus One
  63. Phone | Nexus S
  64. Tablet | Nexus 7
  65. Tablet | Pixel C
  66. Requirements
  67. ------------
  68. 1. Docker is installed on your system.
  69. Quick Start
  70. -----------
  71. 1. If you use ***Ubuntu OS*** on your host machine, you can skip this step. For ***OSX*** and ***Windows OS*** user, you need to use Virtual Machine that support Virtualization with Ubuntu OS because the image can be run under ***Ubuntu OS only***.
  72. 2. Your machine should support virtualization. To check if the virtualization is enabled is:
  73. ```
  74. sudo apt install cpu-checker
  75. kvm-ok
  76. ```
  77. 3. Run Docker-Android container
  78. ```
  79. docker run -d -p 6080:6080 -e EMULATOR_DEVICE="Samsung Galaxy S10" -e WEB_VNC=true --device /dev/kvm --name android-container budtmo/docker-android:emulator_11.0
  80. ```
  81. 4. Open ***http://localhost:6080*** to see inside running container.
  82. 5. To check the status of the emulator
  83. ```
  84. docker exec -it android-container cat device_status
  85. ```
  86. Persisting data
  87. -----------
  88. The default behaviour is to destroy the emulated device on container restart. To persist data, you need to mount a volume at `/home/androidusr`:
  89. ```
  90. docker run -v data:/home/androidusr budtmo/docker-android:emulator_11.0
  91. ```
  92. WSL2 Hardware acceleration (Windows 11 only)
  93. -----------
  94. Credit goes to [Guillaume - The Parallel Interface blog](https://www.paralint.com/2022/11/find-new-modified-and-unversioned-subversion-files-on-windows)
  95. [Microsoft - Advanced settings configuration in WSL](https://learn.microsoft.com/en-us/windows/wsl/wsl-config)
  96. 1. Add yourself to the `kvm` usergroup.
  97. ```
  98. sudo usermod -a -G kvm ${USER}
  99. ```
  100. 2. Add necessary flags to `/etc/wsl.conf` to their respective sections.
  101. ```
  102. [boot]
  103. command = /bin/bash -c 'chown -v root:kvm /dev/kvm && chmod 660 /dev/kvm'
  104. ```
  105. Then, using PowerShell, open a notepad on `notepad $env:USERPROFILE\.wslconfig`. Inside, put these other flags:
  106. ```
  107. [wsl2]
  108. nestedVirtualization=true
  109. ```
  110. 4. Restart WSL2 via CMD prompt or Powershell
  111. ```
  112. wsl --shutdown
  113. ```
  114. `command = /bin/bash -c 'chown -v root:kvm /dev/kvm && chmod 660 /dev/kvm'` sets `/dev/kvm` to `kvm` usergroup rather than the default `root` usergroup on WSL2 startup.
  115. `nestedVirtualization` flag is only available to Windows 11.
  116. If this setup does not work, you may have an old WSL version. In that case, ignore `\.wslconfig` and put everything on `/etc/wsl.conf`, including the `[wsl2]` flag.
  117. Use-Cases
  118. ---------
  119. 1. [Build Android project](./documentations/USE_CASE_BUILD_ANDROID_PROJECT.md)
  120. 2. [UI-Test with Appium](./documentations/USE_CASE_APPIUM.md)
  121. 3. [Control Android emulator on host machine](./documentations/USE_CASE_CONTROL_EMULATOR.md)
  122. 4. [SMS Simulation](./documentations/USE_CASE_SMS.md)
  123. 5. [Jenkins](./documentations/USE_CASE_JENKINS.md)
  124. 6. [Deploying on cloud (Azure, AWS, GCP)](./documentations/USE_CASE_CLOUD.md)
  125. Custom-Configurations
  126. ---------------------
  127. This [document](./documentations/CUSTOM_CONFIGURATIONS.md) contains information about configurations that can be used to enable some features, e.g. log-sharing, etc.
  128. Genymotion
  129. ----------
  130. <p align="center">
  131. <img id="geny" src="./images/logo_genymotion_and_dockerandroid.png" />
  132. </p>
  133. For you who do not have ressources to maintain the simulator or to buy machines or need different device profiles, you can give a try by using [Genymotion SAAS](https://cloud.geny.io/). Docker-Android is [integrated with Genymotion](https://www.genymotion.com/blog/partner_tag/docker/) on different cloud services, e.g. Genymotion SAAS, AWS, GCP, Alibaba Cloud. Please follow [this document](./documentations/THIRD_PARTY_GENYMOTION.md) for more detail.
  134. Emulator Skins
  135. --------------
  136. The Emulator skins are taken from [Android Studio IDE](https://developer.android.com/studio) and [Samsung Developer Website](https://developer.samsung.com/)
  137. USERS
  138. -----
  139. <a href="https://lookerstudio.google.com/s/iGaemHJqQvg">
  140. <p align="center">
  141. <img src="./images/docker-android_users.png" alt="docker-android-users" width="800" height="600">
  142. </p>
  143. </a>
  144. PRO VERSION
  145. -----------
  146. Due to high requests for help and to be able to actively maintain the projects, the creator has decided to create docker-android-pro. Docker-Android-Pro is a sponsor based project which mean that the docker image of pro-version can be pulled only by [active sponsor](https://github.com/sponsors/budtmo).
  147. The differences between normal version and pro version are:
  148. |Feature |Normal |Pro |Comment|
  149. |:---|:---|:---|:---|
  150. |user-behavior-analytics|Yes|No|-|
  151. |AI-Agent|No|Yes|Currently supported local-LLM server: Ollama, VLLM, It can also control emulator via REST-API|
  152. |proxy|No|Yes|Set up company proxy on Android emulator on fly|
  153. |language|No|Yes|Set up language on Android emulator on fly|
  154. |Newer Android version|No|Yes|Support other newer Android version e.g. Android 15, Android 16, Android 17, etc|
  155. |root-privileged|No|Yes|Able to run command with security privileged|
  156. |headless-mode|No|Yes|Save resources by using headless mode|
  157. |Selenium 4.x integration|No|Yes|Running Appium UI-Tests againt one (Selenium Hub) endpoint for Android- and iOS emulator(s) / device(s)|
  158. |multiple Android-Simulators|No|Yes (soon)|Save resources by having multiple Android-Simulators on one docker-container|
  159. |Google Play Store|No|Yes (soon)|-|
  160. |Video Recording|No|Yes (soon)|Helpful for debugging|
  161. List pro-version images:
  162. |Android |API |Type |Image with latest release version |Image with specific release version|
  163. |:---|:---|:---|:---|:---|
  164. |9.0|28|Normal|budtmo2/docker-android-pro:emulator_9.0|budtmo2/docker-android-pro:emulator_9.0_<release_version>|
  165. |10.0|29|Normal|budtmo2/docker-android-pro:emulator_10.0|budtmo2/docker-android-pro:emulator_10.0_<release_version>|
  166. |11.0|30|Normal|budtmo2/docker-android-pro:emulator_11.0|budtmo2/docker-android-pro:emulator_11.0_<release_version>|
  167. |12.0|32|Normal|budtmo2/docker-android-pro:emulator_12.0|budtmo2/docker-android-pro:emulator_12.0_<release_version>|
  168. |13.0|33|Normal|budtmo2/docker-android-pro:emulator_13.0|budtmo2/docker-android-pro:emulator_13.0_<release_version>|
  169. |14.0|34|Normal|budtmo2/docker-android-pro:emulator_14.0|budtmo2/docker-android-pro:emulator_14.0_<release_version>|
  170. |15.0|35|Normal|budtmo2/docker-android-pro:emulator_15.0|budtmo2/docker-android-pro:emulator_15.0_<release_version>|
  171. |16.0|36|Normal|budtmo2/docker-android-pro:emulator_16.0|budtmo2/docker-android-pro:emulator_16.0_<release_version>|
  172. |17.0|37|Normal|budtmo2/docker-android-pro:emulator_17.0|budtmo2/docker-android-pro:emulator_17.0_<release_version>|
  173. |9.0|28|Headless|budtmo2/docker-android-pro:emulator_headless_9.0|budtmo2/docker-android-pro:emulator_headless_9.0_<release_version>|
  174. |10.0|29|Headless|budtmo2/docker-android-pro:emulator_headless_10.0|budtmo2/docker-android-pro:emulator_headless_10.0_<release_version>|
  175. |11.0|30|Headless|budtmo2/docker-android-pro:emulator_headless_11.0|budtmo2/docker-android-pro:emulator_headless_11.0_<release_version>|
  176. |12.0|32|Headless|budtmo2/docker-android-pro:emulator_headless_12.0|budtmo2/docker-android-pro:emulator_headless_12.0_<release_version>|
  177. |13.0|33|Headless|budtmo2/docker-android-pro:emulator_headless_13.0|budtmo2/docker-android-pro:emulator_headless_13.0_<release_version>|
  178. |14.0|34|Headless|budtmo2/docker-android-pro:emulator_headless_14.0|budtmo2/docker-android-pro:emulator_headless_14.0_<release_version>|
  179. |15.0|35|Headless|budtmo2/docker-android-pro:emulator_headless_15.0|budtmo2/docker-android-pro:emulator_headless_15.0_<release_version>|
  180. |16.0|36|Headless|budtmo2/docker-android-pro:emulator_headless_16.0|budtmo2/docker-android-pro:emulator_headless_16.0_<release_version>|
  181. |17.0|37|Headless|budtmo2/docker-android-pro:emulator_headless_17.0|budtmo2/docker-android-pro:emulator_headless_17.0_<release_version>|
  182. |-|-|AI-Agent|budtmo2/docker-android-pro:agent|budtmo2/docker-android-pro:agent_<release_version>|
  183. |-|-|Selenium|budtmo2/docker-android-pro:selenium|budtmo2/docker-android-pro:selenium_<release_version>|
  184. This [document](./documentations/DOCKER-ANDROID-PRO.md) contains detail information about how to use docker-android-pro.
  185. LICENSE
  186. -------
  187. See [License](LICENSE.md)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.