5.5.2

Latest release in branch 5.5
Released 1 year ago (July 20, 2024)

Software Podman
Branch 5.5
First official release version 5.5.0
First official release date 1 year ago (June 30, 2024)
Release notes https://github.com/containers/podman/releases/tag/v5.5.0
Source code https://github.com/containers/podman
Documentation https://podman.io/docs/
Download https://podman.io/docs/installation
Podman 5.5 Releases View full list

What is new in Podman 5.5

Podman 5.5 brings practical new tools for working with OCI artifacts, easier file transfer to Podman machines, and better Quadlet support for systemd integration. It also adds useful options for building images, updating containers, and Kubernetes workflows while improving performance and security in several areas.

In my experience managing container platforms in enterprise environments, these additions make artifact handling and machine management more efficient, especially for teams using Quadlets in production.

Key New Features in Podman 5.5

Feature Description
Podman Machine New podman machine cp command to copy files directly into a running virtual machine.
Artifact Support New podman artifact extract command to copy OCI artifact contents to disk. Added --mount type=artifact support for mounting artifacts into containers with podman run, podman create, and podman pod create.
Artifact Add Command podman artifact add now supports --append to add files to an existing artifact and --file-type to specify MIME type.
Artifact Remove podman artifact rm gains --all option to remove all local artifacts.
Build Improvements New --inherit-labels option for podman build (defaults to true) to control label inheritance from base images.

Quadlet and Systemd Enhancements

Podman 5.5 continues to improve Quadlet support with new configuration keys and smarter dependency handling:

  • New keys in .container units: Memory=, ReloadCmd, ReloadSignal.
  • Retry and RetryDelay added to .container, .image, and .build units.
  • HostName= support in .pod units.
  • UpheldBy in the Install section.
  • Automatic translation of dependency names (for example, Wants=my.container now works correctly).
  • Warnings are now shown for skipped lines in malformed Quadlet files.

Other Notable Improvements

Additional useful changes include:

  • New command filter for --filter in many container commands such as podman ps, podman start, and podman stop.
  • podman exec now supports --cidfile to read the container ID from a file.
  • podman update adds --env and --unsetenv to modify environment variables on running containers.
  • New global option --cdi-spec-dir to specify additional CDI specification directories.
  • Kubernetes support for the annotation io.podman.annotation.pids-limit/$containername in podman kube generate and podman kube play.
  • Podman now generates events when secrets are created or removed.

Changes and Security Notes

Podman 5.5 requires Go 1.23 as the minimum build version. Healthchecks were refactored to reduce database writes and improve performance. A new healthcheck status stopped appears if the container stops before the check finishes.

Containers inside pods now stop in the correct dependency order, with the infra container stopped last. For better security, /proc/interrupts and certain CPU thermal throttle paths are masked by default.

The Windows installer no longer automatically installs WSLv2 or Hyper-V. The default pause image was replaced with a root filesystem using the catatonit binary.

Bug Fixes in Podman 5.5

This release includes many fixes that improve stability:

  • Healthchecks no longer run on paused containers.
  • Fixed mounting images without CAP_SYS_ADMIN to prevent panics.
  • Corrected podman exec additional group handling and network connect/disconnect errors in podman inspect.
  • Improved podman kube generate for subpath volume mounts and empty pods.
  • Fixed issues with remote client on Windows for volume mounts and path handling.
  • podman container clone now properly copies healthcheck settings.
  • Resolved negative reclaimable size in podman system df and several Podman machine related problems.

Dependency Updates

Component Version
Buildah v1.40.0
containers/common v0.63.0
containers/image v5.35.0
containers/storage v1.58.0

Frequently Asked Questions about Podman 5.5

What is the easiest way to copy files into a Podman machine?

Use the new podman machine cp command, which works with running virtual machines.

How can I mount an OCI artifact inside a container?

Use the new mount type with --mount type=artifact,src=artifact-name,dest=/path/in/container.

Does Podman 5.5 improve Quadlet usability?

Yes. New keys for memory, reload behavior, retries, and automatic dependency translation make Quadlet files more powerful and easier to maintain.

Is there any change to healthcheck behavior?

Healthchecks are more efficient and now show a stopped status when the container stops early. They also no longer run on paused containers.

Summary of Podman 5.5

Podman 5.5 strengthens artifact workflows, adds convenient machine and Quadlet features, and delivers many stability improvements. These updates help developers and administrators work more effectively with containers, virtual machines, and systemd-integrated setups.

Releases In Branch 5.5

Version Release date
5.5.2 1 year ago
(July 20, 2024)
5.5.1 1 year ago
(July 10, 2024)
5.5.0 1 year ago
(June 30, 2024)
5.5.0-rc1 1 year ago
(June 25, 2024)