NETAVARK(1)

💖 NAME

okay so bestie, welcome to the netavark(1) manual 💅 — this is all about netavark, and its whole main-character job is to configure a given network namespace for use by a container. No cap.

✨ SYNOPSIS

netavark [options] command network namespace path

🌈 DESCRIPTION

Netavark configures a network namespace according to a configuration read from STDIN 🫶. That configuration is JSON formatted — periodt.

🌍 GLOBAL OPTIONS

• --file, -f — instead of reading from STDIN, read the configuration to be applied from the given file. You can also use -f - to flag reading from STDIN. (Yes, the dash is doing the most, and we love that for it 😌)

🛠️ COMMANDS

✨ netavark create

The create command takes a partially configured network and completes the remaining configuration. The create command input is described in netavark-create-input.md — URL: https://github.com/containers/netavark/blob/main/docs/netavark-create-input.md. The output of the create command is a network config json.

✨ netavark setup

The setup command configures the given network namespace with the given configuration, creating any interfaces and firewall rules necessary. It's giving "make it work, bestie" energy 🔥.

✨ netavark teardown

The teardown command is the inverse of the setup command, undoing any configuration applied. Some interfaces may not be deleted (bridge interfaces, for example, will not be removed). Okay so it's not a full clean-slate delete — noted 🫡.

📝 CONFIGURATION FORMAT

The configuration accepted is the same for both setup and teardown. It is JSON formatted.

The format is https://github.com/containers/podman/blob/cd7b48198c38c5028540e85dc72dd3406f4318f0/libpod/network/types/network.go#L164-L173, but we will also send a Networks array including all the network definitions: https://github.com/containers/podman/blob/cd7b48198c38c5028540e85dc72dd3406f4318f0/libpod/network/types/network.go#L32-L62.

TODO: Transcribe configuration into here in a nice tabular format. (The manual said it, not me — it's on the TODO list, bestie 📝)

🌸 EXAMPLE

netavark setup /run/user/1000/podman/netns/d11d1f9c499d

netavark -f /run/podman/828b0508ae64.conf teardown
/run/podman/netns/828b0508ae64

👀 SEE ALSO

• podman(1) — go say hi 💖

🎀 HISTORY

September 2021, Originally compiled by Matt Heon mheon@redhat.com — the mailto: URL is mailto:mheon@redhat.com 🫶.

---

and that's the page, bestie 💖 — the footer is just netavark(1)(), with no extra version/date line printed, so we're done. slay ✨