Releases · containers/podlet

02 Feb 17:18

v0.3.1

ca463af

0.3.1 - 2026-02-02 Latest

Latest

Release Notes

After an extended hiatus, Podlet is back! I, @k9withabone, apologize for my prolonged absence and silence. Life is overwhelming at times.
The good news is @TheRealBecks has stepped up and joined me as a maintainer! We are also looking another maintainer to join us! If you are interested please comment on this discussion (#171).

This is a fairly large release which includes a number of bug fixes and new features. In the future, the goal is to have smaller releases more frequently. Here are some highlights of this release:

Added support for Quadlet options introduced in Podman v5.1.0 (#85) and v5.2.0 (#123). This includes support for creating .build Quadlet files with podlet podman build and from the build section of a service in a Compose file.
Added the -s, --split-options option (#168) which allows the user to specify which Quadlet options should be split onto multiple lines.
By default, Podlet combines all Quadlet options that can be into a space separated list.
For example, podlet podman run -e ONE=one -e TWO=two image results in:
```
# image.container
[Container]
Environment=ONE=one TWO=two
Image=image
```
While podlet -s Environment podman run -e ONE=one -e TWO=two image results in:
```
# image.container
[Container]
Environment=ONE=one
Environment=TWO=two
Image=image
```
See podlet --help for more information and all Quadlet options that can be split.
Fixed a number of bugs related to Compose file handling (#122).
Added a Minimum Supported Rust Version (MSRV) policy (#169) which can be seen in the contribution guide.

Features

(container) Add GroupAdd= Quadlet option.
(container) Add subpath image mount option.
(generate) Add options to ignore unsupported pod options. (#86)
- Added --ignore-infra-conmon-pidfile and --ignore-pod-id-file options to podlet generate pod.
- The --infra-conmon-pidfile and --pod-id-file options are deliberately unimplemented by podlet podman pod create as they are set by Quadlet when generating the systemd service unit file, and cannot be set multiple times. Because podlet generate pod uses podlet podman pod create internally, this caused an error when attempting to generate a .pod Quadlet file from a pod created using either of those options, such as those created with the deprecated podman generate systemd command.
(compose) Merge << keys. (#58)
(compose) Perform additional validation.
- Ensures that networks, volumes (when used across multiple services), configs, and secrets used in each service are defined in the appropriate top-level field.
(container) Add LogOpt= Quadlet option.
(container) Add StopSignal= Quadlet option.
(container) Add NetworkAlias= Quadlet option.
(pod) Add NetworkAlias= Quadlet option.
(build) Generate .build Quadlet file from command.
- Added the podlet podman build subcommand.
(compose) .build Quadlet files from Compose. (#100)
- Added support to podlet compose for converting the build section of a Compose service to a .build Quadlet file.
(compose) Search for podman-compose.yaml when using podlet compose by [@TheRealBecks] in #167.
Add --split-options option. (#118)
- By default, when generating a Quadlet file, Podlet will combine all Quadlet options that can be into a space separated list (e.g., Environment=ONE=one TWO=two). The --split-options option allows the user to specify which Quadlet options they would like Podlet to write on separate lines.

Bug Fixes

Support podman pod create --name option by @ananthb in #89.
(compose) Append .network to container network name. (#90)
(generate) Accept array or object from podman inspect output. (#94)
- Podman v5.0.0 and newer always returns an array from podman inspect. Older versions of Podman may return a single JSON object if there is only one result, notably for podman pod inspect.
(compose) Prepend container dependencies with pod name. (#114)
- When the podlet compose --pod option is used, the names of the services from the Compose file are prepended with the pod name. If a service had a dependency via the depends_on attribute, the name of the dependency was not similarly prepended with the pod name when added to the [Unit] section of the Quadlet file.
(compose) Support services[].memswap_limit.
- The services[].memswap_limit attribute is translated to podman run --memory-swap.
(container) Support short flag -h for podman run --hostname. (#105)
- Changed short help flag to -? for podlet podman run. This could be a potentially minor breaking change for some users.
(compose) .build Quadlet file error reporting. (#126)
- If there was an error converting the build section of a Compose service it would not be reported to the user. The rest of the service would fail to convert to a .container Quadlet file as the image would not be set (it's set after the build section is successfully converted). The user would receive a "image or build is required" error as the service error would be reported first.

Documentation

(readme) Add homebrew to the installation section by @cprecioso in #80.
(contributing) Add MSRV policy.
- Set MSRV to 1.85, following the Rust version in Debian stable.
(readme) Update demo, features, and usage.

Refactor

Add generic impls of HostPaths trait.
Destruct tuples to enhance readability by @Integral-Tech.
impl Serialize for podlet::quadlet::File.
- Changed podlet::serde::quadlet::Serializer to accept sequences and tuples in addition to structs. Elements in a sequence are serialized as separate sections. Tuples are combined into a single section (for combining podlet::quadlet::Resource and podlet::quadlet::Globals).

Miscellaneous

(release-container) Add --all to buildah manifest push. (#82)
Add Podman v5.1.0 to PodmanVersion.
(deps) Update compose_spec to v0.3.0. (#91, #96, #106, #117)
Add Podman v5.2.0 to PodmanVersion.
(ci) Add msrv job.
Update to Rust 2024 edition.
- Includes changes to formatting for the Rust 2024 style edition.
(deps) Replace nix with rustix.
(lints) Fix Clippy lints.
(release) Update dist.
- Formerly known as cargo-dist.
(ci) Bump actions/checkout to v6.
(ci) Add spellcheck job.
(deps) Update dependencies.

New Contributors

@TheRealBecks made their first contribution in #167
@Integral-Tech made their first contribution in #129
@ananthb made their first contribution in #89
@cprecioso made their first contribution in #80

Download podlet 0.3.1

File	Platform	Checksum
podlet-aarch64-apple-darwin.tar.xz	Apple Silicon macOS	checksum
podlet-x86_64-apple-darwin.tar.xz	Intel macOS	checksum
podlet-aarch64-pc-windows-msvc.zip	ARM64 Windows	checksum
podlet-x86_64-pc-windows-msvc.zip	x64 Windows	checksum
podlet-aarch64-unknown-linux-gnu.tar.xz	ARM64 Linux	[checksum](https://github.com/containers/podlet/releases/download/v0.3.1/podlet-aarch64-unknow...

Contributors

cprecioso, TheRealBecks, and 2 other contributors

Assets 20

dist-manifest.json

sha256:263e4e9a258b74a348bcaf713f17db2d7158aafa5b6d85388ed38fb086295101

40 KB 2026-02-02T17:18:51Z
podlet-aarch64-apple-darwin.tar.xz

sha256:456e8040f3a74aef658967b30d58eaf69f5367478fc9064950ff37f5050f1f58

2.01 MB 2026-02-02T17:18:51Z
podlet-aarch64-apple-darwin.tar.xz.sha256

sha256:d8e0b61e4b1a818a65ffe34ce30669731f477a455d659f9855410ec8688c79d3

102 Bytes 2026-02-02T17:18:51Z
podlet-aarch64-pc-windows-msvc.zip

sha256:3111fa4f6c3858ec9801ac22c0a8aacc02024ba5d47f4132da7c97eac3ee0a47

2.47 MB 2026-02-02T17:18:51Z
podlet-aarch64-pc-windows-msvc.zip.sha256

sha256:e15e7b8fbe02eb68dbeae9be577c10d788daf68a281ace69d5ec544235646e96

102 Bytes 2026-02-02T17:18:51Z
podlet-aarch64-unknown-linux-gnu.tar.xz

sha256:af5d7e2a4d001e9aa3951b75479de6e6acc34f7af89edf450419b26982574d30

2.34 MB 2026-02-02T17:18:51Z
podlet-aarch64-unknown-linux-gnu.tar.xz.sha256

sha256:510def84424160df7dffe7dbe4de78cd8dc133c664bb24f0f73651c415d367bf

107 Bytes 2026-02-02T17:18:51Z
podlet-x86_64-apple-darwin.tar.xz

sha256:59ca6307b088c5add34556e64e723af946aed81c003f23dedfdf1a7c79e2f257

2.4 MB 2026-02-02T17:18:51Z
podlet-x86_64-apple-darwin.tar.xz.sha256

sha256:a08586a65506e96e875b9da3d3234b6fdf4b76e19f1a8293a1db5716a09fb6ca

101 Bytes 2026-02-02T17:18:51Z
podlet-x86_64-pc-windows-msvc.zip

sha256:237f6bf7664c421712f3b622e6f78a2affb3d0fbea8bf5553eec377bd4429d9a

2.61 MB 2026-02-02T17:18:51Z
Source code (zip)

2026-02-02T17:04:27Z
Source code (tar.gz)

2026-02-02T17:04:27Z

21 May 19:32

github-actions

v0.3.0

06825f7

0.3.0 - 2024-05-21

Release Notes

Big release for Podlet!

In case you didn't already notice, Podlet is now officially a part of the Containers community! As a part of the transition, a new code of conduct, security policy, and contribution guidelines were added (#76). Additionally, the Podlet container image is now available at ghcr.io/containers/podlet. The existing images at quay.io/k9withabone/podlet and docker.io/k9withabone/podlet are deprecated and will not be receiving updates.

Under the hood, the library used to deserialize Compose files was changed (#73). As a result, only Compose files which follow the Compose specification are supported. The top-level version field is completely ignored. Most Compose files should still work as before. This was a large change so look out for bugs.

Added support for Quadlet options introduced in Podman v5.0.0 (#75). The headline feature is support for generating Quadlet .pod files. They can be generated from:

A Podman command with podlet podman pod create.
A Compose file with podlet compose --pod.
An existing pod with podlet generate pod.
- This creates a .pod file and a .container file for each container in the pod.

Note that the existing option for generating Kubernetes Pod YAML from a Compose file was renamed to podlet compose --kube. Both the --pod and --kube options of podlet compose do not take an argument and instead require the top-level name field in the Compose file. The name is used as the name of the pod and in the filename of the created files.