MirrorNest
← Tous les guides

Waydroid

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

Système : Ubuntu / Debian / Arch / Fedora (Wayland session required)Android-emulationWaydroidcontainerSite officiel ↗Documentation officielle ↗
Ce guide est élaboré à partir de la documentation officielle de Waydroid, dont le lien figure ci-dessus — vérifiez toujours les noms exacts des paquets/versions avant d'exécuter ces commandes sur un serveur de production, car les versions de la distribution et du projet évoluent avec le temps.

  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 ↗