This release note covers Podman Desktop 0.11 release changes.
- Air-Gapped Installation: New all-in-one binaries for air-gapped installation.
- Feedback: Submit feedback directly from Podman Desktop.
- Docker Compatibility Mode: Information about the Docker compatibility mode.
- Proxy Setting: Toggle on/off the proxy setting.
- Deploy to Kubernetes: Select the namespace to deploy to Kubernetes.
- Registry Configuration: Simplified registry configuration for well known registries.
- UX/UI Improvements: View pod's container logs, better visual feedback, configurable editor font size, and more.
Podman Desktop 0.11 is now available. Click here to download it!
For users who are not able to connect to the internet, a new all-in-one (airgap) binary that includes the Podman Desktop application and the Podman binaries is now available for both Mac and Windows. When initializing a new Podman machine using all-in-one binaries, it'll use the embedded files and not grab them from internet:
- on Mac, it embeds the qemu FCOS binaries.
- on Windows, it embeds the WSL binary.
To differentiate the air-gapped binaries from the regular ones, you can check the artifactname, they're containing 'airgap' and are bigger. Please note, that those binaries are available only on releases and not the pre-releases.
There is also an optional way to provide a custom Podman machine image in the create machine form. By providing the path to the image you want, Podman Desktop will create a machine with that image. Leaving the field empty will use the default image (the one included in the binary).
Submitting feedback on Podman Desktop is getting easier as it is possible directly within the tool. This will help to get more information about the issues you are facing and will help us to improve the tool.
Please feel free to submit any feedback you have, we are looking forward to hearing from you!
The Docker compatibility mode is a feature that allows to use Podman as a drop-in replacement for Docker. It relies on the Docker socket helper provided with Podman and automatically handle the local setup of Podman path to the Docker socket. Tools like Testcontainers or others are relying on this to communicate to the container engine.
In this new version of Podman Desktop, we are now providing information to the user about the status of this compatibility mode directly on the dashboard page. The way it works is the following:
- When Docker is running: the socket is pointing to Docker.
- When Podman is starting and Docker is not running: the docker API socket will use Podman.
In case the compatibility mode is not activated, new documentation on how to activate it and how to easily switch between Docker and Podman is available here: https://podman-desktop.io/docs/migrating-from-docker.
This is a warning displayed for Windows users:
This is the warning for Mac users:
In some context, users need the ability to disable and re-enable the proxy configuration very quickly, without having to entirely reconfigure it. This is now possible from the Podman Desktop settings page, where a toggle to enable/disable the proxy configuration has been added.
Note: extensions can read this information and then update the proxy configuration.
A new dropdown menu has been added to the deploy to Kubernetes screen to allow selecting the namespace to deploy to. Defaults to defaultnamespace, if unable to get any from kube_client module.
If the user have set
kubectl config set-context --current --namespace=NAMESPACE it honors that as the chosen value.
Users might use a custom path to the podman binary. An option within settings (Settings -> Preferences) to allow providing an additional path to Podman binary has been added. This is useful for users who have installed Podman using a package manager and want to use the binary provided by the package manager. See: Unable to set custom binary path for Podman on macOS
The experience of configuring a registry is getting simplified for the most popular ones. The user will be able to select a registry from a pre-defined list and will only have to provide the username and password. The following registries will be pre-defined:
- Red Hat Quay
- IBM Container Registry
- Google Container Registry
The pods details view provides the ability to view the logs of each containers that might be running in a pod. Moreover, as it can also be hard to scan and identify which container is producing which output, we appended the container name at the beginning of each output and differentiate each container with a different color.
When starting/stopping or deleting a container, a spinner is now displayed. In case of error, a message indicating that the action failed will also be better indicated.
For containers that exit immediately or short-lived containers, the feedback is also improved and include report of error now provide a better feedback to the user #1161.
An editor is used in several screens of Podman Desktop, from the inspect screen to container's outputs and Kubernetes YAML. The default font size is 10 pixels. It's now possible to adjust the font size to the one the one you prefer. This setting is persisted and will be used for all the editors of Podman Desktop and available from the preferences page (Settings -> Preferences).
When switching from different screens of the application or simply refreshing the list of containers, the expanded state of each item in the list is now persisted and will be properly restored.
The list of containers also displays pods, now clicking on the pod name directly redirects to the Pod details page.
The style of the buttons for actions on item in the list of in details pages have been improved. The background has been removed, but to make the hover state more visible, the "hover" circle is visble and the icon's color is also changing.
On details pages:
The alignment of the items in the list of containers and pods have been improved. The header of each columns are now aligned with the text. and the actions icons are now aligned with the top of the text.
Other Notable Enhancements
- Statistics area in container details are always shown. (#1131)
- Add more descriptive wording and more information to extensions. (#985)
- Allow to install on-the fly Podman Desktop extensions using an OCI image. (#1187)
- Display correctly non-multiplexed stream in logs (when using non interactive mode). (#1197)
- Font changed from white to gray for non-name sections (creation date, size). (#1206)
- Add Help/about menu for macOS/Windows/Linux. (#1207)
Coming with this new version of Podman Desktop, the documentation has been getting attention (with number of editorial reviews) and new content have been added.
Content for helping users to migrate from Docker to Podman has been added:
- Using the
podman-mac-helpertool to migrate from Docker to Podman on macOS
- better identify podman-mac-helper verification steps
- Emulating Docker CLI using Podman to migrate from Docker to Podman
- Migrating from Docker section
- Verifying that your tools are using Podman
- Importing saved containers
Several of other improvements have been made to the documentation and the website:
- Troubleshooting for Apple Silicon and brew x86_64 installs
- Change text of custom binary location, add docs
- Silent install option for windows
- Upgrade to vite v4 and rollup v3
- Refreshing documentation on installing on Linux
- Identify the shell sessions in Installing on Linux
- Website: the linux binary is not a source, it should be promoted as a binary
- Introducing tabs for operatings systems and container engines
- website: In the landing page, update plugins and container engines lists
- Document where code is located within Podman Desktop
- (extension-api): Documentation on how to write an extension and use the api
Notable bug fixes
- Update to v0.3.2 Docker Desktop API for extensions - #1070
- Updated link to the Matrix room - #1076
- Report error when container name already exists - #1142
- Fixed connectivity to the Podman machine when the generated socket length is greater than 104 characters in MacOS - #1145
- Do not use long calls for external clients - #1151
- Invalid name/tag for images with registries using a different port - #1127
- Invalid badge count for images when two images have the same tag - #1124
- Fixed detection of WSL2 - #981
- Handle invalid kubeconfig files instead of crashing - #953
- Removed redundant actions from details pages - #1200
- Fixed registry URL not aligned with header - #1205
- Moved SVGs to reusable components - #1211
Extensions API has also been improved in this new release:
- (extension-api): Allows to register a factory for kubernetes connection objects (like for container connections) - #1040
- (extension-api): List or inspect containers, be notified on events - #1041
- (extension-api): Allows to get provider notification - #1045
- (dd-extension-api): Implement toast API - #1154
- (extension-api): Moved extension properties to preferences - #948
- (dd-extension-api): Added open dev console on dd webview in development mode - #1071
- (extension-api): Added notes on extension and frameworks/tooling of Podman Desktop - #1166
- (extension-api): Documentation on how to write an extension and use the api - #1172
- (dd-extension-api): DD extensions should see only minimal information on containers - #1191
Community Thank You
🎉 We’d like to say a big thank you to everyone who helped to make Podman Desktop 0.11 even better:
- Emmanuel Bernard in #962 - Troubleshooting for Apple Silicon
- Michael Prankl in #974 - Silent install option for windows
- Endre Lervik in #1008 - Namespace selection for deploy to kubernetes
- Evan FP in #1145 - fixed socket path length error
- Lokesh Mandvekar in #956 - add repository key to package.json
- Jean François Maury in #1194 - Cannot create Kind cluster on Windows
The complete list of issues fixed in this release is available here.
Get the latest release from the Downloads section of the website and boost your development journey with Podman Desktop. Additionally, visit the GitHub repository and see how you can help us make Podman Desktop better.