Install Instructions

Install Instructions

Arch Linux

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

Waydroid - ArchWikiwiki.archlinux.org

Postmarket OS

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

Waydroid - postmarketOS Wikiwiki.postmarketos.org

Zorin OS

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

GitHub - Aman9das/Waydroid_Setup_GuideGitHub

Sailfish OS

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

GitHub - sailfishos-open/waydroid: Waydroid packaging for Sailfish OSGitHub

Fedora

Waydroid can be installed from the official package repository.

sudo dnf install waydroid

After installing, launch Waydroid from the applications menu and proceed with the initialization by pasting these URLs in the OTA fields:

System OTA: https://ota.waydro.id/system

Vendor OTA: https://ota.waydro.id/vendor

Silverblue/Kinoite/...

The same instructions apply to the Fedora Immutable variants, but you should use rpm-ostree instead of dnf

rpm-ostree install waydroid

openSUSE Tumbleweed/Slowroll

User @runa-chin had created a detailed guide about installing Waydroid on openSUSE Tumbleweed or openSUSE Slowroll:

My own guide for WayDroid install on openSUSE Tumbleweed (back working) and openSUSE Slowroll · waydroid waydroid · Discussion #1463GitHub

KISS Linux

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

GitHub - Mederim/kiss-waydroid: kiss repo to package waydroidGitHub

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

Debian/Ubuntu and derivatives

[!NOTE] Make sure you have Wayland Session enabled (Ubuntu 22.04+)

Make sure Waydroid is available in your distribution:

• Debian 14+ & Ubuntu 26.10+ and distros which are based on those

  Waydroid is available in the official repository. → Skip the repository setup and go directly to Installation.

• Debian 13 (Trixie)

  Waydroid is available in the backports repository. Enable backports by editing your apt source file, then update apt. → Skip the third-party repo and go directly to Installation.

• Other Debian/Ubuntu releases (older versions)

  You must enable the third-party Waydroid repository. First, install prerequisites and add the official Waydroid repo:

  Copy

  sudo apt install curl ca-certificates -y
  curl -s https://repo.waydro.id | sudo bash

  If the script fails to detect your distribution, append -s <DISTRO>. Supported values: mantic, focal, jammy, kinetic, lunar, noble, plucky, questing, bookworm, bullseye, trixie, sid

• Droidian

  Skip all the steps above and go directly to Installation (or follow Droidian-specific instructions).

• Ubuntu Touch

  Waydroid is installed by default. Nothing else is needed.

Install Waydroid

sudo apt update
sudo apt install waydroid -y

Then start Waydroid from the applications menu.

NixOS

NixOS community has a wiki page for WayDroid:

Waydroid - Official NixOS Wikiwiki.nixos.org

Troubleshooting

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 session:

waydroid session stop

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.