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.



Install InstructionsInstall and Run Android ApplicationsWaydroid command line optionsWaydroid Prop Options


Google Play CertificationDisable On-Screen KeyboardCommunity Projects We LikeGet Waydroid to work through a VMUsing ADB with WaydroidSetting up Waydroid only SessionsSetting up a shared folderColor correction in MutterBackup/Restore apps and dataUsing custom Waydroid imageshttps://github.com/waydroid/docs/blob/master/faq/install-system-app.md


Compile Waydroid - Lineage OS based imagesManual 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