Skip to main content

Waydroid Setup and Customization Guide

1. Force Initialize Waydroid​

To initialize Waydroid forcefully, use the following command:

sudo waydroid init -f

2. Install a Custom Image​

To use a custom LineageOS image, follow these steps:

  1. Create the required directory: 
    sudo mkdir -p /etc/waydroid-extra/images
  2. Extract the system and vendor images: 
    sudo unzip lineage-*-system.zip -d /etc/waydroid-extra/images
    sudo unzip lineage-*-vendor.zip -d /etc/waydroid-extra/images
  3. Remove the original zip files to save space: 
    rm lineage-*-system.zip lineage-*-vendor.zip

3. Managing Waydroid Sessions and Containers​

Before making changes, stop Waydroid's session and container:

sudo waydroid session stop
sudo waydroid container stop

4. Configure Firewall Rules​

Allow necessary DNS traffic for Waydroid:

sudo ufw allow 67
sudo ufw allow 53

Enable packet forwarding:

sudo ufw default allow FORWARD

5. Running Weston with a Custom Socket​

To ensure Weston only composes Waydroid and not other applications, use:

weston --socket=mysocket &

This prevents non-Android applications from opening inside the Weston window.

6. Adding Google Play Device ID​

Visit Google's uncertified device registration page to register your device.

To retrieve your Android ID from Waydroid, run:

ANDROID_RUNTIME_ROOT=/apex/com.android.runtime \
ANDROID_DATA=/data \
ANDROID_TZDATA_ROOT=/apex/com.android.tzdata \
ANDROID_I18N_ROOT=/apex/com.android.i18n \
sqlite3 /data/data/com.google.android.gsf/databases/gservices.db \
"select * from main where name = \"android_id\";"

7. Restarting Waydroid​

Restart the Waydroid container and session as needed:

sudo waydroid container stop
sudo waydroid container start
waydroid session start

To restart the container after installing a new image:

systemctl restart waydroid-container.service

8. Debugging Commands​

Check the Wayland socket:

ls /run/user/1000/

Look for entries like wayland-0, wayland-1, etc., along with a .lock file.

If needed, manually set the Wayland display:

export WAYLAND_DISPLAY=wayland-X