Features
- The
podman manifest inspectcommand now supports the--authfileoption, for authentication purposes. - The
podman waitcommand now supports--condition={healthy,unhealthy}, allowing waits on successful health checks. - The
podman pushcommand now supports a new option,--compression-level, which specifies the compression level to use (#18939). - The
podman machine startcommand, when run with--log-level=debug, now creates a console window to display the virtual machine while booting. - Podman now supports a new option,
--imagestore, which allows images to be stored in a different directory than the graphroot. - The
--ip-rangeoption to thepodman network createcommand now accepts a new syntax,<startIP>-<endIP>, which allows more flexibility when limiting the ip range that Podman assigns. - [Tech Preview] A new command,
podmansh, has been added, which executes a user shell within a container when the user logs into the system. The container that the users get added to can be defined via a Podman Quadlet file. This feature is currently aTech Previewwhich means it's ready for users to try out but changes can be expected in upcoming versions. - The
podman network createcommand supports a new--option,bclim, for themacvlandriver. - The
podman network createcommand now supports adding static routes using the--routeoption. - The
podman network createcommand supports a new--option,no_default_routefor all drivers. - The
podman infocommand now prints network information about the binary path, package version, program version and DNS information (#18443). - The
podman infocommand now displays the number of free locks available, helping to debug lock exhaustion scenarios. - The
podman infocommand now outputs information about pasta, if it exists in helper_binaries_dir or $PATH. - The remote Podman client’s
podman buildcommand now accepts Containerfiles that are not in the context directory (#18239). - The remote Podman client’s
podman play kubecommand now supports the--configmapoption (#17513). - The
podman kube playcommand now supports multi-doc YAML files for configmap arguments. (#18537). - The
podman pod createcommand now supports a new flag,--restart, which sets the restart policy for all the containers in a pod. - The
--format={{.Restarts}}option to thepodman pscommand now shows the number of times a container has been restarted based on its restart policy. - The
--format={{.Restarts}}option to thepodman pod pscommand now shows the total number of container restarts in a pod. - The podman machine provider can now be specified via the
CONTAINERS_MACHINE_PROVIDERenvironment variable, as well as via theproviderfield incontainers.conf(#17116). - A default list of pasta arguments can now be set in
containers.confviapasta_options. - The
podman machine initandpodman machine setcommands now support a new option,--user-mode-networking, which improves interops with VPN configs that drop traffic from WSL networking, on Windows. - The remote Podman client’s
podman pushcommand now supports the--digestfileoption (#18216). - Podman now supports a new option,
--out, that allows redirection or suppression of STDOUT (#18120).
Changes
- The
--filter id=xxxoption will now treatxxxas a CID prefix, and not as a regular expression (#18471). - The
--filteroption now requires multiple--filterflags to specify multiple filters. It will no longer support the comma syntax (--filter label=a,label=b). - The
slirp4netnsbinary for will now be searched for in paths specified by thehelper_binaries_diroption incontainers.conf(#18239). - Podman machine now updates
/run/docker.sockwithin the guest to be consistent with its rootless/rootful setting (#18480). - The
podman system dfcommand now counts files which podman generates for use with specific containers as part of the disk space used by those containers, and which can be reclaimed by removing those containers. It also counts space used by files it associates with specific images and volumes as being used by those images and volumes. - The
podman buildcommand now returns a clearer error message when the Containerfile cannot be found. (#16354). - Containers created with
--pid=hostwill no longer print errors on podman stop (#18460). - The
podman manifest pushcommand no longer requires a destination to be specified. If a destination is not provided, the source is used as the destination (#18360). - The
podman system resetcommand now warns the user that the graphroot and runroot directories will be deleted (#18349), (#18295).
Quadlet
- Quadlet now exits with a non-zero exit code when errors are found (#18778).
- Rootless podman quadlet files can now be installed in
/etc/containers/systemd/usersdirectory. - Quadlet now supports the
AutoUpdateoption. - Quadlet now supports the
MaskandUnmaskoptions. - Quadlet now supports the
WorkingDiroption, which specifies the default working dir in a container. - Quadlet now supports the
Sysctloption, which sets namespaced kernel parameters for containers (#18727). - Quadlet now supports the
SecurityLabelNetsted=trueoption, which allows nested SELinux containers. - Quadlet now supports the
Pulloption in.containerfiles (#18779). - Quadlet now supports the
ExitCodefield in.kubefiles, which reflects the exit codes of failed containers. - Quadlet now supports
PodmanArgsfield. - Quadlet now supports the
HostNamefield, which sets the container's host name, in.containerfiles (#18486).
Bugfixes
- Fixed a bug where the
podman machine startcommand would fail with a 255 exit code. It now waits for systemd-user sessions to be up, and for SSH to be ready, addressing the flaky machine starts (#17403). - Fixed a bug where the
podman auto updatecommand did not correctly use authentication files when contacting container registries. - Fixed a bug where the
--dnsoption to thepodman runcommand was ignored for macvlan networks (#19169). - Fixed a bug in the
podman system servicecommand where setting LISTEN_FDS when listening on TCP would misbehave. - Fixed a bug where hostnames were not recognized as a network alias. Containers can now resolve other hostnames, in addition to their names (#17370).
- Fixed a bug where the
podman pod runcommand would error after a reboot on a non-systemd system (#19175). - Fixed a bug where the
--syslogoption returned a fatal error when no syslog server was found (#19075). - Fixed a bug where the
--mountoption would parse thereadonlyoption incorrectly (#18995). - Fixed a bug where hook executables invoked by the
podman runcommand set an incorrect working directory. It now sets the correct working directory pointing to the container bundle directory (#18907). - Fixed a bug where the
-device-cgroup-ruleoption was silently ignored in rootless mode (#18698). - Listing images is now more resilient towards concurrently running image removals.
- Fixed a bug where the
--forceoption to thepodman kube downcommand would not remove volumes (#18797). - Fixed a bug where setting the
--list-tagsoption in thepodman searchcommand would cause the command to ignore the--formatoption (#18939). - Fixed a bug where the
podman machine startcommand did not properly translate the proxy IP. - Fixed a bug where the
podman auto-updatecommand would not restart dependent units (specified viaRequires=) on auto update (#18926). - Fixed a bug where the
podman pullcommand would print ids multiple times when using additional stores (#18647). - Fixed a bug where creating a container while setting unmask option to an empty array would cause the create to fail (#18848).
- Fixed a bug where the propagation of proxy settings for QEMU VMs was broken.
- Fixed a bug where the
podman rm -facommand could fail to remove dependency containers such as pod infra containers (#18180). - Fixed a bug where
--tzoption to thepodman createandpodman runcommands would not create a proper localtime symlink to the zoneinfo file, which was causing some applications (e.g. java) to not read the timezone correctly. - Fixed a bug where lowering the ulimit after container creation would cause the container to fail (#18714).
- Fixed a bug where signals were not forwarded correctly in rootless containers (#16091).
- Fixed a bug where the
--filter volume=option to thepodman eventscommand would not display the relevant events (#18618). - Fixed a bug in the
podman waitcommand where containers created with the--restart=alwaysoption would result in the container staying in a stopped state. - Fixed a bug where the
podman statscommand returned an incorrect memory limit after acontainer update. (#18621). - Fixed a bug in the
podman runcommand where thePODMAN_USERNSenvironment variable was not ignored when the--podoption was set, resulting in a container created in a different user namespace than its pod (#18580). - Fixed a bug where the
podman runcommand would not create the/run/.containerenvwhen the tmpfs is mounted on/run(#18531). - Fixed a bug where the
$HOMEenvironment variable would be configured inconsistently between container starts if a new passwd entry had to be created for the container. - Fixed a bug where the
podman play kubecommand would restart initContainers based on the restart policy of the pod. initContainers should never be restarted. - Fixed a bug in the remote Podman client’s
buildcommand where an invalid platform would be set. - Fixed a bug where the
podman historycommand did not display tags (#17763). - Fixed a bug where the
podman machine initcommand would create invalid machines when run with certain UIDs (#17893). - Fixed a bug in the remote Podman client’s
podman manifest pushcommand where an error encountered during the push incorrectly claimed that the error occurred while adding an item to the list. - Fixed a bug where the
podman machine rmcommand would remove the machine connection before the user confirms the removal of the machine (#18330). - Fixed a bug in the sqlite database backend where the first read access may fail (#17859).
- Fixed a bug where a podman machine could get stuck in the
startingstate (#16945). - Fixed a bug where running a container with the
--network=container:option would fail when the target container uses the host network mode. The same also now works for the other namespace options (--pid,--uts,--cgroupns,--ipc) (#18027). - Fixed a bug where the
--format {{.State}}option to thepodman pscommand would display the status rather than the state (#18244). - Fixed a bug in the
podman commitcommand where setting a--messagewhile also specifying--format=dockeroptions would incorrectly warn that setting a message is incompatible with OCI image formats (#17773). - Fixed a bug in the
--formatoption to thepodman historycommand, where the{{.CreatedAt}}and{{.Size}}fields were inconsistent with Docker’s output (#17767), (#17768). - Fixed a bug in the remote Podman client where filtering containers would not return all matching containers (#18153).
API
- Fixed a bug where the Compat and Libpod Top endpoints for Containers did not correctly report errors.
- Fixed a bug in the Compat Pull and Compat Push endpoints where errors were incorrectly handled.
- Fixed a bug in the Compat Wait endpoint to correctly handle the "removed" condition (#18889).
- Fixed a bug in the Compat Stats endpoint for Containers where the
online_cpusfield was not set correctly (#15754). - Fixed a bug in the Compat Build endpoint where the pull field accepted a boolean value instead of a string (#17778).
- Fixed a bug where the Compat History endpoint for Images did not prefix the image ID with
sha256:(#17762). - Fixed a bug in the Libpod Export endpoint for Images where exporting to an oci-dir or a docker-dir format would not export to the correct format (#15897).
- The Compat Create endpoint for Containers now supports the
platformparameter (#18951). - The Compat Remove endpoint for Images now supports the
noprunequery parameter, which ensures that dangling parents of the specified image are not removed - The Compat Info endpoint now reports running rootless and SELinux enabled as security options.
- Fixed a bug in the Auth endpoint where a nil dereference could potentially occur.
Misc
- The
podman system servicecommand is now supported on FreeBSD. - Updated the Mac pkginstaller QEMU to v8.0.0
- Updated Buildah to v1.31.0
- Updated the containers/storage library to v1.48.0
- Updated the containers/image library to v5.26.1
- Updated the containers/common library to v0.55.2