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


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. The used image is currently based on Android 11.



pageInstall InstructionspageInstall and Run Android ApplicationspageWaydroid command line optionspageWaydroid Prop Options


pageGoogle Play CertificationpageDisable On-Screen KeyboardpageCommunity Projects We LikepageGet Waydroid to work through a VMpageUsing ADB with WaydroidpageSetting up Waydroid only SessionspageSetting up a shared folderpageColor correction in MutterpageBackup/Restore apps and datapageUsing custom Waydroid imagesurlhttps://github.com/waydroid/docs/blob/master/faq/install-system-app.md


pageCompile Waydroid - Lineage OS based imagespageManual Patch Resolution

Reporting bugs

If you have found an issue with Waydroid, please file a bug.

Get in Touch

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


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.

Last updated