MirrorNest
← Все руководства

Waydroid

Run a full Android system in a lightweight container on Linux -- the actively maintained, Wayland-based successor to the now-deprecated Anbox project.

Система: Ubuntu / Debian / Arch / Fedora (Wayland session required)Android-emulationWaydroidcontainerОфициальный сайт ↗Официальная документация ↗
Это руководство составлено на основе официальной документации Waydroid, ссылка на которую есть выше — всегда сверяйте точные названия пакетов/версий там перед запуском этих команд на рабочем сервере, так как версии дистрибутива и проекта со временем меняются.

  1. 1Install Waydroid

    Waydroid is packaged for most major distributions (Ubuntu/Debian via its official repo, Arch via the AUR, Fedora via a COPR repo) -- Ubuntu shown here.

    curl https://repo.waydro.id/waydroid.gpg | sudo gpg --dearmor -o /usr/share/keyrings/waydroid.gpg
    echo "deb [signed-by=/usr/share/keyrings/waydroid.gpg] https://repo.waydro.id/ UBUNTU_CODENAME main" | sudo tee /etc/apt/sources.list.d/waydroid.list
    sudo apt update
    sudo apt install -y waydroid

    Replace UBUNTU_CODENAME with your release's codename (run `lsb_release -sc` to check it), e.g. 'noble' or 'jammy'.

  2. 2Initialize the Android image

    Downloads and sets up the actual Android system image (based on LineageOS) Waydroid will run inside its container.

    sudo waydroid init

  3. 3Start the Waydroid session

    sudo systemctl start waydroid-container
    waydroid show-full-ui

    Waydroid requires a Wayland session (not X11) to work -- it will fail to start a GUI session under a pure Xorg desktop.

  4. 4Install Android apps

    Waydroid ships without the Play Store by default. Sideload APKs directly, or install F-Droid/a Play Store alternative inside the Waydroid session the same way you would on a real Android device.

    waydroid app install /path/to/app.apk
    Waydroid official documentation ↗