# docker-android

> Minimal Alpine-based Docker image running the Android emulator as a service.

docker-android bundles the Android emulator, ADB server, and QEMU into a lightweight Alpine Docker container. It runs headless for automated CI/CD testing pipelines and supports KVM acceleration as well as remote display streaming using scrcpy.

Website: https://github.com/HQarroum/docker-android

## What it is for

- Run automated Android UI and integration tests inside CI/CD pipelines
- Stream and interact with an Android virtual device locally using scrcpy
- Test Android apps against multiple API levels and image types in isolated containers
- Mount external Android SDK folders to speed up build times and reduce container sizes

## Features

- Minimal Alpine-based container setup with KVM virtualization support
- Built-in ADB port-forwarding on port 5555
- Headless execution optimized for CI farms and automated workflows
- Remote GUI control compatibility via scrcpy
- Customizable build arguments for API level, CPU architecture, and Play Store support
- Options for GPU (CUDA) acceleration and persistent virtual device storage

## Pricing

Open source

## Details

- Type: GitHub repo
- Category: [Development](https://xiry.app/topics/development.md)
- Open source: yes
- Platforms: Linux, Self-hosted, Command line
- For: Android developers and DevOps engineers needing containerized emulator environments.
- Alternative to: budtmo/docker-android, Genymotion
- Tags: docker, android, emulator, ci cd, testing, kvm

## Why it was saved

- [@marc.kaz, 25 April 2026](https://www.instagram.com/reel/DXjstfTDq5U/): Enables spinning up an Android virtual device in CI/CD pipelines or local workflows using a single Docker command with ADB, KVM, and GPU acceleration.

## Related

- [agent-browser](https://xiry.app/resources/agent-browser): Browser automation CLI and engine purpose-built for AI agents (GitHub repo, Open source)
- [How to self-host a Next.js app on a Hetzner VM using Kamal](https://xiry.app/resources/how-to-self-host-a-next-js-app-on-a-hetzner-vm-using-kamal): Step-by-step tutorial for deploying Next.js to Hetzner using Kamal (Article or course, Free)
- [agent-experience Claude Code Skill](https://xiry.app/resources/agent-experience-claude-code-skill): Audits documentation readability for AI agents by running parallel onboarding tests (Tip, Free)
- [bgutil-ytdlp-pot-provider](https://xiry.app/resources/bgutil-ytdlp-pot-provider): Proof-of-origin token provider plugin for yt-dlp to bypass YouTube bot checks (GitHub repo, Open source)
- [boat](https://xiry.app/resources/boat): Persistent Ubuntu cloud sandboxes with browsers for running AI agents (Web app, Freemium)
- [clean-architecture-swiftui](https://xiry.app/resources/clean-architecture-swiftui): Sample SwiftUI app demonstrating Clean Architecture with modern Swift patterns (GitHub repo, Open source)

Updated 3 October 2026. Page: https://xiry.app/resources/docker-android

Make your own library: Xiry takes your saved reels, tweets, Reddit bookmarks and Watch Later videos, makes them searchable and pulls the useful stuff out, like this library. It's invite-only for now; join the waitlist at https://xiry.app/#waitlist.