sudo cp /path/to/extracted/system.img /var/lib/waydroid/images/ sudo cp /path/to/extracted/vendor.img /var/lib/waydroid/images/ sudo chmod 644 /var/lib/waydroid/images/*.img If you skip this, cached Google services will crash.

Example: lineage-20.0-waydroid_arm64_gapps-13.0-20240915.zip

Introduction: The Linux Android Dilemma For years, running Android applications on Linux has been a journey through a minefield of slow emulators, buggy compatibility layers, and incomplete experiences. Enter Waydroid —a container-based method that runs a full Android system directly on your Linux distribution using the LXC (Linux Containers) technology. It offers near-native performance, GPU acceleration, and seamless window integration.

To use it:

sudo mv /var/lib/waydroid/images/system.img /var/lib/waydroid/images/system.img.aosp sudo mv /var/lib/waydroid/images/vendor.img /var/lib/waydroid/images/vendor.img.aosp Copy the new Gapps images:

sudo rm -rf /var/lib/waydroid/data/* sudo systemctl start waydroid-container waydroid show-full-ui You will now see the Google Setup Wizard. Sign in with your Google account. Step 8: Finalize with waydroid_script (Optional but Recommended) Run the script to fix permissions and install missing components (e.g., libhoudini for ARM translation):

However, there is a catch. By default, Waydroid ships as an build. While AOSP is powerful and free, it is barren regarding proprietary Google software. You get the AOSP browser, a basic launcher, and a simple dialer—but no Play Store, no Gmail, no Google Maps, and no notifications from Google Mobile Services (GMS).

waydroid session stop sudo systemctl stop waydroid-container Back up the original images: