> For the complete documentation index, see [llms.txt](https://docs.waydro.id/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.waydro.id/usage/install-on-desktops.md).

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

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

```bash
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`

```bash
rpm-ostree install waydroid
```

### openSUSE Tumbleweed/Slowroll

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

{% embed url="<https://github.com/waydroid/waydroid/discussions/1463>" %}

### 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!

```bash
sudo xbps-install -S waydroid
```

### Debian/Ubuntu and derivatives

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

{% embed url="<https://linuxconfig.org/how-to-enable-disable-wayland-on-ubuntu-22-04-desktop>" %}

#### 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](#install-waydroid).
* **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](#install-waydroid).
* **Other Debian/Ubuntu releases (older versions)**

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

  ```bash
  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](#install-waydroid) (or follow Droidian-specific instructions).
* **Ubuntu Touch**

  Waydroid is installed by default. Nothing else is needed.

#### Install Waydroid

```bash
sudo apt update
sudo apt install waydroid -y
```

Then start Waydroid from the applications menu.

### NixOS

NixOS community has a wiki page for WayDroid:

{% embed url="<https://wiki.nixos.org/wiki/Waydroid>" %}

## Troubleshooting

### Manually Starting Waydroid

To start Waydroid without systemctl, you need to follow a few simple steps

**Start the container first:**

```bash
sudo waydroid container start
```

**And in a new terminal tab, start the waydroid session (without** ***sudo*****):**

```bash
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)*

```bash
waydroid show-full-ui
```

### Launch Waydroid In Multi-Window Mode:

First we need to set the property while a Waydroid session is running:

```bash
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:

```bash
waydroid session stop
sudo waydroid container stop
```

Then it is safe to remove Waydroid. For example, on debian or ubuntu:

```bash
sudo apt remove waydroid
```

After you removed Waydroid, reboot.

Then once logged back in, we need to do a little cleanup:

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