MirrorNest
← Todos os guias

Waydroid

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

Destino: Ubuntu / Debian / Arch / Fedora (Wayland session required)Android-emulationWaydroidcontainerSite oficial ↗Documentação oficial ↗
Este guia foi elaborado a partir da documentação oficial do Waydroid, ligada acima — verifique sempre lá os nomes exatos dos pacotes/versões antes de executar estes comandos num servidor de produção, uma vez que as versões da distribuição e do projeto mudam com o tempo.

  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 ↗