From f48b27abe5ae6bf6f48fdedec7daa816f029168b Mon Sep 17 00:00:00 2001 From: Karim Vergnes Date: Thu, 1 Jan 2026 18:25:56 +0100 Subject: [PATCH] Document container startup issues with Android 13 upgrade Android 13 requires ACLs on /data/media, which can result in silent failure and loss of user data if the filesystem feature is disabled. --- debugging/known-issues.md | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/debugging/known-issues.md b/debugging/known-issues.md index 2248f9c..9b0179d 100644 --- a/debugging/known-issues.md +++ b/debugging/known-issues.md @@ -17,3 +17,14 @@ adding the below to it. Dual GPUs are known to cause an issue where the display is garbled or flickering. You can try [this script](https://github.com/Quackdoc/waydroid-scripts/blob/main/waydroid-choose-gpu.sh) to choose which GPU should be used by Waydroid + +### Container fails to start after upgrade to Android 13 (LineageOS 20) + +From Android 13 onwards, the filesystem on your home directory needs to support ACLs. If you use BTRFS, for instance with an encrypted `systemd-homed` directory, check that it isn't mounted with the `noacl` mount option. + +If you are using `systemd-homed`, create the file `/etc/systemd/system/systemd-homed.service.d/btrfs-acl.conf` containing the following. + +``` +[Service] +Environment=SYSTEMD_HOME_MOUNT_OPTIONS_BTRFS=acl,compress=zstd:1,user_subvol_rm_allowed +```