Install Instructions

Arch Linux

Some of our friends have started putting together all the install instructions for Arch over on the arch wiki:

Postmarket OS

Thanks to the Postmarket community, you can also find instructions and troubleshooting tips on their wiki:


The community was kind enough to post the install instructions for Mobian on their Doku pages:

Zorin OS

User @Aman9das has put together a detailed guide for installing Waydroid on Zorin OS:

Sailfish OS

A few of the contributors to sailfishos-open have put together a resource for installing Waydroid on the OS:


Use aleasto copr:

KISS Linux

User Mederim has come up with a guide for getting Waydroid on KISS Linux:

Void Linux

Waydroid can be installed from the official package repository; also check /usr/share/doc/waydroid/README.voidlinux after installation for further instructions!
sudo xbps-install -S waydroid


  • Install the required kernel modules:
  • Load other required modules:
echo "nft_xfrm" | sudo tee -a /etc/modules-load.d/waydroid.conf
sudo modprobe nft_xfrm
  • Follow the install instructions for Ubuntu below

Ubuntu/Debian and derivatives

Install Pre-requisites

sudo apt install curl ca-certificates -y

Install Waydroid

  • Add the repo to your sources.list (for droidian & ubports, this step can be skipped) Replace DISTRO="jammy" with your current target. Options: focal, jammy, ubuntu-devel, bookworm, bullseye, sid
export DISTRO="jammy"
sudo curl --proto '=https' --tlsv1.2 -Sf --output /usr/share/keyrings/waydroid.gpg
echo "deb [signed-by=/usr/share/keyrings/waydroid.gpg] $DISTRO main" | sudo tee /etc/apt/sources.list.d/waydroid.list
sudo apt update
  • Install waydroid:
sudo apt install waydroid -y
Then start Waydroid from the applications menu.


Manually Starting Waydroid

To start Waydroid without systemctl, you need to follow a few simple steps
Start the container first:
sudo waydroid container start
And in a new terminal tab, start the waydroid session (without sudo):
waydroid session start
After that starts and you see "Android with user 0 is ready", it is safe to launch an app from the applications menu, or

Launch Waydroid In Full-Screen Mode:

(This can be run while Waydroid is running, or used to start it in full-screen mode)
waydroid show-full-ui

Launch Waydroid In Multi-Window Mode:

First we need to set the property while a Waydroid session is running:
waydroid prop set persist.waydroid.multi_windows true
After that, we can restart the container:
sudo systemctl restart waydroid-container
Then we are ready to launch an app, and it will start in multi-window mode

Reinstalling Waydroid

Sometimes things don't go as planned and you need to remove it all and start over. To do that, follow the steps below:
First, make sure you have stopped the session and containers:
waydroid session stop
sudo waydroid container stop
Then it is safe to remove Waydroid. For example, on debian or ubuntu:
sudo apt remove waydroid
After you removed Waydroid, reboot.
Then once logged back in, we need to do a little cleanup:
sudo rm -rf /var/lib/waydroid /home/.waydroid ~/waydroid ~/.share/waydroid ~/.local/share/applications/*aydroid* ~/.local/share/waydroid
Then you can follow the install instructions again.