# HQarroum/docker-android

🤖 A minimal and customizable Docker image running the Android emulator as a service.

Repository: https://github.com/HQarroum/docker-android
Canonical: https://ross.abutalabs.com/products/hqarroum-docker-android
Language: Shell
License: MIT
License Family: permissive
Topics: android, android-emulator, ci-pipeline, docker, docker-android
Last push: 2026-05-07T11:34:08+00:00

## Health v2 (maintenance only)
Score: 67/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 81, release rhythm 35, longevity 93
- inputs: {"age_days": 1302, "days_push": 118, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 7248, forks 558 (observed 2026-08-28T04:09:57.816584+00:00)

## What it is
A minimal, customizable Alpine-based Docker image that runs the Android emulator as a headless network-accessible service with ADB port forwarding and KVM support. It is designed for CI farms and remote control via tools like scrcpy, with configurable Android versions and device types.

## Use cases
- run android emulator in docker for ci tests
- headless android emulator for ci pipeline
- remotely control android emulator over network with scrcpy
- run android emulator with gpu acceleration in a container
- spin up disposable android emulator containers for automated testing
- expose adb server from dockerized android emulator

## When to choose
- you need ephemeral, reproducible Android emulators in CI
- you want a small, customizable emulator image with KVM or GPU support
- you need to access the emulator remotely over the network via ADB or scrcpy

## When to avoid
- you need a full Android development environment with build tools
- you want a persistent emulator with saved state between restarts
- you run on hardware without KVM or virtualization support

## Facets
- artifact type: infra-config
- maturity: active
- function: container-runtime, deployment, testing, e2e-testing
- domain: mobile-development, testing
- platform: cli
- tags: android-emulator, kvm, adb, ci-pipeline, headless, scrcpy, docker-image, containers, devops, docker, linux

## Member repositories
- HQarroum/docker-android (main) score 67

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:09:57.816584+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T17:39:44.005102+00:00, confidence not recorded.
  - readme: https://github.com/HQarroum/docker-android (fetched 2026-08-28T04:09:57.816584+00:00, sha 3519ffa10340)
- Data as of 2026-08-30T08:39:29.467469+00:00.