podman-system-check(1) General Commands Manual podman-system-check(1)
NAME
podman-system-check - Perform consistency checks on image and container
storage
SYNOPSIS
podman system check [options]
DESCRIPTION
Perform consistency checks on image and container storage, reporting im-
ages and containers which have identified issues.
OPTIONS
--force, -f
When attempting to remove damaged images, also remove 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 en-
gine created them, but because podman only "knows" how to shut down con-
tainers that it started, the effect on still-running containers which
were started by other engines is difficult to predict.
--max, -m=duration
When considering layers which are not used by any images or containers,
assume 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
Skip checks which are known to be time-consuming. This will prevent
some types of errors from being detected.
--repair, -r
Remove 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
podman-system-check(1)
Generated by dwww version 1.16 on Tue Dec 16 06:03:14 CET 2025.