README.md

   1 # Waydroid
   2
   3 Waydroid uses a container-based approach to boot a full Android system on a
   4 regular GNU/Linux system like Ubuntu.
   5
   6 ## Overview
   7
   8 Waydroid uses Linux namespaces (user, pid, uts, net, mount, ipc) to run a
   9 full Android system in a container and provide Android applications on
  10 any GNU/Linux-based platform.
  11
  12 The Android system inside the container has direct access to any needed hardware.
  13
  14 The Android runtime environment ships with a minimal customized Android system
  15 image based on [LineageOS](https://lineageos.org/). The image is currently based
  16 on Android 11.
  17
  18 ## Documentation
  19
  20 Our documentation site can be found at [docs.waydro.id](https://docs.waydro.id)
  21
  22 ## Reporting bugs
  23
  24 If you have found an issue with Waydroid, please [file a bug](https://github.com/Waydroid/waydroid/issues/new).
  25
  26 ## Get in Touch
  27
  28 If you want to get in contact with the developers please feel free to join the
  29 *Waydroid* groups in [Matrix](https://matrix.to/#/#waydroid:matrix.org) or [Telegram](https://t.me/WayDroid).