Document pasta forwarding mode for rootless bridge networks

Signed-off-by: Jan Rodák <hony.com@seznam.cz>
This commit is contained in:
Jan Rodák committed 2026-05-20 14:24:48 +02:00
1 parent e598657244
commit baf8fa6223
5 files changed
+21

No files matched your search

+8
View File
@@ -80,6 +80,14 @@ The user experience of rootless netavark is very akin to a rootful netavark, exc
there is no default network configuration provided. You simply need to create a
network, and the one will be created as a bridge network.
By default, rootless bridge networks use `rootlessport` for port forwarding, which
is a userspace proxy that does not preserve client source IPs. To preserve source
IPs, set `rootless_port_forwarder="pasta"` in the `[network]` section of
`containers.conf`. This uses `pesto` to configure pasta's kernel-level forwarding,
so containers see the real client IP address instead of the bridge gateway.
This option is experimental and its behavior is subject to change.
It requires a version of passt (`>= passt-0^20260507.g1afd4ed`) that ships the `pesto` binary.
```
$ podman network create
```