Waydroid Image

Containerfile for building a Waydroid image.

This image is based on top of vanillaos/pico and offers a Waydroid installation.

Note

This is an experimental image providing Waydroid via Apx (distrobox). It still requires the binder_linux kernel module at the host side.

Build

Requirements

• Vib
• Podman or Docker

Build the image

vib build recipe.yml
podman image build -t vanillaos/waydroid .

Run

Requirements

• Podman or Docker
• Distrobox (suggested) 1
• binder_linux installed on host

Usage

Currently, the container needs to be rootfull, since it has to modprobe the needed kernel modules and mount the binder filesystem. This could change in the future.

distrobox create --root --init --unshare-all -i ghcr.io/vanilla-os/waydroid:main -n waydroid # replace with your local image if you built it
distrobox enter --root waydroid

Wait for the waydroid-init service to end, check with systemctl status waydroid-init. Then start using waydroid with 2:

ewaydroid --help

Note

• 1: At the time of writing, the --unshare-all option is not yet released so you need to use the latest version from git.

• 2: The ewaydroid script is a wrapper around waydroid that automatically points the XDG_RUNTIME_DIR and DBUS_SESSION_BUS_ADDRESS environment variables to the host ones. This is needed to make the waydroid services work by properly communicating with the host.