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

shape shape

Main Features of Waydroid

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 (arm, arm64, x86, x86_64). The Android system inside the container has direct access to needed hardware through LXC and the binder interface.

Free and Open-Source

The Project is completely free and open-source, currently our repo is hosted on Github.

Full app integration

Waydroid integrated with Linux adding the Android apps to your linux applications folder.

Multi-window mode

Waydroid expands on Android freeform window definition, adding a number of features.

Full UI Mode

For gaming and full screen entertainment, Waydroid can also be run to show the full Android UI.

Near native performance

Get the best performance possible using wayland and AOSP mesa, taking things to the next level

Active community

Find out what all the buzz is about and explore all the possibilities Waydroid could bring

About Us

Get your favourite Android Apps on Linux.

Waydroid brings all the apps you love, right to your desktop, working side by side your Linux applications.
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 LineageOS. The used image is currently based on Android 10

Install Instructions

Our Documentation

Our documentation site can be found at docs.waydro.id

Bugs & Reports

Bug Reports can be filed on our repo Github Repo

Project Development

Our development repositories are hosted on Github

How to Install ?

Please refer to our installation docs for complete installation guide.

Manual Image Download

You can also manually download our images from

sourceforge logo SourceForge

Debian / Ubuntu Instructions

Installing Waydroid on Debian or Ubuntu can be done in just a few simple steps

Waydroid supports most common architectures (ARM, ARM64, x86 & x86_64 CPUs)

Waydroid uses Android's mesa integration for passthrough, and that enables support to most ARM/ARM64 SOCs on the mobile side, and Intel/AMD GPUs for the PC side. For Nvidia GPUs (except tegra) and VMs, we recommend using software-rendering

Waydroid has a growing community that has been contributing towards install and troubleshooting instructions for the various distros available. Please check the Install Documentation for further info.


  • python3
  • lxc
  • curl
  • Wayland session manager !!IMPORTANT!!

    • Replace DISTRO="bullseye" with your current target. Options: focal, bullseye, hirsute

      export DISTRO="bullseye" && \
      sudo curl https://repo.waydro.id/waydroid.gpg --output /usr/share/keyrings/waydroid.gpg && \ 
      echo "deb [signed-by=/usr/share/keyrings/waydroid.gpg] https://repo.waydro.id/ $DISTRO main" > ~/waydroid.list && \
      sudo mv ~/waydroid.list /etc/apt/sources.list.d/waydroid.list && \
      sudo apt update

      Then install Waydroid

      sudo apt install waydroid

      And start the init process:

      sudo waydroid init

      If download is slow, you can use barida's mirror for init:

      sudo waydroid init -c https://waydroid.bardia.tech/OTA/system -v https://waydroid.bardia.tech/OTA/vendor
      Running Waydroid

      After installing, you will want to start the waydroid-container service

      sudo systemctl start waydroid-container

      Then launch the waydroid app in full UI mode by running the Waydroid app in the app drawer, or through the terminal:

      waydroid show-full-ui

      For further instructions, please visit the docs site here

      Waydroid-Linux Beta


      Latest Beta  03.15.2022

      We have started creating a few fully-integrated distros in order to demonstrate some of the possibilities that Waydroid can help achieve.
      Each of the distros we produce will also showcase some of the work from our growing community of contributors.
      Our initial alpha releases of this integration started with Ubuntu 20.04 (focal) and is now on Ubuntu 21.10 (impish) as well as Debian 12 (bookworm), and includes many added tools and scripts to help open up what is possible.

      Waydroid-Linux currently only supports x86_64 CPUs (Intel/AMD)

      Waydroid-Linux uses Android's mesa integration for passthrough, and that restricts support to Intel and AMD GPUs
      For Nvidia GPUs and VMs, we recommend using software-rendering

      We have been working with a number of devs on Waydroid-Linux, and have been creating or contributing to a number of projects for it.
      Here are just a few of the projects we've been using:

      1. Waydroid-Linux Tools
        A few scripts, configs, and themes for the Waydroid-Linux builds
      2. Waydroid-Settings
        A GTK app written in Python to control Waydroid settings and expand with scripts (shell/py)
      3. Penguins-Eggs
        A tool used for packaging and installation of various Linux distros
      Live Mode Info
      Due to how Waydroid uses LXC and kernel modules for the binder, it will not work while running in live mode and must be installed before working properly. 
      Make sure to check the readme for the .iso, as it contains the specifics needed for each build. 

      Our Team

      Meet The Team

      Here are the members of our team

      shape shape
      Erfan Abdi
      Lead Developer
      shape shape
      Jon West
      shape shape
      Radek Błędowski