podman-network-prune(1)

📦
version 6.1.4 · 19 versions
, in arch rolling

💅 podman-network-prune — bestie's guide to yeeting unused networks

Okay so real talk, this is the podman-network-prune manual page from the General Commands Manual, and it's literally just here to help you clean up. Let's get into it ✨

🌸 NAME 🌸

podman-network-prune — remove all unused networks (yes, all of them, bye 👋)

🦋 SYNOPSIS 🦋

podman network prune [options]

That's it, that's the whole thing. No positional args, no drama, just vibes and options 💅

💖 DESCRIPTION 💖

So what this does is it removes all unused networks. And like, what even is an "unused network"? Glad you asked, bestie — the manpage defines it as a network which has no containers connected or configured to connect to it. Nobody's using it, nobody's planning to use it, it's giving ghost town energy 👻

One big ol' exception though: it does not remove the so-called default network, the one that goes by the name of podman. That one's the main character and it stays. periodt 👑

✨ OPTIONS ✨

  • --filter — provide filter values. That's the whole idea. More on how below 🎀
  • --force, -f — do not prompt for confirmation. Live fast, prune without asking, no cap 💀

🔍 the --filter situation (it's giving detail)

Okay so --filter needs a little more explaining, because there's rules.

If there's more than one filter, you gotta pass the --filter option multiple times, like this:

--filter label=test --filter until=10m

Supported filters, bestie:

  • label — only remove networks with (or without, in the case of label!=[...] being used) the specified labels.
  • until — only remove networks created before the given timestamp.

Now for the label filter, there are two formats you can use:

  1. label=key or label=key=value — this one removes networks with the specified labels.
  2. label!=key or label!=key=value — this one removes networks without the specified labels. Note the sneaky ! — it flips the whole thing 🙈

And the until filter? It accepts:

  • Unix timestamps
  • date formatted timestamps
  • Go duration strings (e.g. 10m, 1h30m) — and these are computed relative to the machine's time ⏰

🌈 EXAMPLE 🌈

Prune networks:

podman network prune

Prune all networks created not created in the last two hours (yes, that's the original wording, and honestly? iconic):

podman network prune --filter until=2h

💜 SEE ALSO 💜

Go read those too, they're the friend group 💫

🎀 HISTORY 🎀

February 2021, originally compiled by Brent Baude bbaude@redhat.com ⟨mailto:bbaude@redhat.com⟩ — shoutout to Brent for writing this down so the rest of us could thrive 🫶

that's the whole page, bestie — this was podman-network-prune(1) from the General Commands Manual, source/version and date and all, and you ate it up 💅✨

📦 where this page comes from