# General Troubleshooting

#### General tips

Waydroid is in rapid developement so if you face issues, here is a good list of steps to do first:

1. Make sure your Waydroid package is up to date;
2. Make sure you have the latest Waydroid image by running # waydroid upgrade;
3. Reset Waydroid:
   * stop the `waydroid-container.service` `# systemctl stop waydroid-container.service`
   * cleanup `sudo rm -rf /var/lib/waydroid /home/.waydroid ~/waydroid ~/.share/waydroid ~/.local/share/applications/*aydroid* ~/.local/share/waydroid`
   * initialise `# waydroid init -f` or `# waydroid init -f -i /usr/share/waydroid-extra/images`
   * start the service again `# systemctl start waydroid-container.service`

#### Failed to start Clipboard manager service

Install [pyclip](https://repology.org/project/python:pyclip/versions)

#### Sometimes the physical keyboard does not work

Press Left Alt key.

#### Commands inside Waydroid shell outputs inaccessible or not found

On Arch based distributions there's a "bug" that may appear while working with lxc-attach that may cause this issue with commands inside waydroid shell like adbd or settings. A possible workaround for this would be replace the `# waydroid shell` command with `# lxc-attach -P /var/lib/waydroid/lxc/ -n waydroid --clear-env`.

#### WARNING: Service manager /dev/binder has died

See <https://github.com/waydroid/waydroid/issues/136> You should enable [PSI](https://www.kernel.org/doc/html/latest/accounting/psi.html). Add `psi=1` to kernel command line.


---

# 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/debugging/troubleshooting.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.