Waydroid

This article is a stub. Please help out by expanding it - how to get started.

Waydroid is a container-based approach to boot a full Android system on regular GNU/Linux systems running Wayland based desktop environments.

Installation

Emerge

Important
Waydroid is currently available via the GURU overlay

root #emerge --ask app-containers/waydroid

Usage

Initialization

After installing Waydroid, initialize it:

root #waydroid init

[18:05:56] Downloading https://sourceforge.net/projects/waydroid/files/images/system/lineage/waydroid_x86_64/lineage-18.1-20250621-VANILLA-waydroid_x86_64-system.zip/download
[Downloading] 796.07 MB/796.13 MB    1748.68 kbps(approx.)[18:19:08] Validating system image
[18:19:08] Extracting to /var/lib/waydroid/images
[18:19:13] Downloading https://sourceforge.net/projects/waydroid/files/images/vendor/waydroid_x86_64/lineage-18.1-20250621-MAINLINE-waydroid_x86_64-vendor.zip/download
[Downloading] 196.41 MB/197.6 MB    1198.37 kbps(approx.)[18:21:07] Validating vendor image
[18:21:08] Extracting to /var/lib/waydroid/images

Starting the container

systemd

To start the Waydroid service on systemd systems, start the service first:

root #systemctl enable --now waydroid-container.service

Non-systemd

On init systems other than systemd, run:

root #waydroid container start

Starting the session

To start the session, in a non-root terminal:

user $waydroid session start