Install Instructions
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:
The community was kind enough to post the install instructions for Mobian on their Doku pages:
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:
Use aleasto copr:
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!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
sudo apt install curl ca-certificates -y
- Add the repo to your
sources.list(for droidian & ubports, this step can be skipped) ReplaceDISTRO="jammy"with your current target. Options: focal, jammy, ubuntu-devel, bookworm, bullseye, sid
export DISTRO="jammy"
sudo curl --proto '=https' --tlsv1.2 -Sf https://repo.waydro.id/waydroid.gpg --output /usr/share/keyrings/waydroid.gpg
echo "deb [signed-by=/usr/share/keyrings/waydroid.gpg] https://repo.waydro.id/ $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.
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
(This can be run while Waydroid is running, or used to start it in full-screen mode)
waydroid show-full-ui
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
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.
Last modified 13d ago