redroid-rk3588

Redroid images for Rockchip RK3588 series SoC

zh_CN(简体中文)

Supported Versions

LineageOS (user build)

• LineageOS 20 (lineage-20)

AOSP builds here

Supported Features

• GPU (Mali-G610) accelerated (SW render not available)
• Gapps
• Magisk (Kitsune fork)
• surfaceflinger patched for disabling FLAG_SECURE
• Fake WiFi (let apps believe WiFi is connected)
• scrcpy physical keyboard/mouse emulation support

Tested Devices

• Orange Pi 5 Plus w/16G RAM, OS Armbian Server (Debian 12 "Bookworm") with Armbian 5.10.160 kernel (Customized), Docker version 20.10.24(docker.io).
• Orange Pi 5 Plus w/16G RAM, OS Ubuntu Rockchip (Ubuntu 22.04 "Jammy" Gnome Desktop) with 5.10.0-1009-rockchip kernel (Stock), Docker version 27.0.3(docker-ce).
• Orange Pi 5 w/8G RAM, OS Armbian Desktop (Debian 12 "Bookworm" XFCE Desktop) with Armbian 5.10.160 kernel (Customized), Docker version 20.10.24(docker.io).
• Orange Pi 5 Plus w/16G RAM, OS Armbian Server (Debian 12 "Bookworm") with Armbian 6.1.75 kernel (Customized), Docker version 20.10.24(docker.io).
• Orange Pi 5 Plus w/16G RAM, OS Armbian Server (Debian 12 "Bookworm") with Armbian 6.1.84 kernel (Customized), Docker version 20.10.24(docker.io).
• Orange Pi 5 Plus w/16G RAM ，OS Armbian Server（Debian 13 "Trixie"）with Armbian 6.1.115 (Stock)，Docker version 26.1.5+dfsg1（docker.io）.

Prerequisites

• Kernel version Armbian vendor kernel for rk35xx (linux-image-vendor-rk35xx)
• Mali CSF GPU kernel driver
• Mali CSF firmware in /lib/firmware/
• CONFIG_PSI=y
• CONFIG_ANDROID_BINDERFS=y
• DMA-BUF device support

You can run envcheck.sh script to check them.

Deploy

Using docker compose:

Clone this repo:

git clone https://github.com/CNflysky/redroid-rk3588.git --depth 1
cd redroid-rk3588

For docker-ce:

docker compose up -d

For docker.io:

sudo apt install docker-compose
docker-compose up -d

Manual:

docker run -d -p 5555:5555 -v ~/redroid-data:/data --restart unless-stopped --name redroid --privileged cnflysky/redroid-rk3588:lineage-20 androidboot.redroid_height=1920 androidboot.redroid_width=1080

Arguments

Argument	Description	Default
androidboot.redroid_fps	set fps, range (1,120)	60
androidboot.redroid_magisk	enable magisk	0
androidboot.redroid_fake_wifi	enable fake WiFi	0
androidboot.redroid_fake_wifi_ssid	set fake WiFi ssid	FakeWiFi
androidboot.redroid_fake_wifi_bssid	set fake WiFi bssid	66:55:44:33:22:11
androidboot.redroid_fake_wifi_mac	set fake WiFi mac address	11:22:33:44:55:66
androidboot.redroid_fake_wifi_speed	set fake WiFi speed(Mbps)	866
androidboot.redroid_adbd_bind_eth0	bind adb socket to eth0	1
ro.adb.secure	enable ADB authentication	1
androidboot.redroid_create_secure_display	create secure display by default	1
androidboot.redroid_enable_input_subsys	enable input subsystem	0

(0 = disable, 1 = enable)

Documentation

Google Play Certification
Enable ADB authentication
App compatibility list
About Fake WiFi
Switch device type
scrcpy physical keyboard/mouse emulation

Deprecated builds

AOSP (userdebug build)

Note: AOSP builds are no longer maintained. Special DMA-BUF device is required to run these images.

• Android 12(12.0.0-latest)
• Android 13(13.0.0-latest)