Installer Waydroid sur Linux Mint : Android sur votre PC, avec ou sans Google

Waydroid fait tourner un vrai Android (LineageOS 20, soit Android 13) directement sur votre PC Linux, sans émulateur lourd. Dans ce tutoriel, on l’installe sur Linux Mint 22.3, avec le Google Play Store officiel et F-Droid.

Contrairement à un émulateur classique, Waydroid utilise un conteneur LXC : Android partage le noyau de votre machine. Résultat : un démarrage en quelques secondes et des performances proches du natif. Le tout a été testé sur un PC réel, avec les pièges rencontrés en chemin et leurs solutions.

Prérequis

Une distribution basée sur Ubuntu 24.04 (Linux Mint 22.x, Ubuntu, Pop!_OS…), un processeur x86_64 et environ 3 Go d’espace disque suffisent.

• Noyau avec binder : les noyaux Ubuntu récents fournissent le module binder_linux, indispensable à Android.
• Wayland ou X11 : Waydroid a besoin d’une session Wayland. Linux Mint (Cinnamon) tourne en X11 par défaut : on contournera cela avec Weston, qui ouvre une fenêtre Wayland dans votre bureau X11.
• Les droits administrateur (sudo).

Pour vérifier votre type de session :

echo $XDG_SESSION_TYPE

Étape 1 : installer Waydroid depuis le dépôt officiel

Le projet fournit un script qui ajoute sa clé GPG et son dépôt APT. Il détecte la base Ubuntu de Linux Mint (noble) tout seul.

sudo apt install curl ca-certificates
curl -s https://repo.waydro.id | sudo bash
sudo apt install waydroid

Vérifiez l’installation avec waydroid --version (version 1.6.3 au moment de l’écriture).

Étape 2 : activer le module binder

Android communique entre ses composants via binder. On charge le module, puis on le rend permanent pour qu’il revienne à chaque démarrage.

sudo modprobe binder_linux devices="binder,hwbinder,vndbinder"
echo binder_linux | sudo tee /etc/modules-load.d/waydroid-binder.conf
echo 'options binder_linux devices=binder,hwbinder,vndbinder' | sudo tee /etc/modprobe.d/waydroid-binder.conf

Activez ensuite le service du conteneur :

sudo systemctl enable --now waydroid-container

Étape 3 : télécharger l’image Android (sans Google)

La commande waydroid init télécharge l’image système LineageOS et l’image vendor, soit environ 2,3 Go une fois décompressées. Par défaut, c’est l’image VANILLA, sans aucun service Google : exactement ce qu’on veut.

sudo waydroid init

Si le téléchargement s’interrompt sur une erreur SSL (DECRYPTION_FAILED_OR_BAD_RECORD_MAC), c’est un incident réseau passager côté SourceForge : relancez simplement la commande.

Variante : avec le Google Play Store

Si vous voulez le Play Store et les services Google, téléchargez plutôt l’image GAPPS. L’option -f remplace une image déjà installée.

sudo waydroid init -s GAPPS -f

Avec cette image, l’étape 5 (F-Droid) est facultative. Il faudra en revanche déclarer l’appareil auprès de Google : voir l’étape 4 bis.

Étape 4 : lancer Android sous X11 avec Weston

En session X11, Waydroid refuse de démarrer faute de compositeur Wayland. La solution : Weston, un compositeur Wayland léger qui s’ouvre comme une simple fenêtre.

sudo apt install weston

Créez ensuite un petit script de lancement ~/.local/bin/waydroid-x11 :

#!/usr/bin/env bash
# Lance Waydroid dans une fenêtre Weston (session X11).
SOCK=waydroid-weston
unset WAYLAND_DISPLAY
weston --backend=x11-backend.so --socket="$SOCK" --width=1280 --height=800 &
WPID=$!
# Attendre que le socket Wayland soit créé (10 s max)
for _ in $(seq 50); do
  [ -S "$XDG_RUNTIME_DIR/$SOCK" ] && break
  kill -0 $WPID 2>/dev/null || { echo "Weston n'a pas démarré"; exit 1; }
  sleep 0.2
done
export WAYLAND_DISPLAY=$SOCK
waydroid show-full-ui
waydroid session stop
kill $WPID 2>/dev/null

Rendez-le exécutable et lancez-le :

chmod +x ~/.local/bin/waydroid-x11
~/.local/bin/waydroid-x11

Deux détails comptent. L’option --backend=x11-backend.so force Weston à s’ouvrir dans X11 : sans elle, si WAYLAND_DISPLAY est défini, il cherche un compositeur Wayland parent et plante. La boucle d’attente évite de lancer Android avant que Weston soit prêt. Si vous êtes déjà sous Wayland (GNOME, KDE), un simple waydroid show-full-ui suffit.

Dépannage : les quatre pièges rencontrés

Sur notre machine de test, Android n’a pas fonctionné du premier coup. Voici les symptômes et leurs correctifs.

Image brouillée avec deux cartes graphiques

Listez vos GPU avec ls -l /dev/dri/by-path/. Repérez celui qui affiche votre bureau (le journal de Weston l’indique : Using rendering device: /dev/dri/renderD129), puis ajoutez-le dans la section [waydroid] de /var/lib/waydroid/waydroid.cfg :

drm_device = /dev/dri/renderD129

Appliquez avec sudo waydroid upgrade --offline puis sudo systemctl restart waydroid-container.

Le réseau de Waydroid ne démarre pas

Lancez le script réseau à la main pour voir l’erreur exacte :

sudo bash -x /usr/lib/waydroid/data/scripts/waydroid-net.sh start

Si vous lisez dnsmasq: failed to create listening socket for 192.168.240.1: Adresse déjà utilisée, un serveur DNS local écoute sur toutes les interfaces. Avec BIND, ajoutez dans /etc/bind/named.conf.options, à l’intérieur du bloc options :

listen-on { !192.168.240.1; any; };

Puis sudo named-checkconf && sudo systemctl reload named.

Pas d’Internet dans Android (Docker installé)

Docker bloque par défaut le trafic transféré des autres réseaux. Créez le fichier /etc/systemd/system/waydroid-container.service.d/docker-forward.conf :

[Service]
ExecStartPre=-/bin/sh -c 'iptables -N DOCKER-USER 2>/dev/null; for d in -i -o; do iptables -C DOCKER-USER $d waydroid0 -j ACCEPT 2>/dev/null || iptables -I DOCKER-USER $d waydroid0 -j ACCEPT; done'

Puis sudo systemctl daemon-reload && sudo systemctl restart waydroid-container. Les règles sont ainsi remises à chaque démarrage.

Heure décalée

Android démarre en GMT. Corrigez le fuseau pendant qu’Android tourne :

sudo waydroid shell -- setprop persist.sys.timezone Europe/Paris

Étape 4 bis : déclarer l’appareil auprès de Google (image GAPPS)

Avec l’image GAPPS, le Play Store signale d’abord un « appareil non certifié ». Sans déclaration, certaines applis restent introuvables ou refusent de démarrer.

1. Lancez Android et vérifiez qu’il a accès à Internet.

2. Dans un second terminal, récupérez l’identifiant de l’appareil :

   sudo waydroid shell -- sh -c "sqlite3 /data/data/com.google.android.gsf/databases/gservices.db 'select value from main where name = \"android_id\";'"

3. Collez ce numéro sur google.com/android/uncertified, connecté avec votre compte Google.

4. Attendez 10 à 20 minutes, puis redémarrez Android : waydroid session stop, puis relancez le script.

5. Ouvrez le Play Store et connectez-vous.

Si la commande ne renvoie rien, les services Google n’ont pas encore créé l’identifiant. C’est presque toujours qu’Android n’a pas Internet (voir le dépannage plus haut) : corrigez, attendez une minute et recommencez.

Étape 5 : installer F-Droid

Cette étape et la suivante concernent surtout l’image sans Google. F-Droid est un magasin d’applications libres et open source, sans compte ni pistage. On télécharge son APK depuis le site officiel, puis on l’installe depuis Linux, pendant qu’Android tourne dans sa fenêtre.

wget https://f-droid.org/F-Droid.apk
waydroid app install F-Droid.apk

L’icône F-Droid apparaît dans le tiroir d’applications d’Android. Au premier lancement, laissez-le mettre à jour ses dépôts : cela prend une minute environ. Android vous demandera aussi d’autoriser F-Droid à installer des applications : acceptez.

En résumé

En une trentaine de minutes, vous obtenez un Android 13 complet sur votre PC, avec le Play Store ou, si vous préférez vous passer de Google, avec F-Droid et Aurora Store. Les commandes à garder sous la main :

Pour revenir en arrière, sudo apt remove waydroid désinstalle le paquet, et sudo rm -rf /var/lib/waydroid ~/.local/share/waydroid efface les images et les données Android.

Sources

• Documentation officielle de Waydroid
• F-Droid
• Aurora Store sur F-Droid