Install Waydroid on CentOS Stream 10 — Quick Step-by-Step Guide

GNU/Linux CentOS Stream 10 Installing Waydroid – Quick-Start Guide

How to Install Waydroid in CentOS Stream 10 GNU/Linux desktop – Step by step Tutorial.

And Waydroid for CentOS 10 is a lightweight, high-performance Android container that lets you run Android apps natively with Wayland integration.

With Waydroid on CentOS 10, you can install, run Android apps natively, and enjoy Wayland-accelerated performance for seamless integration.

• Easy Installation – Install Waydroid on CentOS 10 with straightforward commands or packages.
• Wayland Integration – Full Wayland support for smooth windowing and compositor features on CentOS 10.
• Native App Performance – Run Android apps natively with reduced overhead and improved responsiveness.
• GPU Acceleration – Leverage hardware acceleration for graphics-intensive apps and games.
• Sandboxed Containers – Securely isolate Android instances using lightweight container technology.
• App Compatibility – Support for a wide range of Android APKs and common app frameworks.
• Developer-Friendly – Ideal for testing, debugging, and integrating Android workflows into CentOS 10 environments.

Attention: Waydroid requires a Wayland session on CentOS 10; X11 may fail unless you use a nested Wayland compositor.

Finally, this guide include detailed instructions about to Getting-Started with Waydroid on CentOS.

1. 1. Checking Wayland Environment

   Waydroid works only under Wayland display protocol.
   To check if you’re running Wayland:

   echo $XDG_SESSION_TYPE

   If it shows wayland, you’re good to go! Otherwise, log out and choose a Wayland session (for example, “GNOME on Wayland”) from the login screen.

2. 2. Verifying Kernel Support

   Waydroid needs Android binder and ashmem modules in your kernel.
   Run:

   ls /dev/binder /dev/ashmem

   If these devices don’t exist, try to load modules manually:

   sudo modprobe binder_linux; sudo modprobe ashmem_linux

   If those fail, you may need to rebuild your kernel with binder and ashmem enabled.

3. 3. Installing Dependencies

   Before using Waydroid, install the required system components:

   sudo dnf install -y lxc python3-lxc wget unzip

   And enable LXC service if needed:

   sudo systemctl enable --now lxc.service

4. 4. Downloading Waydroid Images

   Next, get the official Waydroid image set (system + vendor files):

   wget https://images.waydroid.org/system-arm64.img.xz; wget https://images.waydroid.org/vendor-arm64.img.xz

   Then extract them with:

   unxz *.xz

   These will be used by Waydroid to create the Android container.

5. 5. Initializing Waydroid Container

   Initialize the Waydroid container environment:

   sudo waydroid init

   This sets up the Android rootfs and vendor images for your system.

6. 6. Starting Waydroid Session

   Now start the container and launch the Android session:

   sudo systemctl start waydroid-container

   Then run:

   waydroid session start

7. 7. Launching Android Desktop

   Finally, open Waydroid GUI (Android desktop):

   waydroid show-full-ui

   A full Android interface should appear, ready to use apps and navigation.

8. 8. Exiting and Stopping Waydroid

   When done, close the Android window and stop the container safely:

   sudo systemctl stop waydroid-container

   You can start it again anytime using the previous commands.

So Now I’m truly Happy if My Guide could Help you to Get Started with Waydroid on RHEL-based GNU/Linux!