erstt/redroid

English / https://github.com/ERSTT/redroid/blob/main/README_CN.md

Redroid Docker Images with ARM / ARM64 Support

This repository provides Redroid Docker images integrated with Houdini or NDK Translation, making it possible to run ARM architecture Android apps on an x86_64 platform (such as Intel / AMD processors). These images are especially useful for application testing and integration development.

Image List

Additional Notes:

The following image variants are also available:

erstt/<android_version>_<houdini_or_ndk><_magisk><_litegapps>_ChromeOS

• _magisk (optional): Magisk pre-installed
• _litegapps (optional): Lightweight Google Apps pre-installed

Usage Suggestions

• The images are only suitable for x86_64 architecture devices.

• When starting the container, make sure to configure device mapping and mount options properly.

• Where to file issues: https://github.com/ERSTT/redroid/issues

• If you only need to run games supporting arm64-v8a (e.g., Arknights), it’s suggested to remove the armeabi-v7a and armeabi ABIs for better stability.

• The device has not been certified by the Play Protect mechanism. To proceed, follow these steps:

  1. Use ADB to retrieve the device ID:

     bash
     adb root
     adb shell 'sqlite3 /data/data/com.google.android.gsf/databases/gservices.db \
     "select * from main where name = \"android_id\";"'
     

     Or

     bash
     adb shell
     su
     sqlite3 /data/data/com.google.android.gsf/databases/gservices.db "select * from main where name = \"android_id\";"
     

  2. Register the device ID at the following URL:

     [***]

Configuration

NDK Image

Docker / Podman Run Example

bash
docker run -itd --rm --privileged \
  --pull always \
  -v /path/to/your/directory:/data \
  -p 5555:5555 \
  <ndk_image_tag>

bash
podman run -itd --rm --privileged \
  --pull always \
  -v /path/to/your/directory:/data \
  -p 5555:5555 \
  <ndk_image_tag>

Docker Compose Example

yaml
services:
  redroid:
    image: <ndk_image_tag>
    tty: true
    stdin_open: true
    privileged: true
    ports:
      - 5555:5555
    volumes:
      - /path/to/your/directory:/data

Houdini Image

Docker / Podman Run Example

bash
docker run -itd --rm --privileged \
  --pull always \
  -v /path/to/your/directory:/data \
  -p 5555:5555 \
  <houdini_image_tag> \
  ro.enable.native.bridge.exec64=1 \
  ro.dalvik.vm.native.bridge=libhoudini.so

bash
podman run -itd --rm --privileged \
  --pull always \
  -v /path/to/your/directory:/data \
  -p 5555:5555 \
  <houdini_image_tag> \
  ro.enable.native.bridge.exec64=1 \
  ro.dalvik.vm.native.bridge=libhoudini.so

Docker Compose Example

yaml
services:
  redroid:
    image: <houdini_image_tag>
    tty: true
    stdin_open: true
    privileged: true
    ports:
      - 5555:5555
    volumes:
      - /path/to/your/directory:/data
    command:
      - ro.enable.native.bridge.exec64=1
      - ro.dalvik.vm.native.bridge=libhoudini.so

Other custom settings

License

This project is based on the https://github.com/remote-android.

• redroid itself is under Apache License, since redroid includes many 3rd party modules, you may need to examine license carefully.
• redroid kernel modules are under GPL v2

Credits

• https://github.com/remote-android
• https://github.com/ayasa520/redroid-script
• https://huskydg.github.io/magisk-files/
• https://github.com/supremegamers/vendor_intel_proprietary_houdini
• https://github.com/jay0lee/chromeos-update-directory
• https://github.com/BlissRoms-x86/android_vendor_google_chromeos-x86
• https://github.com/ER5TT/ndk/tree/grunt_R134
• https://github.com/ER5TT/houdini/tree/brask_R127