From f2bc63894436def1d1cdb92cfde3610f5b464d7a Mon Sep 17 00:00:00 2001 From: Paul Holzinger Date: Thu, 19 Oct 2023 15:39:33 +0200 Subject: [PATCH] quadlet: document cgroupv2 requirement Units created with quadlet need cgroupv2 in order to work. Fixes #19365 Signed-off-by: Paul Holzinger --- docs/source/markdown/podman-systemd.unit.5.md | 2 ++ docs/tutorials/socket_activation.md | 2 +- 2 files changed, 3 insertions(+), 1 deletion(-) diff --git a/docs/source/markdown/podman-systemd.unit.5.md b/docs/source/markdown/podman-systemd.unit.5.md index 0132ffb97f..483c47a93b 100644 --- a/docs/source/markdown/podman-systemd.unit.5.md +++ b/docs/source/markdown/podman-systemd.unit.5.md @@ -59,6 +59,8 @@ Adding the following snippet to a Quadlet file extends the systemd timeout to 15 TimeoutStartSec=900 ``` +Quadlet requires the use of cgroup v2, use `podman info --format {{.Host.CgroupsVersion}}` to check on the system. + ### Service Type By default, the `Type` field of the `Service` section of the Quadlet file does not need to be set. diff --git a/docs/tutorials/socket_activation.md b/docs/tutorials/socket_activation.md index 96bf64bacf..7d08a46c04 100644 --- a/docs/tutorials/socket_activation.md +++ b/docs/tutorials/socket_activation.md @@ -76,7 +76,7 @@ stateDiagram-v2 s2 --> container: socket inherited via exec ``` -This type of socket activation can be used in systemd services that are generated from container unit files (see [podman-systemd.unit(5)](https://docs.podman.io/en/latest/markdown/podman-systemd.unit.5.html)) or from the command [`podman generate systemd`](https://docs.podman.io/en/latest/markdown/podman-generate-systemd.1.html). +This type of socket activation can be used in systemd services that are generated from container unit files (see [podman-systemd.unit(5)](https://docs.podman.io/en/latest/markdown/podman-systemd.unit.5.html)) (Note, quadlet requires the use of cgroup v2) or from the command [`podman generate systemd`](https://docs.podman.io/en/latest/markdown/podman-generate-systemd.1.html). The container must also support socket activation. Not all software daemons support socket activation but it's getting more popular. For instance Apache HTTP server, MariaDB, DBUS, PipeWire, Gunicorn, CUPS all have socket activation support.