Waydroid

https://docs.waydro.id
Admin
Waydroid is a container-based approach that uses Linux namespaces to run a full Android system in a...
Tokens:15,225
Snippets:221
Trust Score:9.3
Update:6 days ago
Show doc for...
Tokens:
Raw
### Start Waydroid Container

Source: https://docs.waydro.id/usage/install-on-desktops

Starts the Waydroid container manually without systemctl. Run this first before starting the session.

```bash
sudo waydroid container start
```

--------------------------------

### Install Waydroid on Debian/Ubuntu using apt

Source: https://docs.waydro.id/usage/install-on-desktops

Update apt and install Waydroid on Debian/Ubuntu and derivatives. After installation, start Waydroid from the applications menu.

```bash
sudo apt update
sudo apt install waydroid -y
```

--------------------------------

### Sync repositories and setup build environment

Source: https://docs.waydro.id/development/compile-waydroid-using-android-generic-project

Syncs all repositories and sets up the local build environment using envsetup.sh.

```bash
repo sync
```

```bash
. build/envsetup.sh
```

--------------------------------

### Install Waydroid on Void Linux using xbps-install

Source: https://docs.waydro.id/usage/install-on-desktops

Install Waydroid from the official Void Linux package repository. After installation, check /usr/share/doc/waydroid/README.voidlinux for further instructions.

```bash
sudo xbps-install -S waydroid
```

--------------------------------

### Example: waydroid log

Source: https://docs.waydro.id/usage/waydroid-command-line-options

Redirects the waydroid log output to a file.

```bash
waydroid log > ~/waydroid-log.txt
```

--------------------------------

### Install Waydroid on Fedora using dnf

Source: https://docs.waydro.id/usage/install-on-desktops

Install Waydroid from the official Fedora package repository using the dnf package manager. After installation, launch Waydroid from the applications menu and initialize it by entering the System OTA URL (https://ota.waydro.id/system) and Vendor OTA URL (https://ota.waydro.id/vendor) in the OTA fields.

```bash
sudo dnf install waydroid
```

--------------------------------

### Mutter: mutter-session.sh

Source: https://docs.waydro.id/faq/setting-up-waydroid-only-sessions

Shell script to start Mutter and then Waydroid full-screen UI.

```shell
#!/bin/sh
mutter --wayland &
sleep 5
export DISPLAY=:1
waydroid show-full-ui

```

--------------------------------

### waydroid app help output

Source: https://docs.waydro.id/usage/install-and-run-android-applications

Shows the usage and subcommands of `waydroid app`: install, remove, launch, and list. Use `waydroid app -h` to display this help.

```text
usage: waydroid app [-h] {install,remove,launch,list} ...

optional arguments:
  -h, --help            show this help message and exit

subaction:
  {install,remove,launch,list}
    install             push a single package to the container and install it
    remove              remove single app package from the container
    launch              start single application
    list                list installed applications
```

--------------------------------

### Wayfire: wayfire-session.sh

Source: https://docs.waydro.id/faq/setting-up-waydroid-only-sessions

Shell script to start Wayfire and then Waydroid full-screen UI.

```shell
#!/bin/sh
wayfire &
export DISPLAY=:1
sleep 5
waydroid show-full-ui

```

--------------------------------

### Install an APK with waydroid app install

Source: https://docs.waydro.id/usage/install-and-run-android-applications

Installs an Android application package from a local APK file. Replace `xyz.apk` with the actual file path.

```bash
waydroid app install xyz.apk
```

--------------------------------

### Weston: waydroid-session.sh

Source: https://docs.waydro.id/faq/setting-up-waydroid-only-sessions

Shell script to start Weston and then Waydroid full-screen UI in a terminal.

```shell
#!/bin/sh
weston &
sleep 3
konsole -e waydroid show-full-ui

```

--------------------------------

### Start Waydroid Session

Source: https://docs.waydro.id/usage/install-on-desktops

Starts the Waydroid session in a new terminal tab. Do not use sudo. Wait for 'Android with user 0 is ready' before launching apps.

```bash
waydroid session start
```

--------------------------------

### Usage: waydroid session [-h] {start,stop} ...

Source: https://docs.waydro.id/usage/waydroid-command-line-options

Shows the usage syntax for the waydroid session command.

```bash
waydroid session [-h] {start,stop} ...
```

--------------------------------

### Start Seedvault restore activity

Source: https://docs.waydro.id/faq/backup-restore-apps-and-data

Run this command in the Waydroid shell or adb shell to start the Seedvault restore activity. You will be asked to choose storage and then enter the passphrase shown during setup.

```shell
am start com.stevesoltys.seedvault/.restore.RestoreActivity
```

--------------------------------

### Usage: waydroid container [-h] {start,stop,restart,freeze,unfreeze} ...

Source: https://docs.waydro.id/usage/waydroid-command-line-options

Shows the usage syntax for the waydroid container command.

```bash
waydroid container [-h] {start,stop,restart,freeze,unfreeze} ...
```

--------------------------------

### Get Linux environment information

Source: https://docs.waydro.id/debugging/getting-essential-information

Use these commands to get information about your Linux environment. The output contains relevant details for troubleshooting.

```bash
lsb_release -a
```

```bash
uname -a
```

--------------------------------

### Launch Waydroid in Full-Screen Mode

Source: https://docs.waydro.id/usage/install-on-desktops

Launches Waydroid in full-screen mode. Can be run while Waydroid is running or used to start it in full-screen mode.

```bash
waydroid show-full-ui
```

--------------------------------

### Install Waydroid on Fedora Immutable variants using rpm-ostree

Source: https://docs.waydro.id/usage/install-on-desktops

For Fedora Silverblue, Kinoite, and other immutable variants, use rpm-ostree instead of dnf to install Waydroid. The same installation instructions apply as for standard Fedora.

```bash
rpm-ostree install waydroid
```

--------------------------------

### Launch AG menu for Waydroid

Source: https://docs.waydro.id/development/compile-waydroid-using-android-generic-project

Starts the Android-Generic menu interface for Waydroid, allowing GUI-based configuration and build.

```bash
ag-menu waydroid
```

--------------------------------

### Add Waydroid third-party repository on Debian/Ubuntu

Source: https://docs.waydro.id/usage/install-on-desktops

For older Debian/Ubuntu releases, install prerequisites and add the official Waydroid repository. If the script fails to detect your distribution, append -s <DISTRO> with supported values: mantic, focal, jammy, kinetic, lunar, noble, plucky, questing, bookworm, bullseye, trixie, sid.

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

--------------------------------

### Launch an app by package name with waydroid app launch

Source: https://docs.waydro.id/usage/install-and-run-android-applications

Launches an installed Android application using its package name (e.g., `com.foo.bar`). The package name is typically in the form `com.xxx.yyy`.

```bash
waydroid app launch com.foo.bar
```

--------------------------------

### Example: sudo waydroid logcat

Source: https://docs.waydro.id/usage/waydroid-command-line-options

Redirects the Android logcat output to a file. Note the typo in the filename (.tx instead of .txt).

```bash
sudo waydroid logcat > ~/waydroid-logcat.tx
```

--------------------------------

### Get network interface information with ip addr show

Source: https://docs.waydro.id/debugging/networking-issues

Run this command to display information about various network interfaces, useful for diagnosing networking issues.

```bash
ip addr show
```

--------------------------------

### Get Waydroid logs

Source: https://docs.waydro.id/debugging/getting-essential-information

Use these commands to retrieve Waydroid logs. The full output should be provided when reporting issues.

```bash
waydroid log
```

```bash
sudo waydroid logcat > ~/waydroid-logcat.txt
```

--------------------------------

### Apply patch manually with git am

Source: https://docs.waydro.id/development/manual-patch-resolution

Run this command to start applying the conflicting patch. It is expected to fail, but that failure is necessary for the next step.

```bash
git am "<SOURCES_ROOT>/vendor/extra/waydroid-patches/base-patches-<AOSP_SDK_VERSION>/<PATCH_PATH>"
```

--------------------------------

### Reset Waydroid: stop service, cleanup, init, start service

Source: https://docs.waydro.id/debugging/troubleshooting

Commands to fully reset Waydroid: stop the container service, remove all Waydroid data, reinitialize with 'waydroid init -f', and restart the service. Use the optional '-i' flag to specify a custom image path.

```bash
systemctl stop waydroid-container.service
```

```bash
sudo rm -rf /var/lib/waydroid /home/.waydroid ~/waydroid ~/.share/waydroid ~/.local/share/applications/*aydroid* ~/.local/share/waydroid
```

```bash
waydroid init -f
```

```bash
waydroid init -f -i /usr/share/waydroid-extra/images
```

```bash
systemctl start waydroid-container.service
```

--------------------------------

### Copy patch to vendor folder

Source: https://docs.waydro.id/development/manual-patch-resolution

Copy the generated patch to the appropriate vendor folder for the conflict. This example shows copying to the roms-patches folder for your ROM.

```bash
cp system/core/0001-init-don-t-bail-out-even-no-SELinux-domain-defined.patch vendor/extra/waydroid-patches/roms-patches/__YourRomName__/system/core/0015-init-don-t-bail-out-even-no-SELinux-domain-defined.patch
```

--------------------------------

### Set up build environment

Source: https://docs.waydro.id/development

Sets up the local build environment by sourcing envsetup.sh.

```bash
. build/envsetup.sh
```

--------------------------------

### Usage: waydroid init [-h] [-i IMAGES_PATH] [-f] [-c SYSTEM_CHANNEL] [-v VENDOR_CHANNEL] [-r ROM_TYPE] [-s SYSTEM_TYPE]

Source: https://docs.waydro.id/usage/waydroid-command-line-options

Shows the usage syntax for the waydroid init command.

```bash
waydroid init [-h] [-i IMAGES_PATH] [-f] [-c SYSTEM_CHANNEL] [-v VENDOR_CHANNEL] [-r ROM_TYPE] [-s SYSTEM_TYPE]
```

--------------------------------

### Initialize for test builds: cleanup and init commands

Source: https://docs.waydro.id/usage/waydroid-command-line-options

Commands to clean up previous Waydroid data and initialize with custom images. The cleanup command removes /var/lib/waydroid, /home/.waydroid, and ~/waydroid. Then run init with -f and optionally -i to specify a custom images path.

```bash
sudo rm -rf /var/lib/waydroid /home/.waydroid ~/waydroid
```

```bash
sudo waydroid init -f
sudo waydroid init
```

```bash
sudo waydroid init -f
sudo waydroid init -i ~/Downloads/test_build
```

--------------------------------

### Apply Waydroid configuration

Source: https://docs.waydro.id/faq/get-waydroid-to-work-through-a-vm

Run this command to apply the configuration changes.

```bash
sudo waydroid upgrade -o
```

--------------------------------

### Initialize repository with LineageOS trees

Source: https://docs.waydro.id/development

Initializes a local repository using the LineageOS trees for the lineage-20.0 branch with git-lfs, then syncs the build/make repository.

```bash
repo init -u https://github.com/LineageOS/android.git -b lineage-20.0 --git-lfs
repo sync build/make
```

--------------------------------

### Legacy Waydroid build script help output

Source: https://docs.waydro.id/development/compile-waydroid-using-android-generic-project

Displays the help and usage information for the legacy Waydroid build script, showing available options and syntax.

```bash
bash vendor/ag/legacy-scripts/waydroid-build/waydroid_build.sh --help
Compiles and packages Waydroid for target arch

Syntax: 
	waydroid_build [-a|--arch arm|arm64|x86|x86_64] [-c|--clean] [-p|--package] [-r|--rom_name Name]
options:
	-a|--arch (option) Specify arch for build (arm, arm64, x86, x86_64)
	-c|clean     Run 'make clean' before build
	-p|--package     Package build using ROM_NAME
	-r|--rom_name (ROM_NAME) Name used for package build filename (ex: Lineage-17.1)
```

--------------------------------

### Copy images to /etc/waydroid-extra/images/

Source: https://docs.waydro.id/faq/using-custom-waydroid-images

Place custom system.img and vendor.img files into the /etc/waydroid-extra/images/ directory. The path /usr/share/waydroid-extra/images/ was used before waydroid --version 1.3.3 and remains valid.

```bash
/etc/waydroid-extra/images/
```

--------------------------------

### Sync repositories

Source: https://docs.waydro.id/development

Syncs all repositories after initializing and adding local manifests.

```bash
repo sync
```

--------------------------------

### Download Waydroid local_manifests

Source: https://docs.waydro.id/development

Downloads and runs the Waydroid manifest generation script to set up local manifests.

```bash
wget -O - https://raw.githubusercontent.com/waydroid/android_vendor_waydroid/lineage-20/manifest_scripts/generate-manifest.sh | bash
```

--------------------------------

### Mount common host directories into Waydroid

Source: https://docs.waydro.id/faq/setting-up-a-shared-folder

Use sudo mount --bind to share host folders like Documents, Downloads, Music, Pictures, and Videos with Waydroid. Ensure the target folder exists under ~/.local/share/waydroid/data/media/0/ before mounting.

```bash
sudo mount --bind ~/Documents ~/.local/share/waydroid/data/media/0/Documents
sudo mount --bind ~/Downloads ~/.local/share/waydroid/data/media/0/Download
sudo mount --bind ~/Music ~/.local/share/waydroid/data/media/0/Music
sudo mount --bind ~/Pictures ~/.local/share/waydroid/data/media/0/Pictures
sudo mount --bind ~/Videos ~/.local/share/waydroid/data/media/0/Movies
```

--------------------------------

### Check kernel support on some distros

Source: https://docs.waydro.id/debugging

Alternative command to verify kernel support for binder and either ashmem or memfd on some distros.

```bash
zgrep -i -e android -e memfd -e ashmem /proc/config.gz
```

--------------------------------

### Initialize Lineage OS repository with repo init

Source: https://docs.waydro.id/development/compile-waydroid-using-android-generic-project

Initializes a local repository using the Lineage OS trees for branch lineage-18.1 with git-lfs support.

```bash
repo init -u https://github.com/LineageOS/android.git -b lineage-18.1 --git-lfs
```

--------------------------------

### Retrieve Android ID for Google Play Certification

Source: https://docs.waydro.id/faq/google-play-certification

Run this command in a terminal to get the Android ID needed for self-certification. It queries the gservices.db database inside the Waydroid container using sqlite3. The output is a string of numbers that you must use to register the device at https://www.google.com/android/uncertified.

```bash
sudo waydroid shell -- sh -c "sqlite3 /data/data/*/*/gservices.db 'select value from main where name = \"android_id\";'"
```

--------------------------------

### Enable color inversion via host shell (waydroid prop set)

Source: https://docs.waydro.id/faq/color-correction-in-mutter

Run this command in the host shell to enable color inversion for Waydroid when using standard Mutter. Do not use this in combination with multi-window mode.

```bash
waydroid prop set persist.waydroid.invert_colors true
```

--------------------------------

### Compile Waydroid for x86_64 with clean and package

Source: https://docs.waydro.id/development/compile-waydroid-using-android-generic-project

Runs the legacy build script to compile Waydroid for x86_64, performing a clean build and packaging the result.

```bash
bash vendor/ag/legacy-scripts/waydroid-build/waydroid_build.sh -a x86_64 -c -p
```

--------------------------------

### Waydroid build commands

Source: https://docs.waydro.id/development

Builds the system and vendor images for Waydroid using the arm64 lunch option.

```bash
. build/envsetup.sh
lunch lineage_waydroid_arm64-userdebug
make systemimage -j$(nproc --all)
make vendorimage -j$(nproc --all)
```

--------------------------------

### Usage: waydroid [-h] [-V] [-l LOG] [--details-to-stdout] [-v] [-q]

Source: https://docs.waydro.id/usage/waydroid-command-line-options

Shows the general usage syntax for the waydroid command.

```bash
waydroid [-h] [-V] [-l LOG] [--details-to-stdout] [-v] [-q]
```

--------------------------------

### Re-initialize Waydroid with custom images

Source: https://docs.waydro.id/faq/using-custom-waydroid-images

Run 'sudo waydroid init -f' to force re-initialization so Waydroid uses the custom images placed in the images directory.

```bash
sudo waydroid init -f
```

--------------------------------

### Add Android-Generic and Waydroid bits

Source: https://docs.waydro.id/development/compile-waydroid-using-android-generic-project

Downloads and runs the Waydroid manifest generation script, then clones the Android-Generic vendor repository.

```bash
wget -O - https://raw.githubusercontent.com/waydroid/android_vendor_waydroid/lineage-18.1/manifest_scripts/generate-manifest.sh | bash
```

```bash
git clone https://github.com/android-generic/vendor_ag vendor/ag
```

--------------------------------

### Usage: waydroid log [-h] [-n LINES] [-c]

Source: https://docs.waydro.id/usage/waydroid-command-line-options

Shows the usage syntax for the waydroid log command.

```bash
waydroid log [-h] [-n LINES] [-c]
```

--------------------------------

### Waydroid AOSP lunch options

Source: https://docs.waydro.id/development

Lists the available lunch options for building Waydroid images for different architectures.

```bash
lineage_waydroid_arm-userdebug
lineage_waydroid_arm64-userdebug
lineage_waydroid_arm64_only-userdebug
lineage_waydroid_x86-userdebug
lineage_waydroid_x86_64-userdebug
```

--------------------------------

### Weston: weston.ini

Source: https://docs.waydro.id/faq/setting-up-waydroid-only-sessions

Weston configuration enabling tap and removing panel.

```ini
[libinput]
enable-tap=true

[shell]
panel-position=none

```

--------------------------------

### Extract downloaded SourceForge zips to images directory

Source: https://docs.waydro.id/faq/using-custom-waydroid-images

Create the images directory and extract the system and vendor zips downloaded from SourceForge. Assumes the terminal is open in the directory where the zips were downloaded. The rm command removes the zip files after extraction.

```bash
sudo mkdir -p /etc/waydroid-extra/images
sudo unzip lineage-*-system.zip -d /etc/waydroid-extra/images
sudo unzip lineage-*-vendor.zip -d /etc/waydroid-extra/images
rm lineage-*-system.zip lineage-*-vendor.zip
```

--------------------------------

### Cage: waydroid.desktop

Source: https://docs.waydro.id/faq/setting-up-waydroid-only-sessions

Desktop entry for Cage that launches Waydroid full-screen UI.

```desktop
[Desktop Entry]
Name=WayDroid
Comment=Android OS in a container
Exec=/usr/bin/cage waydroid show-full-ui
Type=Application

```

--------------------------------

### Enable color inversion via Android shell (settings put)

Source: https://docs.waydro.id/faq/color-correction-in-mutter

Run this command inside the Android shell to correct all colors except the boot animation.

```bash
settings put secure accessibility_display_inversion_enabled 1
```

--------------------------------

### Verify kernel binder and ashmem/memfd support

Source: https://docs.waydro.id/debugging/getting-essential-information

Use these commands to check if your kernel supports binder and either ashmem or memfd. The first command works on most distros; the second is for some distros. If support is missing, you may need a supported kernel or patched anbox-modules.dkms.

```bash
grep -i -e android -e memfd -e ashmem "/boot/config-$(uname -r)"
```

```bash
zgrep -i -e android -e memfd -e ashmem /proc/config.gz
```

--------------------------------

### Edit Waydroid configuration file

Source: https://docs.waydro.id/faq/get-waydroid-to-work-through-a-vm

Open the Waydroid configuration file with nano to add properties that disable GPU acceleration.

```bash
nano /var/lib/waydroid/waydroid.cfg
```

--------------------------------

### Configure UFW or GUFW firewall rules

Source: https://docs.waydro.id/debugging/networking-issues

Allows DNS (port 53), DHCP (port 67), and sets the default FORWARD policy to ACCEPT, which is required for Waydroid networking.

```bash
sudo ufw allow 53
sudo ufw allow 67
sudo ufw default allow FORWARD
```

--------------------------------

### Mount Waydroid internal storage with bindfs

Source: https://docs.waydro.id/faq/setting-up-a-shared-folder

Create a mount point and use bindfs to mount Waydroid's internal storage to a host folder, setting your user as owner of all mounted files while preserving original permissions in the source.

```bash
sudo mkdir /mnt/waydroid
sudo bindfs --mirror=$(id -u) ~/.local/share/waydroid/data/media/0 /mnt/waydroid
```

--------------------------------

### Restart Waydroid Session

Source: https://docs.waydro.id/faq/google-play-certification

After registering the device and waiting a few minutes for Google services to reflect the change, run this command to restart the Waydroid session.

```bash
waydroid session stop
```

--------------------------------

### Mutter: mutter.desktop

Source: https://docs.waydro.id/faq/setting-up-waydroid-only-sessions

Desktop entry for Mutter that runs the mutter-session.sh script.

```desktop
[Desktop Entry]
Name=WayDroid on Mutter
Comment=Android OS in a container
Exec=/usr/bin/mutter-session.sh
Type=Application

```

--------------------------------

### Apparmor fix for dnsmasq pid file issue

Source: https://docs.waydro.id/debugging/known-issues

Add these lines to /etc/apparmor.d/usr.sbin.dnsmasq or /etc/apparmor.d/local/usr.sbin.dnsmasq to allow Waydroid to create its runtime files.

```apparmor
@{run}/waydroid-lxc/ r,
@{run}/waydroid-lxc/* rw,
```

--------------------------------

### Enable Multi-Window Mode

Source: https://docs.waydro.id/usage/install-on-desktops

Sets the persist.waydroid.multi_windows property to true while a Waydroid session is running. After setting, restart the session to apply.

```bash
waydroid prop set persist.waydroid.multi_windows true
```

--------------------------------

### Weston: waydroid.desktop

Source: https://docs.waydro.id/faq/setting-up-waydroid-only-sessions

Desktop entry for Weston that runs the waydroid-session.sh script.

```desktop
[Desktop Entry]
Name=WayDroid on Weston
Comment=Android OS in a container
Exec=/usr/bin/waydroid-session.sh
Type=Application

```

--------------------------------

### Convert sparse images to raw images

Source: https://docs.waydro.id/development

Converts the Android Sparse Image output to raw filesystem images using simg2img. Required for branches before lineage-20.0.

```bash
simg2img $OUT/system.img ~/system.img
simg2img $OUT/vendor.img ~/vendor.img
```

--------------------------------

### Configure firewalld to trust waydroid0 interface

Source: https://docs.waydro.id/debugging/networking-issues

Adds the waydroid0 interface to the trusted zone permanently, allowing traffic through the firewall.

```bash
firewall-cmd --zone=trusted --add-interface=waydroid0 --permanent
```

--------------------------------

### Connect ADB to Waydroid

Source: https://docs.waydro.id/faq/using-adb-with-waydroid

Run this command after obtaining the Waydroid IP address from Android Settings > About. It connects ADB to the Waydroid instance on port 5555.

```bash
adb connect <IP>:5555
```

--------------------------------

### Generate .rej files with patch command

Source: https://docs.waydro.id/development/manual-patch-resolution

Run this command after the git am failure to generate .orig and .rej files that help identify the conflicting parts.

```bash
patch -p1 < "<SOURCES_ROOT>/vendor/extra/waydroid-patches/base-patches-<AOSP_SDK_VERSION>/<PATCH_PATH>"
```

--------------------------------

### Wayfire: wayfire.desktop

Source: https://docs.waydro.id/faq/setting-up-waydroid-only-sessions

Desktop entry for Wayfire that runs the wayfire-session.sh script.

```desktop
[Desktop Entry] 
Name=waydroid on Wayfire 
Comment=Android OS in a container 
Exec=/usr/bin/wayfire-session.sh
Type=Application

```

--------------------------------

### Capture Waydroid logcat to file

Source: https://docs.waydro.id/debugging

Use to capture Waydroid logcat output to a file. Include the full output when reporting issues.

```bash
sudo waydroid logcat > ~/waydroid-logcat.txt
```

--------------------------------

### Stage resolved files

Source: https://docs.waydro.id/development/manual-patch-resolution

After resolving the conflicts and deleting .rej and .orig files, stage all changes.

```bash
git add -A
```

--------------------------------

### systemd-homed BTRFS ACL configuration for Android 13

Source: https://docs.waydro.id/debugging/known-issues

Create /etc/systemd/system/systemd-homed.service.d/btrfs-acl.conf with this content to enable ACL support on BTRFS home directories, required for Waydroid after Android 13 upgrade.

```ini
[Service]
Environment=SYSTEMD_HOME_MOUNT_OPTIONS_BTRFS=acl,compress=zstd:1,user_subvol_rm_allowed
```

--------------------------------

### Clean Up Waydroid Files After Removal

Source: https://docs.waydro.id/usage/install-on-desktops

Removes leftover Waydroid data and configuration files after uninstalling. Run after reboot. Then reinstall Waydroid.

```bash
sudo rm -rf /var/lib/waydroid /home/.waydroid ~/waydroid ~/.share/waydroid ~/.local/share/applications/*aydroid* ~/.local/share/waydroid
```

--------------------------------

### Apply Waydroid patches

Source: https://docs.waydro.id/development

Applies the Waydroid patches to the source tree.

```bash
apply-waydroid-patches
```

--------------------------------

### Check Waydroid container service status

Source: https://docs.waydro.id/debugging/getting-essential-information

Use this command to check the status of the Waydroid container service. The full output should be included when reporting issues.

```bash
sudo systemctl status waydroid-container.service
```

--------------------------------

### Set IPTABLES FORWARD policy to ACCEPT

Source: https://docs.waydro.id/debugging/networking-issues

Sets the default FORWARD policy to ACCEPT, which is necessary if the previous check showed DROP.

```bash
iptables -P FORWARD ACCEPT
```

--------------------------------

### Regenerate local manifests

Source: https://docs.waydro.id/development

Manually regenerates the local_manifests using the waydroid-generate-manifest function.

```bash
waydroid-generate-manifest
```

--------------------------------

### Stop Waydroid Session and Container

Source: https://docs.waydro.id/usage/install-on-desktops

Stops the Waydroid session and container before removing Waydroid. Run these commands before uninstalling.

```bash
waydroid session stop
sudo waydroid container stop
```

--------------------------------

### Add properties to disable GPU acceleration

Source: https://docs.waydro.id/faq/get-waydroid-to-work-through-a-vm

Add these lines in the [properties] section of waydroid.cfg to force software rendering.

```ini
ro.hardware.gralloc=default
ro.hardware.egl=swiftshader
```

--------------------------------

### Workaround for waydroid shell command issues on Arch

Source: https://docs.waydro.id/debugging/troubleshooting

Replace 'waydroid shell' with this lxc-attach command to work around a bug on Arch-based distributions that causes commands inside the Waydroid shell to be inaccessible or not found.

```bash
lxc-attach -P /var/lib/waydroid/lxc/ -n waydroid --clear-env
```

--------------------------------

### Check IPTABLES FORWARD policy

Source: https://docs.waydro.id/debugging/networking-issues

Lists IPTABLES rules and filters for FORWARD to check if the policy is set to DROP.

```bash
iptables --list-rules | grep FORWARD
```

--------------------------------

### Generate patch for conflict resolution

Source: https://docs.waydro.id/development/manual-patch-resolution

Generate a patch file for the resolved conflict to be copied to the appropriate vendor folder.

```bash
git format-patch -1
```

--------------------------------

### Disable Mesa for HALIUM images

Source: https://docs.waydro.id/development

Sets TARGET_USE_MESA to false to build HALIUM vendor images without Mesa GPU drivers.

```bash
export TARGET_USE_MESA=false
```

--------------------------------

### Remove Waydroid Package on Debian/Ubuntu

Source: https://docs.waydro.id/usage/install-on-desktops

Uninstalls the Waydroid package on Debian or Ubuntu using apt. Run after stopping the session and container.

```bash
sudo apt remove waydroid
```
Tokens:
Raw