From e2ac7f37499fbfc6c4f395837a48ebb6f988002d Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Alexander=20W=C3=BCrstlein?= Date: Sat, 19 Apr 2025 17:44:22 +0200 Subject: [PATCH] Add note about rootless podman containers Add a note that explains how to make rootless podman containers work by passing on kvm group permissions through crun. --- docs/docker.md | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/docs/docker.md b/docs/docker.md index 7f7a130..979e429 100644 --- a/docs/docker.md +++ b/docs/docker.md @@ -98,6 +98,12 @@ docker compose --file ~/.config/winapps/compose.yaml kill # Force shut down the ### Setup `Podman` Container Please follow the [`docker` instructions](#setup-docker-container). +> [!NOTE] +> #### Rootless `podman` containers +> If you are invoking podman as a user, your container will be "rootless". This can be desirable as a security feature. However, you may encounter an error about missing permissions to /dev/kvm as a consequence. +> +> For rootless podman to work, you need to add your user to the `kvm` group (depending on your distribution) to be able to access `/dev/kvm`. Make sure that you are using `crun` as your container runtime, not `runc`. Usually this is done by stopping all containers and (de-)installing the corresponding packages. Then either invoke podman-compose as `podman-compose --file ./compose.yaml --podman-create-args '--group-add keep-groups' up`. Or edit `compose.yaml` and uncomment the `group_add:` section at the end. + > [!IMPORTANT] > Ensure `WAFLAVOR` is set to `"podman"` in `~/.config/winapps/winapps.conf`.