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

### Ubuntu/Debian and derivatives

For Droidian, skip directly to the last step

For Ubuntu Touch, these steps are not needed

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>" %}

* Install pre-requisites

```bash
sudo apt install curl ca-certificates -y
```

* Add the official repository

```bash
curl -s 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: **mantic**, **focal**, **jammy**, **kinetic**, **lunar**, **noble**, **plucky**, **questing**, **bookworm**, **bullseye**, **trixie**, **sid**

* Install waydroid

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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.waydro.id/usage/install-on-desktops.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.