Install Instructions
Last updated
Was this helpful?
Last updated
Was this helpful?
Some of our friends have started putting together all the install instructions for Arch over on the arch wiki:
Thanks to the Postmarket community, you can also find instructions and troubleshooting tips on their wiki:
User @Aman9das has put together a detailed guide for installing Waydroid on Zorin OS:
A few of the contributors to sailfishos-open have put together a resource for installing Waydroid on the OS:
Waydroid can be installed from the official package repository.
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
The same instructions apply to the Fedora Immutable variants, but you should use rpm-ostree
instead of dnf
User @runa-chin had created a detailed guide about installing Waydroid on openSUSE Tumbleweed or openSUSE Slowroll:
User Mederim has come up with a guide for getting Waydroid on KISS Linux:
Waydroid can be installed from the official package repository; also check /usr/share/doc/waydroid/README.voidlinux
after installation for further instructions!
For Droidian and Ubuntu Touch, skip directly to the last step
Make sure you have Wayland Session enabled (Ubuntu 22.04+)
Install pre-requisites
Add the official repository
If the script fails to detect your distribution, you can provide a valid option by appending -s <DISTRO>
. Currently supported values are: mantic, focal, jammy, kinetic, lunar, noble, bookworm, bullseye, trixie, sid
Install waydroid
Then start Waydroid from the applications menu.
NixOS community has a wiki page for WayDroid:
To start Waydroid without systemctl, you need to follow a few simple steps
Start the container first:
And in a new terminal tab, start the waydroid session (without sudo):
After that starts and you see "Android with user 0 is ready", it is safe to launch an app from the applications menu, or
(This can be run while Waydroid is running, or used to start it in full-screen mode)
First we need to set the property while a Waydroid session is running:
After that, we can restart the session:
Then we are ready to launch an app, and it will start in multi-window mode
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:
Then it is safe to remove Waydroid. For example, on debian or ubuntu:
After you removed Waydroid, reboot.
Then once logged back in, we need to do a little cleanup:
Then you can follow the install instructions again.