From 09b51ab2f4cbeb4f3f0c223075acfd6e66dc8860 Mon Sep 17 00:00:00 2001 From: RoelSG Date: Thu, 19 Sep 2024 09:20:11 +0200 Subject: [PATCH] Update docs/content/config/advanced/podman.md Co-authored-by: Brennan Kinney <5098581+polarathene@users.noreply.github.com> --- docs/content/config/advanced/podman.md | 19 +++++++++++++++---- 1 file changed, 15 insertions(+), 4 deletions(-) diff --git a/docs/content/config/advanced/podman.md b/docs/content/config/advanced/podman.md index 0901ae4d..f2fdf22f 100644 --- a/docs/content/config/advanced/podman.md +++ b/docs/content/config/advanced/podman.md @@ -114,11 +114,22 @@ docker compose ps [podman::quadlet::introduction]: https://mo8it.com/blog/quadlet/ [podman::quadlet::generated-output-example]: https://blog.while-true-do.io/podman-quadlets/#writing-quadlets -To make a rootless Quadlet auto-start make sure your user is *lingering*. +!!! tip "Rootless compatibility" -```bash -loginctl enable-linger user -``` + Quadlets can [support rootless with a few differences][podman::rootless-differences]: + + - `Network=pasta` configures [`pasta`][network-driver::pasta] as a rootless compatible network driver (_a popular alternative to `slirp4netns`. `pasta` is the default for rootless since Podman v5_). + - `Restart=always` will auto-start your Quadlet at login, rootless support requires to enable [lingering][systemd-docs::loginctl::linger] for your user: + + ```bash + loginctl enable-linger user + ``` + - [Config locations between rootful vs rootless][podman-docs::quadlet::config-search-path]. + +[podman::rootless-differences]: https://matduggan.com/replace-compose-with-quadlet/#rootless +[network-driver::pasta]: https://passt.top/passt/about/#pasta +[systemd-docs::loginctl::linger]: https://www.freedesktop.org/software/systemd/man/latest/loginctl.html#enable-linger%20USER%E2%80%A6 +[podman-docs::quadlet::config-search-path]: https://docs.podman.io/en/latest/markdown/podman-systemd.unit.5.html#podman-rootful-unit-search-path Forcing a daemon-reload when a Quadlet-file is present in any of the accepted directories for Quadlets, will automatically generate a systemd-service that will auto-start at boot.