Skip to content

Latest commit

 

History

History
154 lines (94 loc) · 3.79 KB

install-on-desktops.md

File metadata and controls

154 lines (94 loc) · 3.79 KB

Install Instructions

Arch Linux

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

{% embed url="https://wiki.archlinux.org/title/Waydroid" %}

Postmarket OS

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

{% embed url="https://wiki.postmarketos.org/wiki/Waydroid" %}

Zorin OS

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

{% embed url="https://github.com/Aman9das/Waydroid_Setup_Guide" %}

Sailfish OS

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

{% embed url="https://github.com/sailfishos-open/waydroid" %}

Fedora

Waydroid can be installed from the official package repository.

sudo dnf install waydroid
sudo systemctl enable --now waydroid-container

After installing, launch Waydroid from the applications menu and procede 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

KISS Linux

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

{% embed url="https://github.com/Mederim/kiss-waydroid" %}

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

Ubuntu/Debian and derivatives

For Droidian and Ubuntu Touch, skip directly to the last step

  • Install pre-requisites
sudo apt install curl ca-certificates -y
  • Add the official repository
curl https://repo.waydro.id | sudo bash

If the script fails to detect your distribution, you can provide a valid option by appending -s <DISTRO>. Currently supported values are: focal, jammy, kinetic, lunar, mantic, bookworm, bullseye, sid

  • Install waydroid
sudo apt install waydroid -y

Then start Waydroid from the applications menu.

NixOS

NixOS community has a wiki page for WayDroid:

{% embed url="https://nixos.wiki/wiki/WayDroid" %}

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 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.