Gapps Image - Waydroid

Unmount and ensure image is saved:

sudo umount /mnt/wayroot

If you edited an extracted folder used by Waydroid, ensure Waydroid uses that modified rootfs (move to Waydroid’s expected location or point Waydroid to it).

Start Waydroid:

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

Or use waydroid CLI: waydroid start

sudo waydroid session stop
sudo waydroid container stop
sudo rm -rf /var/lib/waydroid /home/.waydroid

sudo apt install wget unzip squashfs-tools
mkdir ~/wdg && cd ~/wdg
wget <waydroid-rootfs.tar.xz>
tar -xf waydroid-rootfs.tar.xz
wget <opengapps-arm64-11-pico.zip>
unzip opengapps.zip -d opengapps

sudo mount -o bind $(pwd)/rootfs /mnt/wayroot
sudo rsync -a opengapps/system/ /mnt/wayroot/system/
sudo chown -R root:root /mnt/wayroot/system
sudo umount /mnt/wayroot

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

Instead of letting Waydroid download vanilla images, point it to your Gapps images:

sudo waydroid init -f -i ~/waydroid-images/waydroid_android13_gapps_system.img -v ~/waydroid-images/waydroid_android13_vendor.img

Unlike standard Waydroid images (which are plain Android Open Source Project), GAPPS images are not officially provided by the Waydroid team due to licensing issues.

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

You will now see the Google Setup Wizard. Sign in with your Google account. waydroid gapps image

Without GAPPS, many common Android apps either crash or refuse to run.

Yes, if:

No, if:

The Waydroid Gapps image is the final puzzle piece in turning Waydroid from a tech demo into a daily-driver Android environment. By following this guide, downloading a verified image, and applying the post-setup tweaks, you can enjoy the best of both worlds: the freedom of Linux and the ecosystem of Google.

Further Resources:

Last updated: May 2026 – Commands and image URLs verified for Android 13 and 14 Gapps images. Unmount and ensure image is saved: sudo umount