Usage
FAQ
Development
Install Instructions
Arch Linux
Some of our friends have started putting together all the install instructions for Arch over on the arch wiki:
Waydroid - ArchWiki
Postmarket OS
Thanks to the Postmarket community, you can also find instructions and troubleshooting tips on their wiki:
Waydroid - postmarketOS
Mobian
The community was kind enough to post the install instructions for Mobian on their Doku pages:
waydroid [Mobian Wiki]
Zorin OS
User @Aman9das has put together a detailed guide for installing Waydroid on Zorin OS:
GitHub - Aman9das/Waydroid_Setup_Guide
GitHub
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 OS
GitHub
Fedora
User Aleasto has put together a nice guide for Fedora that does not require a 3rd party kernel install:
aleasto/waydroid
Copr
Otherwise, Karuboniru's blog post details the steps needed to get Waydroid up and running with kernel modifications:
Waydroid on Fedora
Karuboniru's Blog
KISS Linux
User Mederim has come up with a guide for getting Waydroid on KISS Linux:
GitHub - Mederim/kiss-waydroid: kiss repo to package waydroid
GitHub
Ubuntu/Debian Based Install Instructions
Installation
These instructions work for ubuntu focal, ubuntu hirsute, debian bullseye, droidian, ubports, and likely more. We will continue to update this document as the project further develops
Install Pre-requisites
1
sudo apt install curl -y
Copied!
Waydroid requires the following in order to work properly on your PC:
- python3
- lxc
- curl
- Wayland session manager IMPORTANT!!
NOTES:
Install Waydroid
Install ca-certificates, if not already installed.
1
sudo apt install ca-certificates
Copied!
Check your distro (codename) for the next step
1
lsb_release -c
Copied!
Add the repo to your
sources.list- Add waydroid repo (for droidian & ubports, this step can be skipped) Replace
DISTRO="bullseye"with your current target. Options: focal, bullseye, hirsute
1
export DISTRO="bullseye" && \
2
sudo curl -# --proto '=https' --tlsv1.2 -Sf https://repo.waydro.id/waydroid.gpg --output /usr/share/keyrings/waydroid.gpg && \
3
echo "deb [signed-by=/usr/share/keyrings/waydroid.gpg] https://repo.waydro.id/ $DISTRO main" > ~/waydroid.list && \
4
sudo mv ~/waydroid.list /etc/apt/sources.list.d/waydroid.list && \
5
sudo apt update
Copied!
install Waydroid:
1
sudo apt install waydroid -y
Copied!
And start the init process:
1
sudo waydroid init
Copied!
Then start the waydroid container service (or just simply reboot):
1
sudo systemctl start waydroid-container
Copied!
Troubleshooting
Manually Starting Waydroid
To start Waydroid without systemctl, you need to follow a few simple steps
Start the container first:
1
sudo waydroid container start
Copied!
And in a new terminal tab, start the waydroid session (without sudo):
1
waydroid session start
Copied!
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)
1
waydroid show-full-ui
Copied!
Launch Waydroid In Multi-Window Mode:
First we need to set the property while a Waydroid session is running:
1
waydroid prop set persist.waydroid.multi_windows true
Copied!
After that, we can restart the container:
1
sudo systemctl restart waydroid-container
Copied!
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:
1
waydroid session stop
2
sudo waydroid container stop
Copied!
Then it is safe to remove Waydroid:
1
sudo apt remove waydroid
Copied!
After you remove Waydroid, reboot.
Then once logged back in, we need to do a little cleanup:
1
sudo rm -rf /var/lib/waydroid /home/.waydroid ~/waydroid ~/.share/waydroid ~/.local/share/applications/*aydroid* ~/.local/share/waydroid
Copied!
Then can reinstall and run the init command again:
1
sudo apt install waydroid
2
sudo waydroid init
Copied!
Last modified 1mo ago
Copy link