A page with notes about Podman. There is also a Podman cheatsheet available.

Changing container image location

mv ~/.local/share/containers /data/podman-containers
mkdir ~/.local/share/containers
mount --bind /data/podman-containers ~/.local/share/containers

Adding to fstab for persistence.

/data/podman-containers ~/.local/share/containers none bind

Common problems

Did not resolve to an alias

If referencing an image, say postgres:14, the following error shows:

Error: short-name "postgres:14" did not resolve to an alias and no unqualified-search registries are defined in "/etc/containers/registries.conf"

It can be the case that you referencing unqualified images1. The previous behaviour (using unqualified image names) can be restated by adding the line below in /etc/containers/registries.conf.

unqualified-search-registries = ["docker.io"]

  1. See man 5 containers-registries.conf for more information. ↩︎