Welcome to Waydroid

Waydroid is a container-based solution for booting a complete Android system on a standard GNU/Linux distribution. This approach allows Android applications to run seamlessly alongside native Linux applications.

Overview

At its core, Waydroid leverages Linux namespaces (user, pid, uts, net, mount, ipc) and LXC to create an isolated container. Within this container, a full Android system operates, providing a comprehensive environment for running Android applications. A key advantage of this architecture is that the Android system has direct access to necessary hardware, eliminating performance bottlenecks often associated with emulation.

The Android environment is built upon a minimal, customized system image based on LineageOS, currently targeting Android 13.

Key Features

  • Container-Based Isolation: Uses Linux namespaces and LXC for efficient system containerization.
  • Direct Hardware Access: Provides near-native performance by allowing the Android container to directly access hardware resources.
  • Desktop Integration: Android apps appear as regular desktop windows, integrating with the host environment.
  • LineageOS Base: Utilizes a modern and well-maintained Android distribution as its foundation.

Community and Support

If you encounter issues or have questions, the Waydroid community and developers are available to help.