Waydroid

Waydroid on Arch Linux: Install, Binder Kernel and Fixes

On Arch Linux, Waydroid lives in the official extra repository, so installing it takes one command. The part that trips people up is the kernel. This guide covers both, plus the fixes Arch users hit most often.

  • Guide 06
  • By Waydroid.org Editorial Team
  • Updated 11 November 2026
  • 8 min read
Illustrated cover: Waydroid on Arch Linux: Install, Binder Kernel and Fixes

What you need on Arch

  • An up-to-date Arch system (also EndeavourOS, Manjaro and other Arch-based distros)
  • A Wayland session: KDE Plasma, GNOME, Sway, Hyprland or similar
  • A kernel with binder support
  • Intel or AMD graphics for hardware acceleration

Step 1: Get a kernel with binder support

The stock linux kernel may not include binder in a form Waydroid can use. The simplest option many Arch users choose is the linux-zen kernel, which ships binder support:

sudo pacman -S linux-zen linux-zen-headers

Update your bootloader entries, reboot and pick the zen kernel. Prefer your current kernel? The ArchWiki's Waydroid page covers building binder as a DKMS module instead.

Step 2: Install Waydroid from extra

sudo pacman -Syu
sudo pacman -S waydroid

At the time of writing, extra carries Waydroid 1.6.3. Older guides tell you to use the AUR (yay -S waydroid), but that's no longer necessary.

Step 3: Initialise and start

sudo waydroid init -s GAPPS     # or: sudo waydroid init
sudo systemctl enable --now waydroid-container
waydroid session start
waydroid show-full-ui

Prefer images managed as packages? The AUR has a waydroid-image package with LineageOS-based images for Waydroid.

Arch-specific fixes

ProblemFix
Container fails, binder errorsBoot the linux-zen kernel (or load binder modules) and check with uname -r
dnsmasq: failed to open pidfile … Permission deniedAppArmor rule missing: allow @{run}/waydroid-lxc/ read and @{run}/waydroid-lxc/* read/write
No network inside AndroidAllow DNS/DHCP and forwarding for the waydroid0 bridge in your firewall (nftables, ufw or firewalld)
Black screen on NVIDIAUse the iGPU or software rendering as described on the ArchWiki
Runs on X11 onlySwitch to a Wayland session, or nest Waydroid in cage or weston

Using Waydroid on Hyprland and Sway

Tiling compositors work well with Waydroid's multi-window mode. Each Android app becomes a normal window you can tile or float. If the full UI opens at an awkward size, adjust it with Waydroid properties, for example waydroid prop set persist.waydroid.width 1280, then restart the session.

Optional extras worth installing

  • wl-clipboard for reliable clipboard sharing on Wayland
  • A Python helper script for ARM translation (libndk/libhoudini) if you need ARM-only apps on x86_64
  • waydroid-image (AUR) if you'd rather manage Android images as a package than download them with waydroid init

Checking binder before you start

Before you initialise Waydroid, confirm the kernel provides binder:

uname -r                      # should show -zen if you use linux-zen
ls /dev/binderfs 2>/dev/null || ls /dev | grep binder
sudo systemctl status waydroid-container

If the container service fails, its status output and waydroid log usually point straight at a binder or network problem.

Keeping it healthy

  • Update with sudo pacman -Syu; Waydroid updates with the system.
  • After kernel changes, confirm binder still loads before you start Waydroid.
  • Back up ~/.local/share/waydroid before switching images.

Gaming on a handheld? Continue to Waydroid Steam Deck.

Get Waydroid 1.6.3

Free, open source and built for Linux desktops.

Download Waydroid