docker-android
by budtmo
Android in docker solution with noVNC supported, video recording and mcp server
15,799stars
1,747forks
Python
Added 9/2/2026
⚠️ Third-Party Software Notice
This skill is third-party open-source software developed and hosted independently on GitHub. SkillsLLM is an informational directory and does not control or maintain the underlying repository.
Any security checks, ratings, or warnings displayed by SkillsLLM are automated and limited in scope. They do not constitute a security certification or guarantee that the software is safe, error-free, or free from malicious code, vulnerabilities, compromised dependencies, or prompt-injection risks.
Review the source code, permissions, dependencies, and configuration before installing or running any third-party skill. Use is at your own risk. To the maximum extent permitted by applicable law, SkillsLLM is not liable for losses arising from third-party software.
MCP Serversandroidandroid-emulatorawsazureclouddockerdocker-androidemulatorgcpgenymotionjenkinskubernetesmcpmcp-servermobile-appmobile-webnovncseleniumterraform
Installation
# Add to your Claude Code skills
git clone https://github.com/budtmo/docker-androidGetting Started
Guides for using mcp servers skills like docker-android.
- Best MCP Servers in 2026Category-by-category picks: databases, dev tools, productivity, browser automation.
- What is an AI Skills Marketplace?Definitions, how marketplaces work, and how to choose between them in 2026.
- Getting Started with AI SkillsFirst-time install walkthrough for Claude Code, Codex CLI, and ChatGPT.
Security ReportVerified
Last scanned: 9/2/2026
{
"issues": [],
"status": "PASSED",
"scannedAt": "2026-09-02T08:24:57.205Z",
"npmAuditRan": true,
"pipAuditRan": true,
"promptInjectionRan": true
}
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).
Advantages of using this project
- Emulator with different device profile and skins, such as Samsung Galaxy S6, LG Nexus 4, HTC Nexus One and more.
- Support vnc to be able to see what happen inside docker container
- Support log sharing feature where all logs can be accessed from web-UI
- Ability to control emulator from outside container by using adb connect
- Integrated with other cloud solutions, e.g. Genymotion Cloud
- It can be used to build Android project
- It can be used to run unit and UI-Test with different test-frameworks, e.g. Appium, Espresso, etc.
- It support mcp server (beta-version)
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_<release_version> |
| 10.0 | 29 | budtmo/docker-android:emulator_10.0 | budtmo/docker-android:emulator_10.0_<release_version> |
| 11.0 | 30 | budtmo/docker-android:emulator_11.0 | budtmo/docker-android:emulator_11.0_<release_version> |
| 12.0 | 32 | budtmo/docker-android:emulator_12.0 | budtmo/docker-android:emulator_12.0_<release_version> |
| 13.0 | 33 | budtmo/docker-android:emulator_13.0 | budtmo/docker-android:emulator_13.0_<release_version> |
| 14.0 | 34 | budtmo/docker-android:emulator_14.0 | budtmo/docker-android:emulator_14.0_<release_version> |
| - | - | budtmo/docker-android:genymotion | budtmo/docker-android:genymotion_<release_version> |
| - | - | budtmo/docker-android:mcp | budtmo/docker-android:mcp_<release_version> |
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
- Docker is installed on your system.
Quick Start
-
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.
-
Your machine should support virtualization. To check if the virtualization is enabled is:
sudo apt install cpu-checker kvm-ok -
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 -
Open http://localhost:6080 to see inside running container.
-
To check the status of the emulator
docker exec -it android-container cat device_status
Persisting data
The default behaviour is to destroy the emulated device on container restart. To persist data, you need to mount a volume at /home/androidusr:
docker run -v data:/home/androidusr budtmo/docker-android:emulator_11.0
WSL2 Hardware acceleration (Windows 11 only)
Credit goes to Guillaume - The Parallel Interface blog
Microsoft - Advanced settings configuration in WSL
-
Add yourself to the
kvmusergroup.sudo usermod -a -G kvm ${USER} -
Add necessary flags to
/etc/wsl.confto their respective sections.[boot] command = /bin/bash -c 'chown -v root:kvm /dev/kvm && chmod 660 /dev/kvm'Then, using PowerShell, open a notepad on
notepad $env:USERPROFILE\.wslconfig. Inside, put these other flags:[wsl2] nestedVirtualization=true -
Restart WSL2 via CMD prompt or Powershell
wsl --shutdown
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.
nestedVirtualization flag is only available to Windows 11.
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.
Use-Cases
- Build Android project
- UI-Test with Appium
- Control Android emulator on host machine
- SMS Simulation
- Jenkins
- Deploying on cloud (Azure, AWS, GCP)
Custom-Configurations
This document contains information about configurations that can be used to enable some features, e.g. log-sharing, etc.
Genymotion
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. Docker-Android is integrated with Genymotion on different cloud services, e.g. Genymotion SAAS, AWS, GCP, Alibaba Cloud. Please follow this document for more detail.
Emulator Skins
The Emulator skins are taken from Android Studio IDE and Samsung Developer Website
USERS
PRO VERSION
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.
The differences between normal version and pro version are:
| Feature | Normal | Pro | Comment |
|---|---|---|---|
| user-behavior-analytics | Yes | No | - |
| proxy | No | Yes | Set up company proxy on Android emulator on fly |
| language | No | Yes | Set up language on Android emulator on fly |
| Newer Android version | No | Yes | Support other newer Android version e.g. Android 15, Android 16, etc |
| root-privileged | No | Yes | Able to run command with security privileged |
| headless-mode | No | Yes | Save resources by using headless mode |
| Selenium 4.x integration | No | Yes | Running Appium UI-Tests againt one (Selenium Hub) endpoint for Android- and iOS emulator(s) / device(s) |
| multiple Android-Simulators | No | Yes (soon) | Save resources by having multiple Android-Simulators on one docker-container |
| Google Play Store | No | Yes (soon) | - |
| Video Recording | No | Yes (soon) | Helpful for debugging |
This document contains detail information about how to use docker-android-pro.
SPONSORS
Swiftproxy — Swiftproxy provides high-quality residential proxies for Android testing, automation, and location-based workflows. With 90M+ residential IPs, HTTP(S)/SOCKS5 support, flexible targeting, and non-expiring traffic, Swiftproxy helps users test apps and online services from different locations. Try Swiftproxy for free today and get 10% off with code PROXY90.
LICENSE
See License
Frequently Asked Questions
What is docker-android?
docker-android is an open-source mcp servers skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by budtmo. Android in docker solution with noVNC supported, video recording and mcp server. It has 15,799 GitHub stars.
Is docker-android safe to use?
Yes. docker-android passed SkillsLLM's automated security scan — a dependency vulnerability audit plus prompt-injection heuristics — with no high-severity issues. You can read the full report in the Security Report section on this page.
How do I install docker-android?
Clone the repository with "git clone https://github.com/budtmo/docker-android" and add it to your Claude Code skills directory (see the Installation section above).
What programming language is docker-android written in?
docker-android is primarily written in Python. It is open-source under budtmo on GitHub, so you can review or fork the full source.
Are there alternatives to docker-android?
Yes. SkillsLLM lists many other MCP Servers skills you can browse and compare side by side. Open the MCP Servers category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh docker-android against similar tools.
Comments (0)
to leave a comment.
No comments yet. Be the first to share your thoughts!
Related Skills
The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
245,895
37,105
JavaScript
AI Agentsai-agentsanthropic
Fair-code workflow automation platform with native AI capabilities. Combine visual building with custom code, self-host or cloud, 400+ integrations.
203,093
60,499
TypeScript
MCP Serversaiapis
The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
185,940
28,768
JavaScript
AI Agentsai-agentsanthropic
A cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Grok Build & Hermes Agent. Only official website: ccswitch.io
130,638
8,975
Rust
AI Agentsai-toolsclaude-code
Turn any codebase, with its docs, SQL schemas, configs, and PDFs, into a queryable knowledge graph. A /graphify skill for Claude Code, Cursor, Codex, and Gemini CLI: local deterministic AST parsing, every edge explained, no vector store.
113,674
11,070
Python
AI Agentsai-agentsantigravity
An open-source AI agent that brings the power of Gemini directly into your terminal.
106,764
14,516
TypeScript
AI Agentsaiai-agents
Popular in MCP Servers
Top skills in this category by stars
🕷️ An adaptive Web Scraping framework that handles everything from a single request to a full-scale crawl!
77,865
7,821
Python
MCP Serversaiai-scraping
⭐AI-driven public opinion & trend monitor with multi-platform aggregation, RSS, and smart alerts.🎯 告别信息过载，你的 AI 舆情监控助手与热点筛选工具！聚合多平台热点 + RSS 订阅，支持关键词精准筛选。AI 智能筛选新闻 + AI 翻译 + AI 分析简报直推手机，也支持接入 MCP 架构，赋能 AI 自然语言对话分析、情感洞察与趋势预测等。支持 Docker ，数据本地/云端自持。集成微信/飞书/钉钉/Telegram/邮件/ntfy/bark/slack 等渠道智能推送。
61,988
24,877
Python
MCP Serversaibark