podman-system-renumber(1)

📦
version 6.1.4 · 4 versions
, in arch rolling, fedora 43, fedora 44, ubuntu resolute

💅 podman-system-renumber(1) — General Commands Manual 🎀

okay bestie, sit down, we're doing the lock renumbering episode of the podman cinematic universe and honestly? it's giving maintenance-core, but it's important. this is the podman-system-renumber manual page, and no cap, you're gonna want to read it before you start messing with num_locks. ✨

🌸 NAME 🌸

podman-system-renumber — migrate lock numbers to handle a change in maximum number of locks 🦋

🫶 SYNOPSIS 🫶

podman system renumber

✨ DESCRIPTION ✨

so, podman system renumber renumbers the locks that containers and pods use. that's it, that's the whole job, but omg the why is the juicy part.

every single Podman container and every single pod gets allocated a lock at creation time, and there's a maximum number of those locks, controlled by the num_locks parameter in containers.conf. 🔒

when all the available locks are exhausted, that's it — no further containers and pods can be created until some existing containers and pods are removed. 💀 the way around this is to bump up the number of locks available by modifying containers.conf, and then running podman system renumber to prepare the new locks (and reallocate lock numbers to fit the new struct). iconic.

⚠️ podman system renumber must be called after any changes to num_locks. failure to do so results in errors starting Podman, because the number of locks available conflicts with the configured number of locks. not a vibe, fr fr.

podman system renumber can also be used to migrate 1.0 and earlier versions of Podman — which used a totally different locking scheme — to the new locking model. it is not strictly required to do this, but it is highly recommended to do so, because deadlocks can occur otherwise. 😭

and one last thing, if possible, avoid calling podman system renumber while there are other Podman processes running. please. for me. 🙈

🎀 EXAMPLES 🎀

renumber container and pod locks after modifying the num_locks setting in containers.conf:

$ podman system renumber

🌈 SEE ALSO 🌈

👑 HISTORY 👑

February 2019, originally compiled by Matt Heon (mheon at redhat dot com) 💖

and that's the page, bestie!! this was podman-system-renumber(1), from the General Commands Manual, dated February 2019 — go forth, renumber those locks, and slay. 💅✨🎀

📦 where this page comes from