Waydroid

Installing and configuring waydroid in Mocaccino Desktop

Install and configure Waydroid

Waydroid is available in the Community repository. If you have enabled this repository you can install it by using this command:

1
$ sudo luet install apps/waydroid-vanilla

or for Google Apps (GApps) support:

1
$ sudo luet install apps/waydroid-gapps

Configure GRUB

We need to pass some arguments to the GRUB bootloader. Edit /etc/default/grub with your preferred text editor (e.g., sudo nano /etc/default/grub) and find GRUB_CMDLINE_LINUX and add:

1
GRUB_CMDLINE_LINUX="binder.devices=binder,hwbinder,vndbinder"

After editing this file, regenerate the grub config file:

1
$ sudo grub-mkconfig -o /boot/grub/grub.cfg

Enable Waydroid container

Enable and start the waydroid systemd service

1
$ sudo systemctl enable --now waydroid-container.service

Initialize Waydroid

For vanilla Android:

1
$ sudo waydroid init

For Android with Gapps:

1
$ sudo waydroid init -s GAPPS

To apply GRUB changes and bring up binderfs we have to restart the system.

AppArmor (optional)

Waydroid will run without AppArmor, but enabling it adds an extra layer of sandboxing for Android processes. Since it is installed as a dependency of lxc, you might as well enable it.

Enable the apparmor service:

1
systemctl enable --now apparmor.service

Enable required boot parameters. Edit /etc/default/grub with your preferred text editor (e.g., sudo nano /etc/default/grub) and find GRUB_CMDLINE_LINUX and append apparmor=1 security=apparmor parameters.

1
GRUB_CMDLINE_LINUX="apparmor=1 security=apparmor"

After editing this file, regenerate the grub config file:

1
$ sudo grub-mkconfig -o /boot/grub/grub.cfg

Now restart the system.

References

Last modified August 3, 2025: Update Discord invite (f32a0fe)