Android Cloud Emulator

Self-hosted Android emulator in Docker with web interface and remote ADB access.

A complete solution for running Android in the cloud with full root access, ARM translation, and cloud-ready deployment. Perfect for app testing, automation, and development.

---

Features

• Web Interface - Access Android directly from your browser via scrcpy-web
• ARM64 Support - Run ARM/ARM64 apps with NDK translation layer
• Root Access - Full root with Magisk integration
• Google Play Alternative - MicroG for Play Services compatibility
• Remote ADB - Connect from anywhere via ADB over network
• Screen Recording - Built-in recording capabilities
• Cloud Ready - Deploy to any cloud provider (Oracle Cloud Free Tier, AWS, GCP, Azure)

---

Quick Start

Prerequisites

Requirement	Minimum	Recommended
CPU	2 cores	4+ cores
RAM	4 GB	8+ GB
Storage	20 GB	50+ GB
KVM	Required	Required

Check KVM support:

egrep -c '(vmx|svm)' /proc/cpuinfo
# Output > 0 = KVM supported

Installation

1. Clone repository:

git clone https://github.com/luoshixin93-sudo/android-cloud-emulator.git
cd android-cloud-emulator

2. Configure environment:

cp .env.example .env
# Edit .env to customize settings

3. Start the emulator:

docker compose up -d

4. Access:

• Web Interface: http://localhost:8000
• ADB: �db connect localhost:5555

First boot takes 5-10 minutes. Check logs:

docker compose logs -f cloud-phone

---

Configuration

Edit .env file to customize:

# Display
SCREEN_RESOLUTION=1280x720
SCREEN_DENSITY=240
RAM_SIZE=4096

# Features
ROOT_ENABLED=true
GAPPS_ENABLED=true
ARM_TRANSLATION=true

# Security
AUTH_ENABLED=true
AUTH_PASSWORD=your_secure_password

---

Architecture

┌─────────────────────────────────────────────────────┐ │ Cloud Phone Stack │ ├─────────────────────────────────────────────────────┤ │ ┌───────────────┐ ┌───────────────────────────┐ │ │ │ Web UI │ │ Android Emulator │ │ │ │ (scrcpy-web) │◄─┤ - Android 13 (API 33) │ │ │ │ Port 8000 │ │ - Root + Magisk │ │ │ └───────────────┘ │ - ARM Translation │ │ │ │ - MicroG Services │ │ │ ┌───────────────┐ └───────────────────────────┘ │ │ │ ADB Server │ │ │ │ Port 5555 │ ┌───────────────────────────┐ │ │ └───────────────┘ │ Docker + KVM │ │ │ │ Hardware Acceleration │ │ │ └───────────────────────────┘ │ └─────────────────────────────────────────────────────┘

---

Cloud Deployment

Works on major cloud providers:

• Oracle Cloud Free Tier - Best free option (4 ARM cores, 24GB RAM)
• AWS EC2 - Use metal instances for KVM
• Google Cloud - N2 or C2 series with nested virtualization
• Azure - Dv3 or Ev3 series

---

Security

• Encrypted storage support
• Network isolation with dedicated Docker network
• Optional WireGuard VPN integration
• Access logging
• Auto backup capability

---

License

MIT License

---

Made with ❤️ for cloud phone automation → qtphone.com