> 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/readme.md).

# Waydroid

Waydroid is a container-based approach to boot a full Android system on a regular GNU/Linux system like Ubuntu.

## Overview

Waydroid uses Linux namespaces (user, pid, uts, net, mount, ipc) to run a full Android system in a container and provide Android applications on any GNU/Linux-based platform.

The Android inside the container has direct access to needed hardwares.

The Android runtime environment ships with a minimal customized Android system image based on the [LineageOS](https://lineageos.org). The used image is currently based on Android 13.

## Index

### Usage

{% content-ref url="/pages/-MiqooCqYSCO4quxrEfa" %}
[Install Instructions](/usage/install-on-desktops.md)
{% endcontent-ref %}

{% content-ref url="/pages/-MiYHgF90eAl\_ZbsWUjb" %}
[Install and Run Android Applications](/usage/install-and-run-android-applications.md)
{% endcontent-ref %}

{% content-ref url="/pages/-MisgOCSCxT0\_edk04yu" %}
[Waydroid command line options](/usage/waydroid-command-line-options.md)
{% endcontent-ref %}

{% content-ref url="/pages/-MknoF7N\_hT2pIDy9Mtf" %}
[Waydroid Prop Options](/usage/waydroid-prop-options.md)
{% endcontent-ref %}

### FAQ

{% content-ref url="/pages/i0wGYwHnt9fZSAGcMqIf" %}
[Google Play Certification](/faq/google-play-certification.md)
{% endcontent-ref %}

{% content-ref url="/pages/-MjQnjSbUHB8yZFfN1t\_" %}
[Disable On-Screen Keyboard](/faq/disable-on-screen-keyboard.md)
{% endcontent-ref %}

{% content-ref url="/pages/Vr15fKR3hVa2m37eXWIO" %}
[Disable Touch Sounds](/faq/disable-touch-sounds.md)
{% endcontent-ref %}

{% content-ref url="/pages/6DqDz713fj8RVrkN1aa9" %}
[Community Projects We Like](/faq/community-projects-we-like.md)
{% endcontent-ref %}

{% content-ref url="/pages/KcHFOV3UI3fEIdMORiYX" %}
[Get Waydroid to work through a VM](/faq/get-waydroid-to-work-through-a-vm.md)
{% endcontent-ref %}

{% content-ref url="/pages/EDAH4FhdatxaDzy3suwf" %}
[Using ADB with Waydroid](/faq/using-adb-with-waydroid.md)
{% endcontent-ref %}

{% content-ref url="/pages/FA4IWEXPGieRos9Z4amV" %}
[Setting up Waydroid only Sessions](/faq/setting-up-waydroid-only-sessions.md)
{% endcontent-ref %}

{% content-ref url="/pages/V9aZIQVsprItoQ0Z3YDQ" %}
[Setting up a shared folder](/faq/setting-up-a-shared-folder.md)
{% endcontent-ref %}

{% content-ref url="/pages/AHE0I8hOEuuFe5auwH4z" %}
[Color correction in Mutter](/faq/color-correction-in-mutter.md)
{% endcontent-ref %}

{% content-ref url="/pages/zAToVLGrcBiPYmUoZP8D" %}
[Backup/Restore apps and data](/faq/backup-restore-apps-and-data.md)
{% endcontent-ref %}

{% content-ref url="/pages/MAslYADnaJLqrW8IzSB0" %}
[Using custom Waydroid images](/faq/using-custom-waydroid-images.md)
{% endcontent-ref %}

{% content-ref url="<https://github.com/waydroid/docs/blob/master/faq/install-system-app.md>" %}
<https://github.com/waydroid/docs/blob/master/faq/install-system-app.md>
{% endcontent-ref %}

### Development

{% content-ref url="/pages/-MiYZqVH0PdAbUWK5maT" %}
[Compile Waydroid - Lineage OS based images](/development/compile-waydroid-lineage-os-based-images.md)
{% endcontent-ref %}

{% content-ref url="/pages/-MiqcWTO-Dum4MX10zdL" %}
[Manual Patch Resolution](/development/manual-patch-resolution.md)
{% endcontent-ref %}

### Help improve this page

You may help improve this page by opening a pull request to the [docs repo](https://github.com/waydroid/docs)

### Licensing

{% content-ref url="<https://github.com/waydroid/docs/blob/master/licensing/licensing.md>" %}
<https://github.com/waydroid/docs/blob/master/licensing/licensing.md>
{% endcontent-ref %}

## Reporting bugs

If you have found an issue with Waydroid, please [file a bug](https://github.com/waydroid/waydroid/issues/new/choose).

## Get in Touch

If you want to get in contact with the developers please feel free to join the *Waydroid* groups in

* [Matrix](https://matrix.to/#/#waydroid:matrix.org)
* [Telegram](https://t.me/WayDroid)
* [Reddit](https://www.reddit.com/r/waydroid/)

## Credits

We'd like to say thanks to all these great teams & projects: @Anbox @LineageOS @Android-x86 @spurv @LXC and many others, for you still lead the way for Open Innovation in Linux and the Android community.