<a href="https://opensource.org/licenses/MIT" target="_blank" rel="noopener nofollow"><img src="https://img.shields.io/badge/License-MIT-yellow.svg" alt="License: MIT"></a>
<a href="https://hub.docker.com/r/shmayro/dockerify-android" target="_blank" rel="noopener nofollow"><img src="https://img.shields.io/docker/pulls/shmayro/dockerify-android" alt="Docker Pulls"></a>
<a href="https://github.com/shmayro/dockerify-android/issues" target="_blank" rel="noopener nofollow"><img src="https://img.shields.io/github/issues/shmayro/dockerify-android" alt="GitHub Issues"></a>
<a href="https://github.com/shmayro/dockerify-android/stargazers" target="_blank" rel="noopener nofollow"><img src="https://img.shields.io/github/stars/shmayro/dockerify-android?style=social" alt="GitHub Stars"></a>
Dockerify Android is a Dockerized Android emulator supporting multiple CPU architectures (x86 and arm64 in the near future …) with native performance and seamless ADB &amp; Web access. It allows developers to run Android virtual devices (AVDs) efficiently within Docker containers, facilitating scalable testing and development environments.
<h3>🔥 Key Feature: Web Interface Access 🌐</h3>
Access and control the Android emulator directly in your web browser with the integrated <a href="https://github.com/Shmayro/ws-scrcpy-docker" target="_blank" rel="noopener nofollow">scrcpy-web</a> interface! No additional software needed - just open your browser and start using Android.
<img src="https://raw.githubusercontent.com/Shmayro/dockerify-android/main/doc/dockerify-android-web-preview.png" alt="scrcpy-web interface">
<blockquote>
Benefits of Web Interface:
<ul>
<li>No extra software to install</li>
<li>Access from any computer with a web browser</li>
<li>Full touchscreen and keyboard support</li>
<li>Perfect for remote work or sharing the emulator with team members</li>
</ul>
</blockquote>
<h2>🏠 Homepage</h2>
<a href="https://github.com/shmayro/dockerify-android" target="_blank" rel="noopener nofollow"><img src="https://img.shields.io/badge/GitHub-Repo-blue?logo=github" alt="GitHub"></a>
<a href="https://hub.docker.com/r/shmayro/dockerify-android" target="_blank" rel="noopener nofollow"><img src="https://img.shields.io/badge/Docker%20Hub-Repo-blue?logo=docker" alt="Docker Hub"></a>
<h2>🔧 Features</h2>
<ul>
<li>🌐 Web Interface: Access the emulator directly from your browser with the integrated <a href="https://github.com/Shmayro/ws-scrcpy-docker" target="_blank" rel="noopener nofollow">scrcpy-web</a> interface.</li>
<li>Root and Magisk Preinstalled: Comes with root access and Magisk preinstalled for advanced modifications.</li>
<li>PICO GAPPS Preinstalled: Includes PICO GAPPS for essential Google services.</li>
<li>Seamless ADB Access: Connect to the emulator via ADB from the host and other networked devices.</li>
<li>scrcpy Support: Mirror the emulator screen using scrcpy for a seamless user experience.</li>
<li>Optimized Performance: Utilizes native CPU capabilities for efficient emulation.</li>
<li>Multi-Architecture Support: Runs natively on both x86 and arm64 CPU architectures.</li>
<li>Docker Integration: Easily deploy the Android emulator within a Docker container.</li>
<li>Easy Setup: Simple Docker commands to build and run the emulator.</li>
<li>Supervisor Management: Manages emulator processes with Supervisor for reliability.</li>
<li>Unified Container Logs: All emulator and boot logs are redirected to Docker’s standard log system.</li>
</ul>
<h2>🛠️ Prerequisites</h2>
Before you begin, ensure you have met the following requirements:
<ul>
<li>Docker: Installed on your system. <a href="https://docs.docker.com/get-docker/" target="_blank" rel="noopener nofollow">Installation Guide</a></li>
<li>Docker Compose: For managing multi-container setups. <a href="https://docs.docker.com/compose/install/" target="_blank" rel="noopener nofollow">Installation Guide</a></li>
<li>KVM Support: Ensure your system supports KVM (Kernel-based Virtual Machine) for hardware acceleration.
<ul>
<li>
Check KVM Support:
<pre><code class="language-bash">egrep -c &#x27;(vmx|svm)&#x27; /proc/cpuinfo
</code></pre>
A non-zero output indicates KVM support.
</li>
</ul>
</li>
</ul>
<h2>🚀 Installation</h2>
To simplify the setup process, you can use the provided <a href="https://github.com/Shmayro/dockerify-android/blob/main/docker-compose.yml" target="_blank" rel="noopener nofollow">docker-compose.yml</a> file.
<ol>
<li>
Clone the Repository:
<pre><code class="language-bash">git clone https://github.com/shmayro/dockerify-android.git
cd dockerify-android
</code></pre>
</li>
<li>
Run Docker Compose:
<pre><code class="language-bash">docker compose up -d
</code></pre>
<blockquote>
Note: This command launches the Android emulator and web interface. First boot takes some time to initialize. Once ready, the device will appear in the web interface at <a href="http://localhost:8000" target="_blank" rel="noopener nofollow">http://localhost:8000</a>.
</blockquote>
</li>
</ol>
<h2>📡 Usage</h2>
<h3>🌐 Use the Web Interface to Access the Emulator</h3>
The quickest and easiest way to interact with the Android emulator is through your web browser:
<ol>
<li>Open your browser and go to <code>http://localhost:8000</code></li>
<li>You should see the device listed as “dockerify-android:5555” automatically connected</li>
<li>Select one of the available streaming options:
<ul>
<li>H264 Converter (recommended for best overall experience)</li>
<li>Tiny H264 (good for low-bandwidth connections)</li>
<li>Broadway.js (fallback option)</li>
</ul>
</li>
</ol>
<img src="https://raw.githubusercontent.com/Shmayro/dockerify-android/main/doc/scrcpy-web-preview.png" alt="scrcpy-web interface">
<blockquote>
Note: First boot may take some time as the Android emulator needs to fully initialize. When everything is ready, the device will appear in the web interface as shown in the screenshot above.
</blockquote>
<h3>Connect via ADB</h3>
If you need direct ADB access to the emulator:
<pre><code class="language-bash">adb connect localhost:5555
adb devices
</code></pre>
Expected Output:
<pre><code>connected to localhost:5555
List of devices attached
localhost:5555	device
</code></pre>
<h3>Use scrcpy to Mirror the Emulator Screen</h3>
For a native desktop experience, you can use scrcpy:
<pre><code class="language-bash">scrcpy -s localhost:5555
</code></pre>
<blockquote>
Note: Ensure <code>scrcpy</code> is installed on your host machine. <a href="https://github.com/Genymobile/scrcpy#installation" target="_blank" rel="noopener nofollow">Installation Guide</a>
</blockquote>
<h2>🙏 Thanks &amp; feedback wanted</h2>
Huge thanks to everyone who gives Dockerify-Android a spin! 
My primary goal right now is to collect opinions and real-world feedback before locking in the v1.0 roadmap.
If you try it, please open an issue, discussion, or PR on GitHub with:
<ul>
<li>What worked / what didn’t</li>
<li>Performance numbers on your hardware</li>
<li>Features you’d love to see next</li>
</ul>
Your insights will shape the project’s direction. 🙌

Dockerify-Android: native performance Android emulator with ADB & Web access