podman-system-check(1)

✨ podman-system-check(1) ✨

okay bestie, welcome to the podman-system-check manual page — it lives in the General Commands Manual section and it is literally here to do a vibe check on ur storage 💅

---

🎀 NAME 🎀

podman-system-check — perform consistency checks on image and container storage

---

🌸 SYNOPSIS 🌸

podman system check [options]

---

🦋 DESCRIPTION 🦋

So what does this do? It performs consistency checks on image and container storage, and it reports back the images and containers that have identified issues. Basically it's the friend who tells u "girl… that outfit is not it" but for ur container storage. 🔍✨

---

👑 OPTIONS 👑

• --force, -f — when it's attempting to remove damaged images, this also removes containers which depend on those images. By default, damaged images which are being used by containers are left alone. 🙈

Containers which depend on damaged images do so regardless of which engine created them, but because podman only "knows" how to shut down containers that it started, the effect on still-running containers which were started by other engines is difficult to predict. so like… it's giving unpredictable, fr fr 💀

• --max, -m=duration — when considering layers which are not used by any images or containers, this assumes that any layers which are more than duration old are the results of canceled attempts to pull images, and should be treated as though they are damaged. 🕰️
• --quick, -q — skips checks which are known to be time-consuming. This will prevent some types of errors from being detected. ngl it's fast but it's missing stuff 😭

The exact checks performed by this option are subject to change. (so don't get too attached bestie 💖)

• --repair, -r — removes any images which are determined to have been damaged in some way, unless they are in use by containers. Use --force to remove containers which depend on damaged images, and those damaged images, as well. 🧹✨

---

🌈 EXAMPLE 🌈

A reasonably quick check:

podman system check --quick --repair --force

A more thorough check:

podman system check --repair --max=1h --force

---

💜 SEE ALSO 💜

podman(1), podman-system(1)

---

⭐ HISTORY ⭐

April 2024

---

and that's the whole page, bestie!! 🫶 this was the podman-system-check(1) manual, served fresh from the General Commands Manual, dated April 2024. go forth and check ur storage, u got this 💅✨🎀