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

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. ↩︎