diff --git a/404.html b/404.html index 4209035e4c3..b83e891dcf4 100644 --- a/404.html +++ b/404.html @@ -13,13 +13,13 @@ - +
Skip to main content

Page Not Found

We could not find what you were looking for.

Please contact the owner of the site that linked you to the original URL and let them know their link is broken.

- + \ No newline at end of file diff --git a/assets/js/b2f554cd.93d789a4.js b/assets/js/b2f554cd.93d789a4.js new file mode 100644 index 00000000000..63ed30e847a --- /dev/null +++ b/assets/js/b2f554cd.93d789a4.js @@ -0,0 +1 @@ +"use strict";(self.webpackChunkdocs=self.webpackChunkdocs||[]).push([[1477],{30010:e=>{e.exports=JSON.parse('{"blogPosts":[{"id":"podman-desktop-release-1.3","metadata":{"permalink":"/blog/podman-desktop-release-1.3","source":"@site/blog/2023-08-16-release-1.3.md","title":"Release Notes - Podman Desktop 1.3","description":"Podman Desktop 1.3 has been released!","date":"2023-08-16T00:00:00.000Z","formattedDate":"August 16, 2023","tags":[{"label":"podman-desktop","permalink":"/blog/tags/podman-desktop"},{"label":"release","permalink":"/blog/tags/release"},{"label":"kubernetes","permalink":"/blog/tags/kubernetes"},{"label":"openshift","permalink":"/blog/tags/openshift"}],"readingTime":5.195,"hasTruncateMarker":false,"authors":[{"name":"Denis Golovin","title":"Principal Software Engineer","url":"https://github.com/cdrage","imageURL":"https://github.com/dgolovin.png","key":"dgolovin"}],"frontMatter":{"title":"Release Notes - Podman Desktop 1.3","description":"Podman Desktop 1.3 has been released!","slug":"podman-desktop-release-1.3","authors":["dgolovin"],"tags":["podman-desktop","release","kubernetes","openshift"],"hide_table_of_contents":false,"image":"/img/blog/podman-desktop-release-1.3.webp"},"nextItem":{"title":"Release Notes - Podman Desktop 1.2","permalink":"/blog/podman-desktop-release-1.2"}},"content":"import ReactPlayer from \'react-player\'\\n\\nPodman Desktop 1.3 Release! \ud83c\udf89\\n\\nThis is essentially a bug-fix release to fix various issues in UI, extension engine and featured extensions, but as usual we also added a few new features.\\n\\n- **Podman 4.6.1**: Podman 4.6.1 included in Windows and Mac installers\\n- **Podman user-mode networking support to Windows/WSL**: A new switch `User mode networking\' is available when creating Podman machine on Windows for Podman 4.6.0+ to configure podman to work in certain VPN setups and other specialized networking configurations\\n- **Compose group new UI elements**: You can now see summary, inspect, deploy to kubernetes, generate kube yaml and view logs\\n- **Extension packs and extension dependencies**: Install group of extensions in one click\\n- **Resource details page update**: See summary and log for resource\\n- **Create Kind cluster form update**: A new `Node\'s container image` field can be used to specify the Kubernetes version used for the control-planed\\n- **Support Docker Desktop extensions using a backend**: When loading Docker Desktop extension the containers are created in the backend as described in the vm section of extension\'s descriptor\\n- **Podman Initial Onboarding (preview)**: Install and configure podman using included installer\\n\\nPodman Desktop 1.3 is now available. [Click here to download it](/downloads)!\\n\\n![Podman-desktop-1-3-bug-swatting](img/podman-desktop-release-1.3/title-bug-swatting.png)\\n\\n---\\n\\n## Release Details\\n\\n### Compose group Logs tab [#3176](https://github.com/containers/podman-desktop/pull/3176)\\n\\nWhen clicking on the group of containers, you can now view the logs of the entire group of compose containers and don\'t need to open\\nlog for every component individually.\\n\\n![Screenshot 2023-07-11 at 12 48 47 PM](https://github.com/containers/podman-desktop/assets/6422176/743a4ffc-e291-4697-8ac5-8052cc921946)\\n\\n### Podman user-mode networking support to Windows/WSL [#3251](https://github.com/containers/podman-desktop/pull/3251)\\n\\nCertain VPN setups or other specialized networking configs will block traffic from the virtual WSL networking device, resulting in the podman WSL backend from being unable to contact systems on the VPN, and potentially losing internet access altogether. The new switch allows you to create a podman VM machine configured to work correctly in mentioned above networking environments.\\n\\n![user](https://github.com/containers/podman-desktop/assets/620330/2f521576-b6a6-42b5-b24d-08df5b432608)\\n\\n### Compose group Summary tab [#3317](https://github.com/containers/podman-desktop/pull/3317),\\n\\nCompose group Summary tab shows all containers in the group and let you navigate to Details page for specific container.\\n\\n\\n\\n### Compose group Inspect tab [#3316](https://github.com/containers/podman-desktop/pull/3316)\\n\\nCompose group Inspect tab shows an array of \\"container inspect\\" from docker / podman.\\n\\n\\n\\n### `Deploy to kubernetes` in compose actions [#3299](https://github.com/containers/podman-desktop/pull/3295)\\n\\nA button to deploy to kubernetes added to Compose group.\\n\\n\\n\\n### `Generate Kube` in Compose actions and `Kube` tab in compose details [#3253](https://github.com/containers/podman-desktop/pull/3253)\\n\\n`Generate Kube` item added to Compose actions and \\"Kube\\" tab is now available in Compose details view.\\n\\n\\n\\n### Install multiple extensions using extension pack [#3150](https://github.com/containers/podman-desktop/pull/3150)\\n\\nAn Extension pack introduced in Extension engine is a way to declare set of extensions to install them all at once.\\n\\n\\n\\n### Customize icons from extension [#3131](https://github.com/containers/podman-desktop/pull/3131)\\n\\nExtensions now can customize icons for list elements using `when` clause.\\n\\n![image](https://github.com/containers/podman-desktop/assets/49404737/7aae5347-4f07-4854-ba11-1f629b5ccf22)\\n\\n### Resource details page update [#1923](https://github.com/containers/podman-desktop/pull/1923)\\n\\nIf you click on the arrow icon next to a resource name it will open up a details page (similarly to how clicking on a container in the container list opens up a details page).\\n\\n![image](https://user-images.githubusercontent.com/49404737/229542404-bae44f89-5cd3-4baf-8b08-e934e4462697.gif)\\n\\n### `Node\'s container image` field added to `Create a Kind cluster` form [#3508](https://github.com/containers/podman-desktop/pull/3508)\\n\\nThe new `Node\'s container image` field can be used to specify the Kubernetes version used for the control-planed.\\n\\n![image](https://github.com/containers/podman-desktop/assets/42176370/b2a63faf-629f-436d-8496-7c0cd8158679)\\n\\n### Support Docker Desktop extensions using a backend [#3435](https://github.com/containers/podman-desktop/pull/3435)\\n\\nPodman Desktop now loads the containers in the backend as described in the vm section of extension descriptor the same way as Docker Desktop does.\\n\\n### Initial onboarding implementation for podman (experimental) [#3308](https://github.com/containers/podman-desktop/pull/3308)\\n\\nThis is the initial implementation for the onboarding feature. It only covers a simple onboarding for podman. Check system requirements -> install podman -> yay! Done!\\n\\n### Notable Bug Fixes\\n\\n- Updating videos to be adaptive for mobile by @mairin [#3229](https://github.com/containers/podman-desktop/pull/3229)\\n- Consistent max width and padding in settings by @deboer-tim [#3232](https://github.com/containers/podman-desktop/pull/3232)\\n- Settings navigation bar resizing by @deboer-tim in [#3231](https://github.com/containers/podman-desktop/pull/3231)\\n- Move new registry button to header by @deboer-tim [#3245](https://github.com/containers/podman-desktop/pull/3245)\\n- Bigger lima logo by @afbjorklund [#3248](https://github.com/containers/podman-desktop/pull/3248)\\n- Horizontal docker logo by @afbjorklund [#3236](https://github.com/containers/podman-desktop/pull/3236)\\n- Respect LIMA_HOME environment variable by @afbjorklund [#3254](https://github.com/containers/podman-desktop/pull/3254)\\n- Add check before writing to terminal by @lstocchi [#3263](https://github.com/containers/podman-desktop/pull/3263)\\n- Wait until remote side has fully initialized the extensions by @benoitf [#3257](https://github.com/containers/podman-desktop/pull/3257)\\n- Fix loader not centered horizontally by @benoitf [#3270](https://github.com/containers/podman-desktop/pull/3270)\\n- Troubleshooting still waiting after failure by @deboer-tim [#3354](https://github.com/containers/podman-desktop/pull/3354)\\n- Store error for build by @cdrage [#3365](https://github.com/containers/podman-desktop/pull/3365)\\n- Missing checkbox tooltips by @deboer-tim [#3380](https://github.com/containers/podman-desktop/pull/3380)\\n- Load compose logs async not await by @cdrage [#3377](https://github.com/containers/podman-desktop/pull/3377)\\n- Set rootful connection when starting rootful machine by @lstocchi [#3364](https://github.com/containers/podman-desktop/pull/3364)\\n- Default last page by @deboer-tim [#3388](https://github.com/containers/podman-desktop/pull/3388)\\n- Avoid dashboard displaying providers starting while they don\'t by @benoitf [#3451](https://github.com/containers/podman-desktop/pull/3451)\\n- Do not use extensionInfo until it is defined by @benoitf [#V](https://github.com/containers/podman-desktop/pull/3450)\\n- Allow BASIC authentication (all caps) by @cdrage [#3471](https://github.com/containers/podman-desktop/pull/3471)\\n- Allow single domain registry such as localhost:5000 by @cdrage [#3468](https://github.com/containers/podman-desktop/pull/3468)\\n- Create /usr/local/bin directory if it does not exist on binary install by @cdrage [#3425](https://github.com/containers/podman-desktop/pull/3425)\\n- Only delete selected pods by @deboer-tim [#](https://github.com/containers/podman-desktop/pull/3378)\\n- Add back \'Done\' text on the button by @benoitf [#3487](https://github.com/containers/podman-desktop/pull/3487)\\n- Do not wait for more than 5s when checking for podman ping by @benoitf [#3497](https://github.com/containers/podman-desktop/pull/3497)\\n- Add proxy support for extension using patching get and request approach by @dgolovin [#2825](https://github.com/containers/podman-desktop/pull/2825)\\n- Refresh component when field is updated by @benoitf [#3525](https://github.com/containers/podman-desktop/pull/3525)\\n- Higher-res icons for featured extensions list by @mairin [#3511](https://github.com/containers/podman-desktop/pull/3511)\\n- Main nav selection by @deboer-tim [#3510](https://github.com/containers/podman-desktop/pull/3510)\\n- kube event error when switching context by @jeffmaury [#3494](https://github.com/containers/podman-desktop/pull/3494)\\n- Reset error message each time we pull image by @benoitf [#3550](https://github.com/containers/podman-desktop/pull/3550)\\n\\n### Community Thank You\\n\\n\ud83c\udf89 We\u2019d like to say a big thank you to everyone who helped to make Podman Desktop even better.\\n\\nA warm welcome to [@rostalan](https://github.com/rostalan) and [@axel7083](https://github.com/axel7083) who made their first contribution to the project in this release.\\n\\n### Final Notes\\n\\nThe complete list of issues fixed in this release is available [here](https://github.com/containers/podman-desktop/issues?q=is%3Aclosed+milestone%3A1.3.0).\\n\\nGet the latest release from the [Downloads](/downloads) section of the website and boost your development journey with Podman Desktop. Additionally, visit the [GitHub repository](https://github.com/containers/podman-desktop) and see how you can help us make Podman Desktop better."},{"id":"podman-desktop-release-1.2","metadata":{"permalink":"/blog/podman-desktop-release-1.2","source":"@site/blog/2023-07-12-release-1.2.md","title":"Release Notes - Podman Desktop 1.2","description":"Podman Desktop 1.2 has been released!","date":"2023-07-12T00:00:00.000Z","formattedDate":"July 12, 2023","tags":[{"label":"podman-desktop","permalink":"/blog/tags/podman-desktop"},{"label":"release","permalink":"/blog/tags/release"},{"label":"kubernetes","permalink":"/blog/tags/kubernetes"},{"label":"openshift","permalink":"/blog/tags/openshift"}],"readingTime":6.05,"hasTruncateMarker":false,"authors":[{"name":"Charlie Drage","title":"Software Engineer","url":"https://github.com/cdrage","imageURL":"https://github.com/cdrage.png","key":"cdrage"}],"frontMatter":{"title":"Release Notes - Podman Desktop 1.2","description":"Podman Desktop 1.2 has been released!","slug":"podman-desktop-release-1.2","authors":["cdrage"],"tags":["podman-desktop","release","kubernetes","openshift"],"hide_table_of_contents":false,"image":"/img/blog/podman-desktop-release-1.2.webp"},"prevItem":{"title":"Release Notes - Podman Desktop 1.3","permalink":"/blog/podman-desktop-release-1.3"},"nextItem":{"title":"Release Notes - Podman Desktop 1.1","permalink":"/blog/podman-desktop-release-1.1"}},"content":"import ReactPlayer from \'react-player\'\\n\\nPodman Desktop 1.2 Release! \ud83c\udf89\\n\\nWe\'re excited to announce the release of Podman Desktop version 1.2.0! This release includes many new features (Kubernetes, Compose and extension support!), bug fixes, and improvements to enhance your container management experience. Here\'s a summary of the key changes in this release:\\n\\n- **Added start/stop/delete/restart buttons for Compose**: You can now make changes to an entire Compose group of containers\\n- **Kubernetes context on the status bar**: Choose from multiple Kubernetes contexts more easily all from the status bar\\n- **Rename images**: Rename an image with a click of a button\\n- **Protocol handler support**: Added support for protocol handlers such as `open podman-desktop:extension/redhat.openshift-local`\\n- **Troubleshooting page**: A troubleshooting page for helping diagnose Podman Desktop related development issues\\n\\nPodman Desktop 1.2 is now available. [Click here to download it](/downloads)!\\n\\n![Podman-desktop-1-2-hero](img/podman-desktop-release-1.2/podman-desktop-release-1.2.png)\\n\\n---\\n\\n## Release Details\\n\\n### Added start/stop/delete/restart buttons for Compose\\n\\nIn the last month we\'ve been addind support for more Compose features. Before you were only able to control a group of containers if they were in a Pod. Now we have added the ability to control a group of Compose containers. You can now start, stop, delete and restart a group of containers launched by either `docker-compose` or `podman-compose`.\\n\\nStay tuned as we add even more features to Compose! If you have any feedback or feature requests, feel free to open an issue or start a discussion on GitHub.\\n\\n\\n\\n### Kubernetes context on the status bar\\n\\nWith Kubernetes context on the status bar, you can switch from one context to another in just a couple of clicks. Easily switch to a different cluster all together. If there are multiple contexts available, you can now click and pick which one to use.\\n\\n\\n\\n### Rename images\\n\\nDeployed an image but now you need to rename it / add a new tag? Podman Desktop allows you to edit an image now. Thanks to an awesome contributor [@tuckerrc](https://github.com/tuckerrc) who added the new feature.\\n\\n\\n\\n### Troubleshooting page\\n\\nDeveloping an extension for Podman Desktop? Want to view the logs of Podman Desktop as well as ping your container connection? We now have a troubleshooting page!\\n\\nClick on the lightbulb button on the bottom right to access the page.\\n\\n\\n\\n### Protocol handler support\\n\\nPodman Desktop now supports protocol handling when using the terminal! Want to access your favourite extension directly from a script or the terminal? If you type in `open podman-desktop:extension/redhat.openshift-local` in the terminal, Podman Desktop will automatically load up to the correct extension.\\n\\n\\n\\n---\\n\\n## Other Notable Features\\n\\n- Background colors and FormPage ([PR #2977](https://github.com/containers/podman-desktop/pull/2977))\\n- Add ability to add insecure registry / skipping cert verify ([PR #2896](https://github.com/containers/podman-desktop/pull/2896))\\n- Add support for icon contribution ([PR #2984](https://github.com/containers/podman-desktop/pull/2984))\\n- Add warning dialog message that virtual machine has low memory limit ([PR #2822](https://github.com/containers/podman-desktop/pull/2822))\\n- Propose indexed name for new pod ([PR #3028](https://github.com/containers/podman-desktop/pull/3028))\\n- Add restart button after enabling / disabling mac os compatibility ([PR #2841](https://github.com/containers/podman-desktop/pull/2841))\\n- Add environment related helper constants ([PR #3079](https://github.com/containers/podman-desktop/pull/3079))\\n- Allow entrypoint and cmd when starting container ([PR #3031](https://github.com/containers/podman-desktop/pull/3031))\\n- Add a way to debug stores in troubleshooting page ([PR #3121](https://github.com/containers/podman-desktop/pull/3121))\\n- Add custompick component (#2855) ([PR #3012](https://github.com/containers/podman-desktop/pull/3012))\\n- Dynamic breadcrumbs ([PR #3119](https://github.com/containers/podman-desktop/pull/3119))\\n- Icons on form pages ([PR #3155](https://github.com/containers/podman-desktop/pull/3155))\\n- Switch more pages to formpage ([PR #3162](https://github.com/containers/podman-desktop/pull/3162))\\n- Add rename image button ([PR #2588](https://github.com/containers/podman-desktop/pull/2588))\\n- Fixed headers, improved scrollbars ([PR #2863](https://github.com/containers/podman-desktop/pull/2863))\\n- Reports warnings on failed kube deploy, fixes error out ([PR #3050](https://github.com/containers/podman-desktop/pull/3050))\\n- Kube context on statusbar ([PR #2755](https://github.com/containers/podman-desktop/pull/2755))\\n- Install provider if not installed when clicking on create new button (#2706) ([PR #2817](https://github.com/containers/podman-desktop/pull/2817))\\n- Add tag and authenticated push capacity to the extension API ([PR #2876](https://github.com/containers/podman-desktop/pull/2876))\\n- Add navigation bar e2e tests ([PR #2950](https://github.com/containers/podman-desktop/pull/2950))\\n\\n---\\n\\n## Documentation Updates\\n\\n- Fix documentation for building image of extensions ([PR #2873](https://github.com/containers/podman-desktop/pull/2873))\\n- Add Minikube install docs ([PR #2824](https://github.com/containers/podman-desktop/pull/2824))\\n- Add Minikube documentation ([PR #2694](https://github.com/containers/podman-desktop/pull/2694))\\n- Updated Building an image procedure ([PR #2964](https://github.com/containers/podman-desktop/pull/2964))\\n- Starting a container ([PR #2958](https://github.com/containers/podman-desktop/pull/2958))\\n- Pulling an image ([PR #2956](https://github.com/containers/podman-desktop/pull/2956))\\n- Updated selecting containers to run in a pod ([PR #2970](https://github.com/containers/podman-desktop/pull/2970))\\n- Pushing an image to a registry ([PR #2969](https://github.com/containers/podman-desktop/pull/2969))\\n- How to add an insecure registry ([PR #2953](https://github.com/containers/podman-desktop/pull/2953))\\n- Add documentation for lima ([PR #2995](https://github.com/containers/podman-desktop/pull/2995))\\n- Replace broken link to podman.io ([PR #2994](https://github.com/containers/podman-desktop/pull/2994))\\n- Authenticating to a pre-configured registry ([PR #2965](https://github.com/containers/podman-desktop/pull/2965))\\n- Lima is not a container engine ([PR #3051](https://github.com/containers/podman-desktop/pull/3051))\\n- Using the Troubleshooting page ([PR #3083](https://github.com/containers/podman-desktop/pull/3083))\\n- View and select your current Kubernetes context in the status bar ([PR #3090](https://github.com/containers/podman-desktop/pull/3090))\\n\\n---\\n\\n## Notable Bug Fixes\\n\\n- Deleting a running pod generates an error ([PR #2827](https://github.com/containers/podman-desktop/pull/2827))\\n- If kubeconfig is empty, does not try to do things, cancel ([PR #2874](https://github.com/containers/podman-desktop/pull/2874))\\n- Async telemetry startup ([PR #2885](https://github.com/containers/podman-desktop/pull/2885))\\n- Do not block startup while waiting for kube resource refresh ([PR #2884](https://github.com/containers/podman-desktop/pull/2884))\\n- Images list too wide ([PR #2918](https://github.com/containers/podman-desktop/pull/2918))\\n- Compose deactivate function never called ([PR #2922](https://github.com/containers/podman-desktop/pull/2922))\\n- Auto-scrolling on form pages, layout issues ([PR #2927](https://github.com/containers/podman-desktop/pull/2927))\\n- Show current context in quick pick ([PR #2920](https://github.com/containers/podman-desktop/pull/2920))\\n- Remove sticky position of loader in dashboard UI (#2535) ([PR #2959](https://github.com/containers/podman-desktop/pull/2959))\\n- Undo change that broke the website ([PR #2992](https://github.com/containers/podman-desktop/pull/2992))\\n- Detailspage, resizing & consistency ([PR #2987](https://github.com/containers/podman-desktop/pull/2987))\\n- Quick pick click to close and over nav bar ([PR #2758](https://github.com/containers/podman-desktop/pull/2758))\\n- Only show empty screen when no pods ([PR #2929](https://github.com/containers/podman-desktop/pull/2929))\\n- Do not redirect to /pods when deleting pod in containerlist ([PR #2963](https://github.com/containers/podman-desktop/pull/2963))\\n- Bulk delete on pods should call the pod deletion ([PR #2979](https://github.com/containers/podman-desktop/pull/2979))\\n- Update nodejs version to 18 in .nvmrc to fix yarn install failure ([PR #2989](https://github.com/containers/podman-desktop/pull/2989))\\n- Website check targets ([PR #2996](https://github.com/containers/podman-desktop/pull/2996))\\n- Don\'t show exception to user ([PR #3034](https://github.com/containers/podman-desktop/pull/3034))\\n- Interpret arguments given to info command for example ([PR #3015](https://github.com/containers/podman-desktop/pull/3015))\\n- Change defaults for Podman machine ([PR #3061](https://github.com/containers/podman-desktop/pull/3061))\\n- Normalize development/production folders path ([PR #3113](https://github.com/containers/podman-desktop/pull/3113))\\n- Calculate machine socket path for linux ([PR #3070](https://github.com/containers/podman-desktop/pull/3070))\\n- Replace backslash with slash so to support rendering on Windows (#3120) ([PR #3122](https://github.com/containers/podman-desktop/pull/3122))\\n- Keep stdout and stderr in the error object for Docker Desktop extensions ([PR #3014](https://github.com/containers/podman-desktop/pull/3014))\\n- Mark task completed if there\'s a failure ([PR #3016](https://github.com/containers/podman-desktop/pull/3016))\\n- Handle invalid kubeconfig file ([PR #3129](https://github.com/containers/podman-desktop/pull/3129))\\n- Do not remove registries when podman extension is stopping ([PR #3136](https://github.com/containers/podman-desktop/pull/3136))\\n- Warning should be amber ([PR #3153](https://github.com/containers/podman-desktop/pull/3153))\\n- Load user extensions from plugins as removable ([PR #3152](https://github.com/containers/podman-desktop/pull/3152))\\n- Images with spaces in entrypoints or commands fail to start ([PR #3161](https://github.com/containers/podman-desktop/pull/3161))\\n- Scrolling offscreen when clicking checkbox ([PR #3178](https://github.com/containers/podman-desktop/pull/3178))\\n- Avoid messagebox expanding offscreen ([PR #2778](https://github.com/containers/podman-desktop/pull/2778))\\n- Release-notes-generator run failure ([PR #2752](https://github.com/containers/podman-desktop/pull/2752))\\n- Unable to do a new build if the previous one failed ([PR #2721](https://github.com/containers/podman-desktop/pull/2721))\\n\\n---\\n\\n## Community Thank You\\n\\n\ud83c\udf89 We\u2019d like to say a big thank you to everyone who helped to make Podman Desktop even better.\\n\\nA big shoutout to [@afbjorklund](https://github.com/afbjorklund), [@tuckerrc](https://github.com/tuckerrc) and [@evanshortiss](https://github.com/evanshortiss) who contributed to this release!\\n\\n---\\n\\n## Final notes\\n\\nThe complete list of issues fixed in this release is available [here](https://github.com/containers/podman-desktop/issues?q=is%3Aclosed+milestone%3A1.2.0) and [here](https://github.com/containers/podman-desktop/issues?q=is%3Aclosed+milestone%3A1.2.0).\\n\\nGet the latest release from the [Downloads](/downloads) section of the website and boost your development journey with Podman Desktop. Additionally, visit the [GitHub repository](https://github.com/containers/podman-desktop) and see how you can help us make Podman Desktop better."},{"id":"podman-desktop-release-1.1","metadata":{"permalink":"/blog/podman-desktop-release-1.1","source":"@site/blog/2023-06-08-release-1.1.md","title":"Release Notes - Podman Desktop 1.1","description":"Podman Desktop 1.1 has been released!","date":"2023-06-08T00:00:00.000Z","formattedDate":"June 8, 2023","tags":[{"label":"podman-desktop","permalink":"/blog/tags/podman-desktop"},{"label":"release","permalink":"/blog/tags/release"},{"label":"kubernetes","permalink":"/blog/tags/kubernetes"},{"label":"openshift","permalink":"/blog/tags/openshift"}],"readingTime":2.465,"hasTruncateMarker":true,"authors":[{"name":"Tim deBoer","title":"Architect","url":"https://github.com/deboer-tim","imageURL":"https://github.com/deboer-tim.png","key":"deboer"}],"frontMatter":{"title":"Release Notes - Podman Desktop 1.1","description":"Podman Desktop 1.1 has been released!","slug":"podman-desktop-release-1.1","authors":["deboer"],"tags":["podman-desktop","release","kubernetes","openshift"],"hide_table_of_contents":false,"image":"/img/blog/podman-desktop-release-1.1.webp"},"prevItem":{"title":"Release Notes - Podman Desktop 1.2","permalink":"/blog/podman-desktop-release-1.2"},"nextItem":{"title":"Release Notes - Podman Desktop 1.0","permalink":"/blog/podman-desktop-release-1.0"}},"content":"import ReactPlayer from \'react-player\'\\n\\nPodman Desktop 1.1 Release! \ud83c\udf89\\n\\nThis is primarily a bug-fix release to fix a few important issues, but we\'ve managed to squeeze in a few enhancements\\nalong the way.\\n\\n\x3c!--Main Features--\x3e\\n\\n- **Podman 4.5.1**: Podman 4.5.1 now included in Windows and Mac installers.\\n- **Extensions**: Update extensions from within Podman Desktop.\\n- **Lima Support**: Choose engine type and override its name from the settings.\\n- **UX and UI Improvements**: New loading screen.\\n\\nPodman Desktop 1.1 is now available. [Click here to download it](/downloads)!\\n\\n![Podman-desktop-1-1-hero](img/podman-desktop-release-1.1/podman-desktop-release-1.1.png)\\n\\n\x3c!--truncate--\x3e\\n\\n---\\n\\n## Release Details\\n\\n### Podman v4.5.1\\n\\nPodman Desktop 1.1 moves up to [Podman 4.5.1](https://github.com/containers/podman/releases/tag/v4.5.1).\\n\\n### Extensions\\n\\nOptional extensions will follow their own lifecycle and update independently from Podman Desktop. As of\\nthis release you\'ll be able to see when there is an update available and install from within\\nPodman Desktop [#2655](https://github.com/containers/podman-desktop/pull/2655).\\n\\nWe\'ve also added options in **Settings > Preferences** to\\nautomatically check for and install extension updates.\\n\\n\\n\\n![Update extensions](img/podman-desktop-release-1.1/update-extensions.png)\\n\\n### Lima Support\\n\\nThanks to contributor [Anders Bj\xf6rklund](https://github.com/afbjorklund), we have some improvements to the\\nLima extension! In **Settings > Preferences** you can select which\\nengine type Lima runs on and override the instance name [#2674](https://github.com/containers/podman-desktop/pull/2674).\\n\\n![Lima preferences](https://user-images.githubusercontent.com/10364051/241755966-0a6a293b-b18e-4222-9c40-abd6c114d464.png)\\n\\n### Other UI and UX Improvements\\n\\n#### New Loading Screen\\n\\nWe have a new loading screen, Podman Desktop style! [#2743](https://github.com/containers/podman-desktop/pull/2743).\\n\\n\\n\\n---\\n\\n## Other Notable Enhancements\\n\\n- Docker-compose can be installed system-wide [#2718](https://github.com/containers/podman-desktop/pull/2718).\\n- Show warning when creating a pod with two containers that use the same port [#2671](https://github.com/containers/podman-desktop/pull/2671).\\n- Display Kubernetes context name in pod label [#2634](https://github.com/containers/podman-desktop/pull/2634).\\n- Add Docker compatibility button using flatpak-spawn [#1925](https://github.com/containers/podman-desktop/pull/1925).\\n- Improve UI consistency of Pull Image page [#2604](https://github.com/containers/podman-desktop/pull/2604).\\n\\n---\\n\\n## Notable Bug Fixes\\n\\n- Could not install extensions on Windows 10 [#2762](https://github.com/containers/podman-desktop/pull/2762).\\n- Could not use locally built images on Kubernetes [#2710](https://github.com/containers/podman-desktop/pull/2710).\\n- Dashboard still suggests update after installation [#2648](https://github.com/containers/podman-desktop/pull/2648).\\n- Could not Play Kubernetes YAML to Podman on Windows [#2594](https://github.com/containers/podman-desktop/pull/2594).\\n- Pod label wasn\'t always shown in list [#2614](https://github.com/containers/podman-desktop/pull/2614).\\n- Dashboard button state was resetting [#2584](https://github.com/containers/podman-desktop/pull/2584).\\n- Change checkbox style so they don\'t look like stop buttons [#2723](https://github.com/containers/podman-desktop/pull/2723).\\n\\n---\\n\\n## Community Thank You\\n\\n\ud83c\udf89 We\u2019d like to say a big thank you to everyone who helped to make Podman Desktop even better. In this\\nsprint we received pull requests from the following people:\\n\\n- [wangxiaolei](https://github.com/fatelei) in [#2602 - Add meaningful tooltips to build, pull, prune buttons](https://github.com/containers/podman-desktop/pull/2602)\\n- [AsciiWolf](https://github.com/AsciiWolf) in [#2607 - fix typing error in Flathub name](https://github.com/containers/podman-desktop/pull/2607) and [#2609 - fix Flatpak install instructions](https://github.com/containers/podman-desktop/pull/2609)\\n- [Anders Bj\xf6rklund](https://github.com/afbjorklund) in [#2674 - Select engine for Lima provider](https://github.com/containers/podman-desktop/pull/2674)\\n\\n---\\n\\n## Final notes\\n\\nThe complete list of issues fixed in this release is available [here](https://github.com/containers/podman-desktop/issues?q=is%3Aclosed+milestone%3A1.1.0) and [here](https://github.com/containers/podman-desktop/issues?q=is%3Aclosed+milestone%3A1.1.0).\\n\\nGet the latest release from the [Downloads](/downloads) section of the website and boost your development journey with Podman Desktop. Additionally, visit the [GitHub repository](https://github.com/containers/podman-desktop) and see how you can help us make Podman Desktop better."},{"id":"podman-desktop-release-1.0","metadata":{"permalink":"/blog/podman-desktop-release-1.0","source":"@site/blog/2023-05-17-release-1.0.md","title":"Release Notes - Podman Desktop 1.0","description":"Podman Desktop 1.0 has been released!","date":"2023-05-17T00:00:00.000Z","formattedDate":"May 17, 2023","tags":[{"label":"podman-desktop","permalink":"/blog/tags/podman-desktop"},{"label":"release","permalink":"/blog/tags/release"},{"label":"kubernetes","permalink":"/blog/tags/kubernetes"},{"label":"kind","permalink":"/blog/tags/kind"},{"label":"openshift","permalink":"/blog/tags/openshift"}],"readingTime":5,"hasTruncateMarker":true,"authors":[{"name":"Tim deBoer","title":"Architect","url":"https://github.com/deboer-tim","imageURL":"https://github.com/deboer-tim.png","key":"deboer"}],"frontMatter":{"title":"Release Notes - Podman Desktop 1.0","description":"Podman Desktop 1.0 has been released!","slug":"podman-desktop-release-1.0","authors":["deboer"],"tags":["podman-desktop","release","kubernetes","kind","openshift"],"hide_table_of_contents":false,"image":"/img/blog/podman-desktop-release-1.0.jpg"},"prevItem":{"title":"Release Notes - Podman Desktop 1.1","permalink":"/blog/podman-desktop-release-1.1"},"nextItem":{"title":"Release Notes - Podman Desktop 0.15","permalink":"/blog/podman-desktop-release-0.15"}},"content":"import ReactPlayer from \'react-player\'\\n\\nPodman Desktop 1.0 Release! \ud83c\udf89\\n\\nWe still have many things planned, but with a little polish and a few more bug fixes we\\nfelt we\'ve reached a level of maturity and it is now time to declare our 1.0 release.\\n\\nThank you to everyone who has been with us on this journey so far! Please keep the\\nfeedback coming!\\n\\n\x3c!--Main Features--\x3e\\n\\n- **Highlighting Featured Extensions**: Easily find and install new extensions.\\n- **Featured Extensions**: Two new extensions supporting OpenShift.\\n- **Podman Machine as Root**: Ability to run a Podman machine as root.\\n- **UX and UI Improvements**: Opening external websites, editing numbers, and tooltips.\\n\\nPodman Desktop 1.0 is now available. [Click here to download it](/downloads)!\\n\\n![Podman-desktop-1-0-hero](img/podman-desktop-release-1.0/podman-desktop-release-1.0.jpg)\\n\\n\x3c!--truncate--\x3e\\n\\n---\\n\\n## Release Details\\n\\n### Highlighting Featured Extensions\\n\\nA critical part of our vision for Podman Deskop is the ability to install extensions to\\nsupport additional container engines, Kubernetes providers, or other tools. However, it\\nhas not been easy to discover new extensions.\\n\\nWith 1.0 we show a list of featured extensions in the **Welcome**\\n[#2354](https://github.com/containers/podman-desktop/pull/2354), the **Dashboard** and in\\n** Settings > Extensions**\\n[#2355](https://github.com/containers/podman-desktop/pull/2355). Check out the new\\nextensions for **Red Hat OpenShift Local** and the **Developer Sandbox for Red Hat OpenShift**!\\n\\n![Featured extensions](img/podman-desktop-release-1.0/featured-extensions.png)\\n\\n### Featured Extensions\\n\\nSpeaking of extensions, let\'s take a minute to turn the spotlight on these two!\\n\\nHave another idea for extending Podman Desktop? We would love to hear from you or see\\nwhat you can create with the [Extension documentation](../docs/extensions),\\nand feature your extension here.\\n\\n#### Red Hat OpenShift Local\\n\\nOpenShift Local is a fully-featured single-node OpenShift cluster designed to run on your local computer.\\nWith this extension you can install, start/stop, and deploy pods or YAML to OpenShift Local,\\nallowing you to test your applications on a full OpenShift environment, ensuring a consistent\\nexperience between development, test, and production.\\n\\nThe recent addition of the MicroShift preset provides a lighter, optimized option that\\nstarts faster and uses less resources for deployments that still want OpenShift compatibility\\nwithout the full set of OpenShift services.\\n\\n![OpenShift Local](img/podman-desktop-release-1.0/openshift-local.png)\\n\\n#### Developer Sandbox for Red Hat OpenShift\\n\\nThe OpenShift Developer Sandbox is a free, cloud-based OpenShift environment that allows developers to\\ncreate, build, and deploy applications to OpenShift for 30 days. With this extension you can sign up\\nand easily deploy pods or YAML to a hosted OpenShift environment without a local installation or\\nleaving Podman Desktop.\\n\\n![Developer Sandbox](img/podman-desktop-release-1.0/sandbox.png)\\n\\n### Podman Machine as Root\\n\\nWhen creating a Podman machine you can now decide to run as root [#2427](https://github.com/containers/podman-desktop/pull/2427). This is a prerequisite for some scenarios, such as running Kind on Windows.\\n\\n![Podman machine as root](img/podman-desktop-release-1.0/podman-root.png)\\n\\n### Other UI and UX Improvements\\n\\n#### Prompt to Open External Website\\n\\nIn the previous release links to external websites were blocked due to the security risk.\\nIn 1.0 you can click to see the URL and have the option of opening or copying it\\n[#2414](https://github.com/containers/podman-desktop/pull/2414).\\n\\n![External link dialog](img/podman-desktop-release-1.0/external-link.png)\\n\\n#### Editable Numeric Preferences\\n\\nTired of clicking +, +, +? Us too. Numeric preferences are now editable so\\nyou can directly enter the value you want\\n[#2368](https://github.com/containers/podman-desktop/pull/2368).\\n\\n![Editing numbers](img/podman-desktop-release-1.0/edit-number.png)\\n\\n#### Navigation tooltips\\n\\nWe like our new navigation bar, but the tooltips were slow to appear. This made it harder for new\\nusers to discover the pages and for power users to see the container/pod/image counts. The\\ntooltips are now a little nicer and appear immediately\\n[#2286](https://github.com/containers/podman-desktop/pull/2286).\\n\\n![Navigation tooltips](img/podman-desktop-release-1.0/nav-tooltips.png)\\n\\n---\\n\\n## Other Notable Enhancements\\n\\n- If you use a non-default Podman machine you are now prompted to make it the default, so\\n that command line tools will use the same machine [#2205](https://github.com/containers/podman-desktop/pull/2205).\\n\\n- Extensions can now be installed without requiring a running local container engine\\n [#2273](https://github.com/containers/podman-desktop/pull/2273).\\n\\n- When extensions fail to load there is a new state (failed!) and an error message\\n to help you fix or report the problem [#2424](https://github.com/containers/podman-desktop/pull/2424).\\n\\n- The showInputBox API has support for Markdown [#2418](https://github.com/containers/podman-desktop/pull/2418).\\n\\n---\\n\\n## Notable Bug Fixes\\n\\n- Fixed shared status when using multiple Podman 4.5 machines [#2441](https://github.com/containers/podman-desktop/pull/2441).\\n- Fixed hang on exit when telemetry is unreachable [#2431](https://github.com/containers/podman-desktop/pull/2431).\\n- Reduced initial Podman REST API calls to improve performance [#2419](https://github.com/containers/podman-desktop/pull/2419).\\n- **Play Kubernetes YAML** now honors the namespace [#2509](https://github.com/containers/podman-desktop/pull/2509).\\n- **Container** list was not remembering expand/collapsed status [#2491](https://github.com/containers/podman-desktop/pull/2491).\\n- Clear previous error when installing Docker extension [#2469](https://github.com/containers/podman-desktop/pull/2469).\\n- Ensure correct path with running Kind CLI [#2455](https://github.com/containers/podman-desktop/pull/2455).\\n- Use IPv4 over IPv6 by default [#2398](https://github.com/containers/podman-desktop/pull/2398).\\n- When changing the Kubernetes pod name, change the app name to match [#2389](https://github.com/containers/podman-desktop/pull/2389).\\n- Fixed incorrect pod status in **Containers** view [#2387](https://github.com/containers/podman-desktop/pull/2387).\\n- **Dashboard** wasn\'t correctly refreshing Podman status [#2359](https://github.com/containers/podman-desktop/pull/2359).\\n\\n---\\n\\n## Community Thank You\\n\\n\ud83c\udf89 We\u2019d like to say a big thank you to everyone who helped to make Podman Desktop even better. In this final\\nsprint we received pull requests from the following people:\\n\\n- [Taha Attari](https://github.com/TahaAttari) in [#2470 - Update docker command in importing-saved-containers.md](https://github.com/containers/podman-desktop/pull/2470)\\n- [Jason Greene](https://github.com/n1hility) in [#2431 - Fix hang on exit when telemetry endpoint is unreachable](https://github.com/containers/podman-desktop/pull/2431)\\n- [Anders Bj\xf6rklund](https://github.com/afbjorklund) in [#2571 - Fix the location of the lima podman socket](https://github.com/containers/podman-desktop/pull/2571) and [#2572 - Fix the state of the lima container provider](https://github.com/containers/podman-desktop/pull/2572)\\n- [Tucker Chapman](https://github.com/tuckerrc) in [#2567 - Add example image name in placeholder](https://github.com/containers/podman-desktop/pull/2567)\\n\\nThere are now a total of 54 people (and two bots!) who have contributed PRs to Podman Desktop, and we\'d\\nlike to extend an extra thanks to all of those outside of the immediate development team who contributed\\nto get us here:\\n\\n[afbjorklund](https://github.com/afbjorklund),\\n[alv67](https://github.com/alv67),\\n[anjannath](https://github.com/anjannath),\\n[ankanroy-code](https://github.com/ankanroy-code),\\n[arixmkii](https://github.com/arixmkii),\\n[cblecker](https://github.com/cblecker),\\n[cfergeau](https://github.com/cfergeau),\\n[chevdor](https://github.com/chevdor),\\n[chrisjsimpson](https://github.com/chrisjsimpson),\\n[cu8code](https://github.com/cu8code),\\n[doehyunbaek](https://github.com/doehyunbaek),\\n[dylanmtaylor](https://github.com/dylanmtaylor),\\n[eidottermihi](https://github.com/eidottermihi),\\n[elervik](https://github.com/elervik),\\n[emmanuelbernard](https://github.com/emmanuelbernard),\\n[evanfpearson](https://github.com/evanfpearson),\\n[gorkem](https://github.com/gorkem),\\n[idjohnson](https://github.com/idjohnson),\\n[imphil](https://github.com/imphil),\\n[iongion](https://github.com/iongion),\\n[jlosito](https://github.com/jlosito),\\n[KevinAtSesam](https://github.com/KevinAtSesam),\\n[lsm5](https://github.com/lsm5),\\n[Mitch9378](https://github.com/Mitch9378),\\n[n1hility](https://github.com/n1hility),\\n[osslate](https://github.com/osslate),\\n[PatentLobster](https://github.com/PatentLobster),\\n[pwright](https://github.com/pwright),\\n[rdwz](https://github.com/rdwz),\\n[redhatrises](https://github.com/redhatrises),\\n[rhatdan](https://github.com/rhatdan),\\n[RobotSail](https://github.com/RobotSail),\\n[rohit-rambade](https://github.com/rohit-rambade),\\n[rsvoboda](https://github.com/rsvoboda),\\n[sfrunza13](https://github.com/sfrunza13),\\n[shemanaev](https://github.com/shemanaev),\\n[sstosh](https://github.com/sstosh),\\n[stickster](https://github.com/stickster),\\n[TahaAttari](https://github.com/TahaAttari),\\n[ths83](https://github.com/ths83),\\n[Tony-Sol](https://github.com/Tony-Sol),\\n[tuckerrc](https://github.com/tuckerrc),\\n[ucomesdag](https://github.com/ucomesdag),\\n[xbabalov](https://github.com/xbabalov),\\n[zezo2019](https://github.com/zezo2019).\\n\\n---\\n\\n## Final notes\\n\\nThe complete list of issues fixed in this release is available [here](https://github.com/containers/podman-desktop/issues?q=is%3Aclosed+milestone%3A1.0.0) and [here](https://github.com/containers/podman-desktop/issues?q=is%3Aclosed+milestone%3A1.0.1).\\n\\nGet the latest release from the [Downloads](/downloads) section of the website and boost your development journey with Podman Desktop. Additionally, visit the [GitHub repository](https://github.com/containers/podman-desktop) and see how you can help us make Podman Desktop better."},{"id":"podman-desktop-release-0.15","metadata":{"permalink":"/blog/podman-desktop-release-0.15","source":"@site/blog/2023-05-02-release-0.15.md","title":"Release Notes - Podman Desktop 0.15","description":"Podman Desktop 0.15 has been released!","date":"2023-05-02T00:00:00.000Z","formattedDate":"May 2, 2023","tags":[{"label":"podman-desktop","permalink":"/blog/tags/podman-desktop"},{"label":"release","permalink":"/blog/tags/release"},{"label":"kubernetes","permalink":"/blog/tags/kubernetes"},{"label":"kind","permalink":"/blog/tags/kind"}],"readingTime":3.685,"hasTruncateMarker":true,"authors":[{"name":"Tim deBoer","title":"Architect","url":"https://github.com/deboer-tim","imageURL":"https://github.com/deboer-tim.png","key":"deboer"}],"frontMatter":{"title":"Release Notes - Podman Desktop 0.15","description":"Podman Desktop 0.15 has been released!","slug":"podman-desktop-release-0.15","authors":["deboer"],"tags":["podman-desktop","release","kubernetes","kind"],"hide_table_of_contents":false,"image":"/img/blog/podman-desktop-release-0.15.webp"},"prevItem":{"title":"Release Notes - Podman Desktop 1.0","permalink":"/blog/podman-desktop-release-1.0"},"nextItem":{"title":"Setting up and running a Kubernetes cluster locally with Podman Desktop","permalink":"/blog/running-a-local-kubernetes-cluster-with-podman-desktop"}},"content":"import ReactPlayer from \'react-player\'\\n\\nPodman Desktop 0.15 - Cleanliness is next to Podliness!\\n\\nIt has only been two weeks since our last release, but we really wanted to complete a few scenarios,\\nfix a few bugs, and show off several design updates and UI improvements that we have been working on.\\n\\n\x3c!--Main Features--\x3e\\n\\n- **Podman Version**: Podman 4.5 now included in Windows and Mac installers.\\n- **Kind Ingress**: Creating an ingress to expose services outside the Kind cluster.\\n- **Podliness**: Ability to choose external ports when podifying containers.\\n- **Cleanliness**: New navigation bar, dialog, and palette update.\\n- **UX and UI Improvements**: Markdown support for extensions.\\n\\nPodman Desktop 0.15 is now available. [Click here to download it](/downloads)!\\n\\n![Podman-desktop-0-15-hero](img/podman-desktop-release-0.15/podman-desktop-release-0.15.webp)\\n\\n\x3c!--truncate--\x3e\\n\\n---\\n\\n## Release Details\\n\\n### Update to Podman v4.5\\n\\nPodman Desktop 0.15 embeds [Podman 4.5](https://github.com/containers/podman/releases/tag/v4.5) in\\nWindows and macOS installers [#2115](https://github.com/containers/podman-desktop/issues/2115).\\n\\n### Kind Ingress\\n\\nWait a minute, didn\'t we enable this last release? Well yes, last time we did add support for installing\\nthe Contour ingress controller on Kind [#1675](https://github.com/containers/podman-desktop/issues/1675),\\nbut you still couldn\'t access your containers without the corresponding ingress.\\n\\nThis release adds a simple checkbox you can use when deploying to Kind to create an ingress and\\nmake your service accessible [#1322](https://github.com/containers/podman-desktop/issues/1322).\\n\\n\\n\\n### Podliness: Ability to Choose External Ports when Podifying Containers\\n\\nWhen you create a pod from of a set of containers (Podifying!), you probably don\'t want to expose every\\nsingle port from every container to the world. With an updated panel you can now see which ports each container\\nexposes, pick which should remain visible outside the pod, and which are for internal use\\n[#2232](https://github.com/containers/podman-desktop/pull/2232).\\n\\n![Podify page](https://user-images.githubusercontent.com/49404737/234527674-ed14f52c-8f66-445f-8038-c8135bb61136.gif)\\n\\n### Cleanliness: New Navigation Bar, Dialogs, and Palette\\n\\nIt was time to catch up on some design ideas and do some UI cleanup!\\n\\n#### New Navgation Bar\\n\\nThe navigation bar is now always fixed on the left size, without labels. This opens up more space\\nfor the content on each page, and is easier to jump in and out of ** Settings**.\\n[#2167](https://github.com/containers/podman-desktop/issues/2167)\\n\\n![Navigation bar](img/podman-desktop-release-0.15/navigation.png)\\n\\n#### Updated Dialogs\\n\\nWe wanted messages and dialog boxes to feel a bit more integrated, so we have a new message box\\n[#1808](https://github.com/containers/podman-desktop/pull/1808) and use it for all dialogs opened by\\nextensions, pruning containers/pods/images/volumes [#2138](https://github.com/containers/podman-desktop/pull/2138),\\nand updating Podman Desktop itself [#2249](https://github.com/containers/podman-desktop/pull/2249).\\n\\n![Dialog](img/podman-desktop-release-0.15/dialog.png)\\n\\n#### Colors\\n\\nWe spent some time tweaking colors and closing on our final palette\\n[#2199](https://github.com/containers/podman-desktop/pull/2199), updating the colors in the terminal & detail page\\n[#2222](https://github.com/containers/podman-desktop/pull/2222), tweaking the navigation and main page colors\\n[#2223](https://github.com/containers/podman-desktop/pull/2223),\\nand improving the look of forms [#2156](https://github.com/containers/podman-desktop/issues/2156).\\n\\nWe\'re not done yet, but hopefully you will notice a more polished, consistent, good-looking application!\\n\\n### Other UI and UX Improvements\\n\\n#### Markdown Support for Extensions\\n\\nWe added a new component to display markdown [#2219](https://github.com/containers/podman-desktop/pull/2219) and\\nenabled it in preferences [#2253](https://github.com/containers/podman-desktop/pull/2253), and\\nprovider properties/creation pages [#2152](https://github.com/containers/podman-desktop/issues/2152).\\nWe can now embed links and other formatting in preferences, and extensions can use them in many places, for example:\\n\\n![Markdown](img/podman-desktop-release-0.15/markdown.png)\\n\\n---\\n\\n## Other Notable Enhancements\\n\\n- We know which **Settings** page is used the most often, so now it\'s the default: ** Settings > Resources** [#2105](https://github.com/containers/podman-desktop/issues/2105).\\n\\n- Extensions can now use the Tasks API to let long running tasks continue in the background [#2019](https://github.com/containers/podman-desktop/issues/2019) and the existing withProgress API also uses the task manager now\\n [#2187](https://github.com/containers/podman-desktop/pull/2187).\\n\\n![Task API](https://user-images.githubusercontent.com/695993/233560830-85cfa685-5dcd-4efa-9fae-730a8a9eef3b.gif)\\n\\n- Images are now sorted by age [#2311](https://github.com/containers/podman-desktop/pull/2311).\\n\\n- When you start/stop a container or pod, the button is now animated instead of having an separate spinner\\n [#2101](https://github.com/containers/podman-desktop/issues/2101).\\n\\n- The ** Settings > Preferences** page now has a search bar [#2128](https://github.com/containers/podman-desktop/pull/2128).\\n\\n![Search preferences](img/podman-desktop-release-0.15/prefs.png)\\n\\n- The Help page has been updated [#431](https://github.com/containers/podman-desktop/issues/431).\\n\\n![Updated Help](img/podman-desktop-release-0.15/help.png)\\n\\n---\\n\\n## Notable Bug Fixes\\n\\n- There was no way to see log or outcome if you leave the Kind cluster creation page [#2079](https://github.com/containers/podman-desktop/issues/2079).\\n- Kind image load doesn\'t show a notification [#2225](https://github.com/containers/podman-desktop/issues/2225).\\n- Fix odd selection in ** Settings > Extensions** [#2130](https://github.com/containers/podman-desktop/issues/2130).\\n- Menus are now cleaned up properly when extensions are stopped [#2188](https://github.com/containers/podman-desktop/pull/2188).\\n- Kind clusters are now cleaned up when Podman machine is stopped [#2306](https://github.com/containers/podman-desktop/pull/2306).\\n\\n---\\n\\n## Final notes\\n\\nThe complete list of issues fixed in this release is available [here](https://github.com/containers/podman-desktop/issues?q=is%3Aclosed+milestone%3A0.15.0).\\n\\nGet the latest release from the [Downloads](/downloads) section of the website and boost your development journey with Podman Desktop. Additionally, visit the [GitHub repository](https://github.com/containers/podman-desktop) and see how you can help us make Podman Desktop better."},{"id":"running-a-local-kubernetes-cluster-with-podman-desktop","metadata":{"permalink":"/blog/running-a-local-kubernetes-cluster-with-podman-desktop","source":"@site/blog/2023-04-19-running-a-local-kubernetes-cluster-with-podman-desktop.md","title":"Setting up and running a Kubernetes cluster locally with Podman Desktop","description":"Setting up and running a Kubernetes cluster locally with Podman Desktop","date":"2023-04-19T00:00:00.000Z","formattedDate":"April 19, 2023","tags":[{"label":"podman-desktop","permalink":"/blog/tags/podman-desktop"},{"label":"story","permalink":"/blog/tags/story"},{"label":"kubernetes","permalink":"/blog/tags/kubernetes"},{"label":"kind","permalink":"/blog/tags/kind"}],"readingTime":8.86,"hasTruncateMarker":true,"authors":[{"name":"Fabrice Flore-Thebault","title":"Technical writer","url":"https://github.com/themr0c","imageURL":"https://github.com/themr0c.png","key":"themr0c"}],"frontMatter":{"title":"Setting up and running a Kubernetes cluster locally with Podman Desktop","description":"Setting up and running a Kubernetes cluster locally with Podman Desktop","slug":"running-a-local-kubernetes-cluster-with-podman-desktop","authors":["themr0c"],"tags":["podman-desktop","story","kubernetes","kind"],"hide_table_of_contents":false},"prevItem":{"title":"Release Notes - Podman Desktop 0.15","permalink":"/blog/podman-desktop-release-0.15"},"nextItem":{"title":"Release Notes - Podman Desktop 0.14","permalink":"/blog/podman-desktop-release-0.14"}},"content":"In this blog post you will learn to use Podman Desktop to run the [Kubernetes documentation example: Deploying PHP Guestbook application with Redis](https://kubernetes.io/docs/tutorials/stateless-application/guestbook/).\\n\\nOn the agenda:\\n\\n1. Installing Podman Desktop.\\n1. Installing and initializing your container engine: Podman.\\n1. Installing and starting your local Kubernetes provider: Kind.\\n1. Starting the Redis leader.\\n1. Starting and scaling the Redis followers.\\n1. Starting and exposing the Guestbook frontend.\\n\\n\x3c!--truncate--\x3e\\n\\n## Installing Podman Desktop\\n\\nYou need Podman Desktop.\\n\\n1. Go to [Podman Desktop installation documentation](/docs/Installation).\\n1. Click on your platform name: [Windows](/docs/installation/windows-install), [macOS](/docs/installation/macos-install), or [Linux](/docs/installation/linux-install).\\n1. Follow the instructions. Stick to the default installation method.\\n1. Start **Podman Desktop**.\\n\\nAt this point, you have a graphical user interface to:\\n\\n- Install Podman and Kind.\\n- Control and work with your container engines and Kubernetes clusters.\\n- Run your application on your container engine and migrate it to Kubernetes.\\n\\n## Installing and initializing your container engine: Podman\\n\\nPodman Desktop can control various container engines, such as:\\n\\n- Docker\\n- Lima\\n- Podman\\n\\nConsider installing the Podman container engine for:\\n\\n- Added security\\n- No daemon\\n- Open source\\n\\nContainers are a Linux technology.\\n\\n- On Linux, you can install Podman natively.\\n See: [Installing Podman on Linux](https://podman.io/getting-started/installation#installing-on-linux).\\n- On macOS and Windows, Podman requires to run in a Linux virtual machine: the Podman machine.\\n Use Podman Desktop to install Podman and initialize your Podman machine:\\n\\n#### Procedure\\n\\n1. Open Podman Desktop **Dashboard**\\n1. The **Dashboard** displays _Podman Desktop was not able to find an installation of Podman_.\\n1. Click on **Install**.\\n1. Podman Desktop checks the prerequisites to install Podman Engine. When necessary, follow the instructions to install prerequisites.\\n1. Podman displays the dialog: _Podman is not installed on this system, would you like to install Podman?_. Click on **Yes** to install Podman.\\n1. Click on **Initialize and start**.\\n\\n#### Verification\\n\\n- The **Dashboard** displays _Podman is running_.\\n\\n ![Podman is running](img/running-a-local-kubernetes-cluster-with-podman-desktop/podman-is-running.png)\\n\\nAt this point, you can start working with containers.\\n\\n## Installing and starting your local Kubernetes provider: Kind\\n\\nYou want to deploy your application to a local Kubernetes cluster.\\n\\nPodman Desktop can help you run Kind-powered local Kubernetes clusters on a container engine, such as Podman.\\n\\nPodman Desktop helps you [installing the `kind` CLI](/docs/kubernetes/kind/installing-kind):\\n\\n1. In the status bar, click on **Kind**, and follow the prompts.\\n1. When the `kind` CLI is available, the status bar does not display **Kind**.\\n1. On Windows, [configure Podman in rootful mode](docs/kubernetes/kind/configuring-podman-for-kind-on-windows)\\n\\n ```shell-session\\n $ podman system connection default podman-machine-default-root\\n ```\\n\\n1. Go to ** Settings > Resources**\\n1. In the **\\"Podman Podman** tile, click on the **** icon to restart the Podman container engine.\\n1. In the **\\"Kind Kind** tile, click on the **Create new** button.\\n 1. **Name**: enter `kind-cluster`.\\n 1. **Provider Type**: select `podman`.\\n 1. **HTTP Port**: select `9090`.\\n 1. **HTTPS Port**: select `9443`.\\n 1. **Setup an ingress controller**: `Enabled`\\n 1. Click the **Create** button.\\n ![Create a Kind cluster screen](img/running-a-local-kubernetes-cluster-with-podman-desktop/create-a-kind-cluster.png)\\n1. After successful creation, click on the **Go back to resources** button\\n\\n#### Verification\\n\\n1. In ** Settings > Resources** your Kind cluster is running/\\n\\n ![Kind cluster is running](img/running-a-local-kubernetes-cluster-with-podman-desktop/kind-cluster-is-running.png)\\n\\n1. In the **Podman Desktop** tray, open the **Kubernetes** menu: you can set the context to your Kind cluster: `kind-kind-cluster`.\\n\\n ![Kind cluster Kubernetes context in the tray](img/running-a-local-kubernetes-cluster-with-podman-desktop/kind-cluster-context-in-the-tray.png)\\n\\n At this point, you can start working with containers, and your local Kubernetes cluster.\\n\\n#### Additional resources\\n\\n- [Creating a local Kind-powered Kubernetes cluster](docs/kubernetes/kind/creating-a-kind-cluster)\\n\\n## Starting the Redis leader\\n\\nThe Guestbook application uses Redis to store its data.\\n\\nWith Podman Desktop, you can prepare the Redis leader image and container on your local container engine, and deploy the results to a Kubernetes pod and service.\\nThis is functionally equal to the `redis-leader` deployment that the Kubernetes example propose.\\n\\n#### Procedure\\n\\n1. Open ** Images > Pull an image**.\\n 1. **Image to Pull**: enter `docker.io/redis:6.0.5`\\n 1. Click **Pull image** to pull the image to your container engine local image registry.\\n 1. Click **Done** to get back to the images list.\\n1. ** Search images**: enter `redis:6.0.5` to find the image.\\n1. Click **** to open the **Create a container from image** dialog.\\n 1. **Container name**: enter `leader`,\\n 1. **Local port for `6379/tcp`**: `6379`.\\n 1. Click ** Start Container** to start the container in your container engine.\\n1. ** Search containers**: enter `leader` to find the running container.\\n1. Click **** to stop the container, and leave the `6379` port available for the Redis follower container.\\n\\n1. Click ** > Deploy to Kubernetes** to open the **Deploy generated pod to Kubernetes** screen.\\n\\n 1. **Pod Name**: enter `redis-leader`.\\n 1. **Use Kubernetes Services**: select **Replace `hostPort` exposure on containers by Services. It is the recommended way to expose ports, as a cluster policy might prevent to use `hostPort`.**\\n 1. **Expose service locally using Kubernetes Ingress**: deselect **Create a Kubernetes ingress to get access to the ports that this pod exposes, at the default ingress controller location. Example: on a default Kind cluster created with Podman Desktop: `http://localhost:9090`. Requirements: your cluster has an ingress controller`**.\\n 1. **Kubernetes namespaces**: select `default`.\\n 1. Click ** Deploy**.\\n ![Deploy generated leader pod to Kubernetes screen](img/running-a-local-kubernetes-cluster-with-podman-desktop/deploy-generated-leader-pod-to-kubernetes.png)\\n 1. Wait for the pod to reach the state: **Phase: Running**.\\n 1. Click **Done**.\\n\\n#### Verification\\n\\n- The ** Pods** screen lists the running `redis-leader` pod.\\n\\n ![leader pod is running](img/running-a-local-kubernetes-cluster-with-podman-desktop/leader-pod-is-running.png)\\n\\n## Starting the Redis followers\\n\\nAlthough the Redis leader is a single Pod, you can make it highly available and meet traffic demands by adding a few Redis followers, or replicas.\\n\\n**With Podman Desktop, you can prepare the Redis follower image and container on your local container engine, and deploy the results to Kubernetes pods and services.**\\nThis is functionally equal to the `redis-follower` deployment that the Kubernetes example propose.\\n\\n#### Procedure\\n\\n1. Open ** Images > Pull an image**.\\n 1. **Image to Pull**: enter `gcr.io/google_samples/gb-redis-follower:v2`\\n 1. Click **Pull image** to pull the image to your container engine local image registry.\\n 1. Click **Done** to get back to the images list.\\n1. ** Search images**: enter `gb-redis-follower:v2` to find the image.\\n1. Click **** to open the **Create a container from image** dialog.\\n 1. **Container name**: enter `follower`,\\n 1. **Local port for `6379/tcp`**: `6379`.\\n 1. Click ** Start Container** to start the container in your container engine.\\n1. ** Search containers**: enter `follower` to find the running container.\\n1. Click **** to stop the container: you do not need it to run in the container engine.\\n1. Click ** > Deploy to Kubernetes** to open the **Deploy generated pod to Kubernetes** screen.\\n 1. **Pod Name**: enter `redis-follower`.\\n 1. **Use Kubernetes Services**: select **Replace `hostPort` exposure on containers by Services. It is the recommended way to expose ports, as a cluster policy might prevent to use `hostPort`.**\\n 1. **Expose service locally using Kubernetes Ingress**: deselect **Create a Kubernetes ingress to get access to the ports that this pod exposes, at the default ingress controller location. Example: on a default Kind cluster created with Podman Desktop: `http://localhost:9090`. Requirements: your cluster has an ingress controller`**.\\n 1. **Kubernetes namespaces**: select `default`.\\n 1. Click ** Deploy**.\\n ![Deploy generated follower pod to Kubernetes screen](img/running-a-local-kubernetes-cluster-with-podman-desktop/deploy-generated-follower-pod-to-kubernetes.png)\\n 1. Wait for the pod to reach the state: **Phase: Running**.\\n 1. Click **Done**.\\n1. To add replicas, repeat the last step with another **Pod Name** value.\\n\\n#### Verification\\n\\n- The ** Pods** screen lists the running `redis-follower` pods.\\n\\n ![follower pods are running](img/running-a-local-kubernetes-cluster-with-podman-desktop/follower-pods-are-running.png)\\n\\n## Starting the default frontend\\n\\nNow that you have the Redis storage of your Guestbook up and running, start the Guestbook web servers.\\nLike the Redis followers, deploy the frontend using Kubernetes pods and services.\\n\\nThe Guestbook app uses a PHP frontend.\\nIt is configured to communicate with either the Redis follower or leader Services, depending on whether the request is a read or a write.\\nThe frontend exposes a JSON interface, and serves a jQuery-Ajax-based UX.\\n\\nWith Podman Desktop, you can prepare the Guestbook frontend image and container on your local container engine, and deploy the results to Kubernetes pods and services.\\nThis is functionally equal to the `frontend` deployment that the Kubernetes example propose.\\n\\n#### Procedure\\n\\n1. Open ** Images > Pull an image**.\\n 1. **Image to Pull**: enter `gcr.io/google_samples/gb-frontend:v5`\\n 1. Click **Pull image** to pull the image to your container engine local image registry.\\n 1. Wait for the pull to complete.\\n 1. Click **Done** to get back to the images list.\\n1. ** Search images**: enter `gb-frontend:v5` to find the image.\\n1. Click **** to open the **Create a container from image** dialog.\\n 1. **Container name**: enter `frontend`,\\n 1. **Local port for `80/tcp`**: `9000`.\\n 1. Click ** Start Container** to start the container in your container engine.\\n1. ** Search containers**: enter `frontend` to find the running container.\\n1. Click **** to stop the container: you do not need it to run in the container engine.\\n1. Click ** > Deploy to Kubernetes** to open the **Deploy generated pod to Kubernetes** screen.\\n 1. **Pod Name**: enter `frontend`.\\n 1. **Use Kubernetes Services**: select **Replace `hostPort` exposure on containers by Services. It is the recommended way to expose ports, as a cluster policy might prevent to use `hostPort`.**\\n 1. **Expose service locally using Kubernetes Ingress**: select **Create a Kubernetes ingress to get access to the ports that this pod exposes, at the default ingress controller location. Example: on a default Kind cluster created with Podman Desktop: `http://localhost:9090`. Requirements: your cluster has an ingress controller`**.\\n 1. **Kubernetes namespaces**: select `default`.\\n 1. Click ** Deploy**.\\n ![Deploy generated frontend pod to Kubernetes screen](img/running-a-local-kubernetes-cluster-with-podman-desktop/deploy-generated-frontend-pod-to-kubernetes.png)\\n 1. Wait for the pod to reach the state: **Phase: Running**.\\n 1. Click **Done**.\\n\\n#### Verification\\n\\n1. The ** Pods** screen lists the running `frontend` pod.\\n\\n ![`frontend` pod is running](img/running-a-local-kubernetes-cluster-with-podman-desktop/frontend-pod-is-running.png)\\n\\n1. Go to `http://localhost:9090`: the Guestbook application is running."},{"id":"podman-desktop-release-0.14","metadata":{"permalink":"/blog/podman-desktop-release-0.14","source":"@site/blog/2023-04-14-release-0.14.md","title":"Release Notes - Podman Desktop 0.14","description":"Podman Desktop 0.14 has been released!","date":"2023-04-14T00:00:00.000Z","formattedDate":"April 14, 2023","tags":[{"label":"podman-desktop","permalink":"/blog/tags/podman-desktop"},{"label":"release","permalink":"/blog/tags/release"},{"label":"kubernetes","permalink":"/blog/tags/kubernetes"},{"label":"kind","permalink":"/blog/tags/kind"}],"readingTime":4.025,"hasTruncateMarker":true,"authors":[{"name":"Tim deBoer","title":"Architect","url":"https://github.com/deboer-tim","imageURL":"https://github.com/deboer-tim.png","key":"deboer"}],"frontMatter":{"title":"Release Notes - Podman Desktop 0.14","description":"Podman Desktop 0.14 has been released!","slug":"podman-desktop-release-0.14","authors":["deboer"],"tags":["podman-desktop","release","kubernetes","kind"],"hide_table_of_contents":false},"prevItem":{"title":"Setting up and running a Kubernetes cluster locally with Podman Desktop","permalink":"/blog/running-a-local-kubernetes-cluster-with-podman-desktop"},"nextItem":{"title":"Release Notes - Podman Desktop 0.13","permalink":"/blog/podman-desktop-release-0.13"}},"content":"import ReactPlayer from \'react-player\'\\n\\nPodman Desktop 0.14 - Our Kind-est release yet!\\n\\nWe have been working on a Kind extension for a while now, and decided it is time to promote it\\ninto a release just in time for KubeCon and CloudNativeCon Europe!\\n\\nWe\'re especially excited about releasing Kind because it finally shows the full purpose\\nof Podman Desktop: not just local container engines, but Kubernetes too. More importantly,\\nproviding tools that allow you to manage both environments and seamlessly move between them.\\n\\nSome of these features were available in development mode over the last few releases,\\nbut since they are now in the release build, we will do a full roundup and talk about\\nall the Kind features.\\n\\n\x3c!--Main Features--\x3e\\n\\n- **Kind Installation**: Install Kind from the status bar\\n- **Manage Kind Clusters**: Create and manage Kind clusters from ** Settings > Resources**\\n- **Using Kind**: Deploying YAML and sharing images to a cluster\\n- **Kind Ingress**: Install a Contour ingress controller\\n- **UX and UI Improvements**: Updated preferences and telemetry prompt\\n\\nPodman Desktop 0.14 is now available. [Click here to download it](/downloads)!\\n\\n![Podman-desktop-0-14-hero](img/podman-desktop-release-0.14/podman-desktop-release-0.14.png)\\n\\n\x3c!--truncate--\x3e\\n\\n---\\n\\n## Release details\\n\\n### Kind Installation\\n\\nGet Kind up and running in seconds! The Kind extension is now bundled as part of Podman Desktop\\n[1421](https://github.com/containers/podman-desktop/issues/1421)\\nand allows you to easily [install Kind directly from the status bar](/docs/kubernetes/kind/installing-kind)\\n[1257](https://github.com/containers/podman-desktop/issues/1257).\\n\\nThe installed `kind` CLI is available from the system shell [1516](https://github.com/containers/podman-desktop/issues/1516),\\nallowing you to open a terminal window to `kind get clusters` or work with other tools.\\n\\n### Manage Kind Clusters\\n\\nOnce Kind is installed (or if you already had it), you can manage your clusters in ** Settings > Resources**.\\nFrom here you can [create Kind clusters](/docs/kubernetes/kind/creating-a-kind-cluster),\\nstart/stop [1953](https://github.com/containers/podman-desktop/issues/1953)\\nor delete [1977](https://github.com/containers/podman-desktop/issues/1977) them.\\n\\n![kind-clusters](img/podman-desktop-release-0.14/kind-clusters.png)\\n\\nThe Kind control plane runs as a container. You will see this container\\nin the **Container** list and can also start or stop it from there.\\n\\n### Using Kind\\n\\nNow that you have Kind installed and running, what can you do with it?\\nIf you like terminals, you can always open one up and use the Kind CLI to\\n[interact with your cluster](https://kind.sigs.k8s.io/docs/user/quick-start/#interacting-with-your-cluster).\\n\\nWithin Podman Desktop we have started with two ways to interact with the cluster.\\nThe first is the ability to play local YAML files on your Kind (or any other Kubernetes!) cluster [1261](https://github.com/containers/podman-desktop/issues/1261). This allows you to take existing Kubernetes YAML definitons -\\nyour deployments, services, or other objects - and deploy it to the cluster.\\n\\n\\n\\nAs you deploy pods, they will automatically appear in the list of **Pods** [1263](https://github.com/containers/podman-desktop/issues/1263), allowing you to start, stop, and interact them just like pods running on Podman.\\n\\nOne of the most common uses is to deploy a container that you have been running on Podman, and this will fail\\nif the image is not available in Kind. To solve this we have made it easy to push images from\\nPodman to Kind [1448](https://github.com/containers/podman-desktop/issues/1448).\\n\\n![push-image-kind](img/podman-desktop-release-0.14/push-image-kind.png)\\n\\n### Kind Ingress\\n\\nIf you deploy a pod to Kind, you are also going to want to reach it! To do this you will need to install a load balancer or\\ningress controller so that the pod is accessible from outside the cluster. We made it easy to install the Contour ingress\\ncontroller while creating a Kind cluster [1675](https://github.com/containers/podman-desktop/issues/1675),\\nso if you created your cluster with Podman Desktop it is already there!\\n\\n![kind-ingress](img/podman-desktop-release-0.14/kind-ingress.png)\\n\\nWe have several other Kind and Kubernetes features planned to expand the supported scenarios, but hopefully this\\nmakes it easy to get started with Kind and shows where we\'re headed. As always, feedback is appreciated!\\n\\n### UI and UX improvements\\n\\n#### Updated Preferences\\n\\nThe ** Settings > Preferences** page has been updated with a new design [1913](https://github.com/containers/podman-desktop/pull/1913),\\nmaking it easier to see and change preferences. Changes are live, no more Update button.\\n\\n![preferences](https://user-images.githubusercontent.com/49404737/229498507-e754b55c-dcbd-486d-9ee3-a1fe3bed7271.gif)\\n\\n#### Telemetry Prompt\\n\\nThe prompt to enable or disable telemetry has been moved from its own dialog into the **Welcome** screen.\\n[1927](https://github.com/containers/podman-desktop/pull/1927)\\nThis is more usable, one less prompt, and solves a window-layering issue for some users!\\n\\n![telemetry prompt](https://user-images.githubusercontent.com/19958075/229577331-365a9a01-0426-4482-a95d-f5dfe39af90a.png)\\n\\n---\\n\\n## Other notable enhancements\\n\\n- Extension support for opening an external URL [2028](https://github.com/containers/podman-desktop/pull/2028) and\\n accessing the clipboard [2023](https://github.com/containers/podman-desktop/pull/2023)\\n\\n---\\n\\n## Documentation\\n\\nNaturally, we have a section in the documentation just for [Kind](https://podman-desktop.io/docs/kubernetes/kind).\\n\\n---\\n\\n## Notable bug fixes\\n\\n- Avoid a dialog box if unable to check for updates [2062](https://github.com/containers/podman-desktop/pull/2062)\\n- Unable to get to the Dashboard if Kind (or Kubernetes) cluster was not running [2052](https://github.com/containers/podman-desktop/issues/2052)\\n\\n---\\n\\n## Final notes\\n\\nThe complete list of issues fixed in this release is available [here](https://github.com/containers/podman-desktop/issues?q=is%3Aclosed+milestone%3A0.14.0).\\n\\nGet the latest release from the [Downloads](/downloads) section of the website and boost your development journey with Podman Desktop. Additionally, visit the [GitHub repository](https://github.com/containers/podman-desktop) and see how you can help us make Podman Desktop better."},{"id":"podman-desktop-release-0.13","metadata":{"permalink":"/blog/podman-desktop-release-0.13","source":"@site/blog/2023-03-29-release-0.13.md","title":"Release Notes - Podman Desktop 0.13","description":"Podman Desktop 0.13 has been released!","date":"2023-03-29T00:00:00.000Z","formattedDate":"March 29, 2023","tags":[{"label":"podman-desktop","permalink":"/blog/tags/podman-desktop"},{"label":"release","permalink":"/blog/tags/release"},{"label":"kubernetes","permalink":"/blog/tags/kubernetes"},{"label":"compose","permalink":"/blog/tags/compose"}],"readingTime":3.155,"hasTruncateMarker":true,"authors":[{"name":"Tim deBoer","title":"Architect","url":"https://github.com/deboer-tim","imageURL":"https://github.com/deboer-tim.png","key":"deboer"}],"frontMatter":{"title":"Release Notes - Podman Desktop 0.13","description":"Podman Desktop 0.13 has been released!","slug":"podman-desktop-release-0.13","authors":["deboer"],"tags":["podman-desktop","release","kubernetes","compose"],"hide_table_of_contents":false},"prevItem":{"title":"Release Notes - Podman Desktop 0.14","permalink":"/blog/podman-desktop-release-0.14"},"nextItem":{"title":"5 things to know about Podman Desktop for a Docker user","permalink":"/blog/5-things-to-know-for-a-docker-user"}},"content":"import ReactPlayer from \'react-player\'\\n\\nThis release note covers Podman Desktop 0.13 release changes.\\n\\n\x3c!--Main Features--\x3e\\n\\n- **Podman Version**: Podman 4.4.4 now included in Windows and Mac installers.\\n- **Compose**: Support for installing Docker Compose.\\n- **Extensions**: Improved extension support for Podman Desktop with additional capabilities.\\n- **UX and UI Improvements**: Welcome page, task manager, resources, and update alerts.\\n\\nPodman Desktop 0.13 is now available. [Click here to download it](/downloads)!\\n\\n![Podman-desktop-0-13-hero](img/podman-desktop-release-0.13/podman-desktop-release-0.13.png)\\n\\n\x3c!--truncate--\x3e\\n\\n---\\n\\n## Release details\\n\\n### Update to Podman v4.4.4\\n\\nPodman Desktop 0.13 embeds [Podman 4.4.4](https://github.com/containers/podman/releases/tag/v4.4.4) in\\nWindows and macOS installers [#1456](https://github.com/containers/podman-desktop/pull/1456).\\n\\n### Compose support\\n\\nYou can install Docker Compose from the Podman Desktop UI [#1578](https://github.com/containers/podman-desktop/pull/1578). This will allow you use Compose workflows using Podman.\\n\\n### Extensions\\n\\nTo make it easier to extend Podman Desktop we have:\\n\\n- Published the [Podman Desktop Extension API](https://www.npmjs.com/package/@podman-desktop/api) to npmjs [#1727](https://github.com/containers/podman-desktop/pull/1727)\\n- Documented [how to create, publish, and install your own extensions](https://podman-desktop.io/docs/extensions)\\n- Expanded the API for `QuickPickInput` [#1839](https://github.com/containers/podman-desktop/pull/1839)\\n\\n### UI and UX improvements\\n\\n#### Welcome page [#1726](https://github.com/containers/podman-desktop/pull/1726)\\n\\nThe first time every user starts Podman Desktop, they will see a welcome page:\\n\\n![welcome-page](https://user-images.githubusercontent.com/19958075/225682776-e016ba31-5bb9-41d5-87ed-f93caeb3fb84.png)\\n\\nNote that the Welcome page will only appear the first time you run Podman Desktop 0.13.0, and none of your settings or assets in Podman Desktop will be affected by it.\\nOver time, this page will be expanded to help with initial setup and configuration.\\n\\n#### New Task Manager [#1724](https://github.com/containers/podman-desktop/pull/1724)\\n\\nA new Task Manager has been added to the status bar to see the progress (or return to) long running tasks. To start with, building images [#1725](https://github.com/containers/podman-desktop/pull/1725) and Podman machine [#1742](https://github.com/containers/podman-desktop/pull/1742) are using the task manager.\\n\\n![task-manager](img/podman-desktop-release-0.13/task-manager.png)\\n\\n#### Updated Resources Settings [#1582](https://github.com/containers/podman-desktop/pull/1582)\\n\\nThe ** Settings > Resources** page has been updated with a new design, making it easier to see and control your providers from a single place.\\n\\n![resources](https://user-images.githubusercontent.com/49404737/221908815-595715fe-4c95-4087-89e0-45e5544ed5c9.gif)\\n\\nThe other settings pages have been updated for consistency with this new design.\\n\\n#### Update Alerts [#1827](https://github.com/containers/podman-desktop/pull/1827)\\n\\nA new alert button will appear in the status bar when future updates are available.\\n\\n\\n\\n#### Prune buttons [#1481](https://github.com/containers/podman-desktop/pull/1481), [#1482](https://github.com/containers/podman-desktop/pull/1482), [#1484](https://github.com/containers/podman-desktop/pull/1484)\\n\\nWe\'ve added buttons to prune unused volumes [#1481](https://github.com/containers/podman-desktop/pull/1481), images [#1482](https://github.com/containers/podman-desktop/pull/1482) and pods [#1484](https://github.com/containers/podman-desktop/pull/1484).\\n\\n![prune-image](img/podman-desktop-release-0.13/prune-image.png)\\n\\n---\\n\\n## Other notable enhancements\\n\\n- Kubernetes pods are now shown in the Pods view [#1312](https://github.com/containers/podman-desktop/pull/1312)\\n- Easy button to fix Docker compatibility mode on macOS [#1697](https://github.com/containers/podman-desktop/pull/1697)\\n- Display extension icons [#1058](https://github.com/containers/podman-desktop/pull/1058)\\n- API to cancel long running tasks [#1777](https://github.com/containers/podman-desktop/pull/1777)\\n\\n---\\n\\n## Documentation\\n\\nThe documentation has new content:\\n\\n- [How to create, publish, and install your own Podman Desktop extensions](https://podman-desktop.io/docs/extensions)\\n- [Using Compose](https://podman-desktop.io/docs/compose/podman-compose)\\n- [Restarting Kind](https://podman-desktop.io/docs/kubernetes/kind)\\n\\n---\\n\\n## Notable bug fixes\\n\\n- Periodically check and refresh Podman connection on Windows and Mac [#1662](https://github.com/containers/podman-desktop/pull/1662)\\n- Fix inconsistent Log view behaviour [#1710](https://github.com/containers/podman-desktop/pull/1710)\\n- Don\'t create route for regular Kubernetes clusters [#1707](https://github.com/containers/podman-desktop/pull/1707)\\n- Fix copy button on empty screen [#1804](https://github.com/containers/podman-desktop/pull/1804)\\n- Register extension tray items correctly [#1778](https://github.com/containers/podman-desktop/pull/1778) and handle updates [#1800](https://github.com/containers/podman-desktop/pull/1800)\\n\\n---\\n\\n## Community thank you\\n\\n\ud83c\udf89 We\u2019d like to say a big thank you to everyone who helped to make Podman Desktop 0.13 even better:\\n\\n- [`Tony Soloveyv`](https://github.com/Tony-Sol) in [#1605 - Fix directories inconsistency in `~/.local/share/`](https://github.com/containers/podman-desktop/pull/1605)\\n- [`Oleg`](https://github.com/RobotSail) in [#1567 - Check for Flatpak when calling command from exec](https://github.com/containers/podman-desktop/pull/1567)\\n- [`Christoph Blecker`](https://github.com/cblecker) in [#1556 - Fix: Hide dock icon on macOS if starting minimized](https://github.com/containers/podman-desktop/pull/1556)\\n- [`Paul Wright`](https://github.com/pwright) in [#1604 - Docs: correct syntax of kind doc](https://github.com/containers/podman-desktop/pull/1604)\\n- [`Denis Golovin`](https://github.com/dgolovin) in [#1790 - Feat: add EventEmitter class to extension API](https://github.com/containers/podman-desktop/pull/1790)\\n- [`Christophe Fergeau`](https://github.com/cfergeau) in [#1642 - Fix: Pod list \\"an pod\\" typing error](https://github.com/containers/podman-desktop/pull/1642)\\n\\n## Final notes\\n\\nThe complete list of issues fixed in this release is available [here](https://github.com/containers/podman-desktop/issues?q=is%3Aclosed+milestone%3A0.13.0).\\n\\nGet the latest release from the [Downloads](/downloads) section of the website and boost your development journey with Podman Desktop. Additionally, visit the [GitHub repository](https://github.com/containers/podman-desktop) and see how you can help us make Podman Desktop better."},{"id":"5-things-to-know-for-a-docker-user","metadata":{"permalink":"/blog/5-things-to-know-for-a-docker-user","source":"@site/blog/2023-03-24-5-things-to-know-for-a-docker-user.md","title":"5 things to know about Podman Desktop for a Docker user","description":"Important things to know when switching from Docker Desktop to Podman Desktop","date":"2023-03-24T00:00:00.000Z","formattedDate":"March 24, 2023","tags":[{"label":"podman-desktop","permalink":"/blog/tags/podman-desktop"},{"label":"docker","permalink":"/blog/tags/docker"},{"label":"migrating","permalink":"/blog/tags/migrating"}],"readingTime":4.275,"hasTruncateMarker":true,"authors":[{"name":"Florent Benoit","title":"Maintainer of Podman Desktop","url":"https://github.com/benoitf","imageURL":"https://github.com/benoitf.png","key":"benoitf"}],"frontMatter":{"title":"5 things to know about Podman Desktop for a Docker user","description":"Important things to know when switching from Docker Desktop to Podman Desktop","slug":"5-things-to-know-for-a-docker-user","authors":["benoitf"],"tags":["podman-desktop","docker","migrating"],"hide_table_of_contents":false},"prevItem":{"title":"Release Notes - Podman Desktop 0.13","permalink":"/blog/podman-desktop-release-0.13"},"nextItem":{"title":"Release Notes - Podman Desktop 0.12","permalink":"/blog/podman-desktop-release-0.12"}},"content":"The 5 things to know being a Docker user by using Podman Desktop:\\n\\n- **Use a single UI**: Podman Desktop works with several container engines, including Docker.\\n- The **compatibility mode**: How to ensure tools are working with Podman instead of Docker.\\n- **Compose** support: How to work with Compose files and Podman.\\n- **Kubernetes** support: How to use Kubernetes with Podman.\\n- **Security**: Use `rootless` mode or containers without root privileges.\\n\\n![5-things-to-know-for-a-docker-user-hero](img/5-things-to-know-for-a-docker-user/5-things-to-know-for-a-docker-user-hero.png)\\n\\n\x3c!--truncate--\x3e\\n\\n---\\n\\n## Use Podman Desktop to interact with containers running in Docker\\n\\nDocker Desktop provides a UI to interact with containers and images. But the UI depends on Docker API and it is not possible to use the UI with Docker and Podman at the same time.\\n\\nPodman Desktop is a multi-engine UI tool. The UI is compatible with the API of Docker and Podman. It means all containers and images from all the engines at the same time are visible in the UI.\\n\\nWhen migrating from Docker to Podman, you can use Podman Desktop to interact with containers running in Docker. Explore all commands and features of Podman Desktop and see all the resources from Docker.\\n\\n![Many container engines at the same time](img/5-things-to-know-for-a-docker-user/multiple-container-engines.png)\\n\\n## Docker compatibility mode\\n\\nUsing Podman with Podman Desktop or with the Podman CLI is straightforward. But some tools expect to find `docker` CLI or `docker.sock` socket. In this case, you have to use the compatibility mode of Podman.\\n\\n### Socket file compatibility\\n\\nThe socket compatibility mode is a feature of Podman that allows to bind the Podman socket under the Docker socket path.\\n\\nOn Windows the socket compatibility mode is always enabled by default. On macOS, by using the `.pkg installer` it is active by default. But when installing with `brew`, it will not be there because it requires some admin permissions.\\n\\nThat is not an issue because you can enable it by [invoking a CLI tool](https://podman-desktop.io/docs/migrating-from-docker/using-podman-mac-helper) that will setup the compatibility mode.\\n\\nFor example if you use [`TestContainers`](https://www.testcontainers.org/) in your Java project, you can use the compatibility mode to ensure that the tool will use Podman instead of Docker.\\n\\n### CLI compatibility\\n\\nIf you have scripts relying on `docker` CLI, you can use the compatibility mode to ensure that the tool is working with Podman instead of Docker.\\n\\nIf you have the `docker` CLI installed on your computer, you can use the socket file compatibility of docker to ensure that the tool is working with Podman engine instead of Docker.\\n\\nIf you do not have the `docker` CLI installed on your computer, you can [Create a script](https://podman-desktop.io/docs/migrating-from-docker/emulating-docker-cli-with-podman) called `docker` that will call the `podman` CLI\\n\\n**_NOTE:_** creating a shell prompt alias, for example `alias docker=podman`, will not work inside scripts that you call.\\n\\n## Compose\\n\\nAs a user of Docker, you might use `docker compose` (or `docker-compose`) to run some of your applications.\\n\\nFor now Podman does not include a `Compose` support directly in the CLI with a command `podman compose`.\\n\\n`Compose` can work with the Podman socket.\\n\\nBased on the compatibility mode (see [section about Docker compatibility mode](#docker-compatibility-mode)):\\n\\n- Enabled: you can use the `compose` binary to run your applications.\\n- Disabled: you need to [export the environment variable DOCKER_HOST](https://podman-desktop.io/docs/migrating-from-docker/using-the-docker_host-environment-variable) before running compose.\\n\\nYou can now use the `compose` binary to run your applications and it will use Podman engine.\\n\\nPodman Desktop has a `compose` extension that can fetch `compose` binary if not already available on the filesystem.\\n\\nPodman Desktop UI displays the containers created by `Compose` are in the same group.\\n\\n![Compose support in the UI](img/5-things-to-know-for-a-docker-user/compose-containers-in-ui.png)\\n\\n## Kubernetes\\n\\nIt is possible to start a Kubernetes cluster with Docker.\\n\\nPodman supports directly a subset of Kubernetes resources that you can use with `.yaml` files.\\n\\nFor example if you only want to create a `Pod` resource, you can use the `Play Kubernetes YAML` button from the `Containers` list screen with your `.yaml` file. No need to install or start a Kubernetes cluster.\\n\\n![Play Kubernetes YAML](img/5-things-to-know-for-a-docker-user/play-kubernetes-yaml.png)\\n\\nIt is possible to do the counter-part. Export the definition of a container or pod to a Kubernetes resource. You can use the `Generate kube` button from the kebab menu of a given container or pod.\\n\\n![Kubernetes generate](img/5-things-to-know-for-a-docker-user/kube-generate.png)\\n\\nPodman handles pods and in the Podman Desktop UI, you can see all the pods inside a Pod section. All containers inside the pod are in the same group.\\n\\n![Pods in the UI](img/5-things-to-know-for-a-docker-user/pods-in-ui.png)\\n\\n![Containers from pod](img/5-things-to-know-for-a-docker-user/containers-from-pod.png)\\n\\nAn experimental `kind` extension is bringing the creation of full-blown Kubernetes cluster with Podman.\\n\\n## Rootless mode\\n\\nOne of the difference of Docker and Podman is the way they handle containers. Docker requires root privileges to run containers by default. Podman can run containers without root privileges by default.\\n\\nIt means that for example, starting a container with a port < 1024 will not work. You need to use a port > 1024.\\n\\nIf you still need to create containers with a port < 1024, you can change the Podman machine configuration of the Podman Machine if you are on Windows or macOS.\\n\\nThe command is `podman machine --rootful` to enable the execution with root privileges or `podman machine --rootful=false` to switch back to rootless mode."},{"id":"podman-desktop-release-0.12","metadata":{"permalink":"/blog/podman-desktop-release-0.12","source":"@site/blog/2023-02-15-release-0.12.md","title":"Release Notes - Podman Desktop 0.12","description":"Podman Desktop 0.12 has been released!","date":"2023-02-15T00:00:00.000Z","formattedDate":"February 15, 2023","tags":[{"label":"podman-desktop","permalink":"/blog/tags/podman-desktop"},{"label":"release","permalink":"/blog/tags/release"},{"label":"kubernetes","permalink":"/blog/tags/kubernetes"}],"readingTime":4.505,"hasTruncateMarker":true,"authors":[{"name":"Stevan Le Meur","title":"Product Manager","url":"https://github.com/slemeur","imageURL":"https://github.com/slemeur.png","key":"slemeur"}],"frontMatter":{"title":"Release Notes - Podman Desktop 0.12","description":"Podman Desktop 0.12 has been released!","slug":"podman-desktop-release-0.12","authors":["slemeur"],"tags":["podman-desktop","release","kubernetes"],"hide_table_of_contents":false},"prevItem":{"title":"5 things to know about Podman Desktop for a Docker user","permalink":"/blog/5-things-to-know-for-a-docker-user"},"nextItem":{"title":"Release Notes - Podman Desktop 0.11","permalink":"/blog/podman-desktop-release-0.11"}},"content":"import ReactPlayer from \'react-player\'\\n\\nThis release note covers Podman Desktop 0.12 release changes.\\n\\n\x3c!--Main Features--\x3e\\n\\n- **Podman Version**: Podman 4.4.1 now included in Windows and Mac installers.\\n- **Containers Configuration**: Configure port mappings for an image without exported ports.\\n- **Windows Home Support**: Podman Desktop now supports Windows Home Edition.\\n- **Start minimized**: Option to start Podman Desktop minimized to system tray.\\n- **UX and UI Improvements**: Consistent actions, placeholder for logs, unified icons and others.\\n\\nPodman Desktop 0.12 is now available. [Click here to download it](/downloads)!\\n\\n![podman-desktop-0-12-hero](img/podman-desktop-release-0.12/podman-desktop-release-0.12.png)\\n\\n\x3c!--truncate--\x3e\\n\\n---\\n\\n## Release Details\\n\\n### Update to Podman v4.4.1 [#1456](https://github.com/containers/podman-desktop/pull/1456)\\n\\nPodman Desktop 0.12 embeds [Podman 4.4.1](https://github.com/containers/podman/releases/tag/v4.4.1) in Windows and macOS installers. Make sure to upgrade to benefit from the latest Podman features and bug fixes.\\n\\n### Configuring port mappings when an image has no exported port [#1265](https://github.com/containers/podman-desktop/pull/1265)\\n\\nWith the latest update, users can now add multiple local-to-remote port mappings when starting a container from an image that has no exported ports. This feature provides users with the flexibility to specify which ports on their local machine should map to which ports on the container, even if the container does not have any exported ports by default.\\n\\n![port-mapping](https://user-images.githubusercontent.com/49404737/215112797-86dcf3f0-121a-487e-a71f-ad41e91f93da.gif)\\n\\n### Installing Podman Dekstop on Windows Home Edition [#1268](https://github.com/containers/podman-desktop/pull/1268)\\n\\nPodman Desktop 0.12 offers the ability to be installed on Windows Home Edition. The mechanism uses Virtual Machine Platform detection, instead of hyper-v. WSL2 is still requires but can be installed along with the installation process.\\n\\n![install-windows-home-edition-2](https://user-images.githubusercontent.com/436777/215121429-7c757aaa-a838-43db-98a2-78ad368f407e.png)\\n\\n### Option to automatically minimize Podman Desktop on login [#1374](https://github.com/containers/podman-desktop/pull/1374)\\n\\nPodman Desktop now provides a \\"start minimized\\" option when users log in onto the laptop. This option, available from the application\'s settings, can be useful if users want to automatically launch Podman Desktop at log in, but prefer not to have the window visible on the screen. With this feature, you can ensure that Podman Desktop is up and running in the background without any interruption to your workflows.\\n\\n- Go to ** Settings > Preferences > Login: Minimize** to activate the option.\\n\\n![minimize-on-login](https://user-images.githubusercontent.com/6422176/216651424-bcf756fd-7554-4b24-a838-e3e2f798fe6e.png)\\n\\n### UI and UX Improvements\\n\\n#### Improved actions consistency [#1225](https://github.com/containers/podman-desktop/pull/1225)\\n\\nActions displayed in the list pages for Images and Containers have been reviewed and made consistent between other pages.\\n\\n![action-consistency-1](https://user-images.githubusercontent.com/19958075/214104678-2d4148d7-484e-41f9-9da9-aecee328ae2b.png)\\n\\nActions displayed in the header of the container\'s details page have been improved so that the actions are always displayed in the same order.\\n\\n![action-consistency-2](https://user-images.githubusercontent.com/19958075/214104663-64fa0601-bb79-49bf-8226-6a78a88d3622.png)\\n\\n#### Consistent status icons for Pods, Containers, Images and Volumes [#1326](https://github.com/containers/podman-desktop/pull/1326), [#1377](https://github.com/containers/podman-desktop/pull/1377), [#1459](https://github.com/containers/podman-desktop/pull/1459) and [#1245](https://github.com/containers/podman-desktop/pull/1245)\\n\\nThe status icons for Pods, Containers, Images, and Volumes have been unified and use consistent states.\\n\\n![pods-status-icon](https://user-images.githubusercontent.com/19958075/216671859-bdd8dca4-56b7-40a8-961a-dcb6e01be61e.png)\\n\\nIcons in empty screens have been updated to use the same consistent SVG icon as the status icons.\\n\\n![empty-screen-2](https://user-images.githubusercontent.com/436777/214577726-f4cfde7b-017a-499d-a2a9-e50d455ffaf0.png)\\n\\n#### Placeholder when logs for containers are being fetched [#1353](https://github.com/containers/podman-desktop/pull/1353)\\n\\nA placeholder is now displayed when logs are being fetched.\\n![placeholder-loading-logs](https://user-images.githubusercontent.com/49404737/216952505-899308ae-183e-487a-b6e5-28832a0b6452.gif)\\n\\n#### Fixed alignement in badges from the navigation sidebar [#1357](https://github.com/containers/podman-desktop/pull/1357)\\n\\nBadges in the sidebar are now aligned with the title of the section.\\n\\n![alignement-badges](https://user-images.githubusercontent.com/49404737/216336502-2a34dea3-fd41-4184-8cfe-9226d70da070.png)\\n\\n#### Enable/disable open browser action based on container state [#1395](https://github.com/containers/podman-desktop/pull/1395) and [#1397](https://github.com/containers/podman-desktop/pull/1397)\\n\\nThe action to open the browser if a port is opened in a container, is now disabled when the container is stopped. It is also hidden in the kebab menu.\\n\\n![enable-disable-container-actions](https://user-images.githubusercontent.com/49404737/217284414-1bdc820b-30a8-485e-b0f9-485229026696.gif)\\n\\n---\\n\\n## Other Notable Enhancements\\n\\n- Display extension icons [#1058](https://github.com/containers/podman-desktop/pull/1058)\\n- Solid Icons [#1267](https://github.com/containers/podman-desktop/pull/1276)\\n- Differentiate icons compared to status icons [#1268](https://github.com/containers/podman-desktop/pull/1298)\\n- Refactors window initializing [#1309](https://github.com/containers/podman-desktop/pull/1309)\\n- Change window creation background color to dark [#1310](https://github.com/containers/podman-desktop/pull/1310)\\n- Use Podman `machine inspect` to read the address to connect to the Podman machine [#1364](https://github.com/containers/podman-desktop/pull/1364)\\n- Update the editor content when the pod name changes, and disable the deploy button when empty [#1403](https://github.com/containers/podman-desktop/pull/1403)\\n- Ability to manually set color of tray icon for Windows and Linux [#1243](https://github.com/containers/podman-desktop/pull/1243)\\n- Better UI feedback when starting pods [#1242](https://github.com/containers/podman-desktop/pull/1242)\\n\\n---\\n\\n## Documentation\\n\\nThe documentation had many editorial reviews, and new content.\\n\\n- [Link to simple WSL2 installation instructions](https://podman-desktop.io/docs/Installation/windows-install)\\n- [Refresh Windows Installation](https://podman-desktop.io/docs/Installation/windows-install)\\n- [Revamped installation introduction](https://podman-desktop.io/docs/Installation)\\n- [Reorganized Linux installation](https://podman-desktop.io/docs/Installation/linux-install)\\n- [Installing Podman with OpenShift Local](https://podman-desktop.io/docs/Installation/windows-install/installing-podman-with-openshift-local)\\n- [Installing Podman Desktop on Windows in a restricted environment](https://podman-desktop.io/docs/Installation/windows-install/installing-podman-desktop-and-podman-in-a-restricted-environment)\\n- [Fixed documentation on `podman-mac-helper` setup](https://podman-desktop.io/docs/migrating-from-docker/using-podman-mac-helper)\\n\\n---\\n\\n## Notable bug fixes\\n\\n- Fixed handling path with spaces on Windows when installing Podman [#1270](https://github.com/containers/podman-desktop/pull/1270)\\n- Removed padding from SVG icons [#1253](https://github.com/containers/podman-desktop/pull/1253)\\n- Website: fixed download links for Windows and macOS binaries [#1255](https://github.com/containers/podman-desktop/pull/1255)\\n- Fixed prettier commands on Windows [#1266](https://github.com/containers/podman-desktop/pull/1267)\\n- Fixed new xterm instance spawn when clicking the logs route [#1344](https://github.com/containers/podman-desktop/pull/1344)\\n- Fixed need to wait that telemetry has been initilized before proceeding [#1373](https://github.com/containers/podman-desktop/pull/1373)\\n- Fixed new xterm instance spawn when clicking the logs route in pod details[#1393](https://github.com/containers/podman-desktop/pull/1393)\\n- Fixed stop spinner if image cannot be retrieved [#1394](https://github.com/containers/podman-desktop/pull/1394)\\n- Fixed escape command with quotes only for Windows [#1462](https://github.com/containers/podman-desktop/pull/1462)\\n- Fixed random CRC status change [#1420](https://github.com/containers/podman-desktop/pull/1420)\\n\\n---\\n\\n## Community Thank You\\n\\n\ud83c\udf89 We\u2019d like to say a big thank you to everyone who helped to make Podman Desktop 0.12 even better:\\n\\n- [Philipp Wagner](https://github.com/imphil) in [#1274 - Link to simple WSL2 installation instructions](https://github.com/containers/podman-desktop/pull/1274)\\n- [Arthur S](https://github.com/arixmkii) in [#1364 - Get podman machine socketPath from podman machine inspect first](https://github.com/containers/podman-desktop/pull/1364)\\n- [Mitch West](https://github.com/Mitch9378) in [#1428 - Fix old documentation for \'podman-mac-helper setup\'](https://github.com/containers/podman-desktop/pull/1428)\\n\\n## Final Notes\\n\\nThe complete list of issues fixed in this release is available [here](https://github.com/containers/podman-desktop/issues?q=is%3Aclosed+milestone%3A0.12.0).\\n\\nGet the latest release from the [Downloads](/downloads) section of the website and boost your development journey with Podman Desktop. Additionally, visit the [GitHub repository](https://github.com/containers/podman-desktop) and see how you can help us make Podman Desktop better."},{"id":"podman-desktop-release-0.11","metadata":{"permalink":"/blog/podman-desktop-release-0.11","source":"@site/blog/2023-01-18-release-0.11.md","title":"Release Notes - Podman Desktop 0.11","description":"Podman Desktop 0.11 has been released!","date":"2023-01-18T00:00:00.000Z","formattedDate":"January 18, 2023","tags":[{"label":"podman-desktop","permalink":"/blog/tags/podman-desktop"},{"label":"release","permalink":"/blog/tags/release"},{"label":"kubernetes","permalink":"/blog/tags/kubernetes"}],"readingTime":9.43,"hasTruncateMarker":true,"authors":[{"name":"Stevan Le Meur","title":"Product Manager","url":"https://github.com/slemeur","imageURL":"https://github.com/slemeur.png","key":"slemeur"}],"frontMatter":{"title":"Release Notes - Podman Desktop 0.11","description":"Podman Desktop 0.11 has been released!","slug":"podman-desktop-release-0.11","authors":["slemeur"],"tags":["podman-desktop","release","kubernetes"],"hide_table_of_contents":false},"prevItem":{"title":"Release Notes - Podman Desktop 0.12","permalink":"/blog/podman-desktop-release-0.12"},"nextItem":{"title":"Release Notes - Podman Desktop 0.10","permalink":"/blog/podman-desktop-release-0.10"}},"content":"import ReactPlayer from \'react-player\'\\n\\nThis release note covers Podman Desktop 0.11 release changes.\\n\\n- **Air-Gapped Installation**: New all-in-one binaries for air-gapped installation.\\n- **Feedback**: Submit feedback directly from Podman Desktop.\\n- **Docker Compatibility Mode**: Information about the Docker compatibility mode.\\n- **Proxy Setting**: Toggle on/off the proxy setting.\\n- **Deploy to Kubernetes**: Select the namespace to deploy to Kubernetes.\\n- **Registry Configuration**: Simplified registry configuration for well known registries.\\n- **UX/UI Improvements**: View pod\'s container logs, better visual feedback, configurable editor font size, and more.\\n\\nPodman Desktop 0.11 is now available. [Click here to download it](/downloads)!\\n\\n\x3c!--truncate--\x3e\\n\\n---\\n\\n## Release Details\\n\\n### Air-Gapped installation [#1104](https://github.com/containers/podman-desktop/pull/1104) [#1120](https://github.com/containers/podman-desktop/pull/1120)\\n\\nFor 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:\\n\\n- on Mac, it embeds the qemu FCOS binaries.\\n- on Windows, it embeds the WSL binary.\\n\\nTo differentiate the air-gapped binaries from the regular ones, you can check the artifactname, they\'re containing \'airgap\' and are bigger.\\nPlease note, that those binaries are available only on releases and not the pre-releases.\\n\\nThere 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).\\n\\n\\n\\n### Feedback within Podman Desktop [#1078](https://github.com/containers/podman-desktop/pull/1078)\\n\\nSubmitting 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.\\n\\n\\n\\nPlease feel free to submit any feedback you have, we are looking forward to hearing from you!\\n\\n### Docker compatibility mode [#1047](https://github.com/containers/podman-desktop/pull/1047)\\n\\nThe 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](https://www.testcontainers.org/) or others are relying on this to communicate to the container engine.\\n\\nIn 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:\\n\\n- When Docker is running: the socket is pointing to Docker.\\n- When Podman is starting and Docker is not running: the docker API socket will use Podman.\\n\\nIn 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](https://podman-desktop.io/docs/migrating-from-docker).\\n\\nThis is a warning displayed for Windows users:\\n![windows-docker-compatibility](https://user-images.githubusercontent.com/436777/209305744-9056addd-f122-4f75-9e03-ad27a0109375.png)\\n\\nThis is the warning for Mac users:\\n![mac-docker-compatibility](https://user-images.githubusercontent.com/6422176/207964861-a9c1f72c-89d6-4816-beab-397af4125620.png)\\n\\n### Allow to toggle on/off the proxy setting [#983](https://github.com/containers/podman-desktop/pull/983)\\n\\nIn 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.\\n\\n\\n\\nNote: extensions can read this information and then update the proxy configuration.\\n\\n### Namespace selection for deploy to Kubernetes [#1008](https://github.com/containers/podman-desktop/pull/1008)\\n\\nA 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.\\n\\nIf the user have set `kubectl config set-context --current --namespace=NAMESPACE` it honors that as the chosen value.\\n\\n![deploy-kubernetes-namespace](https://user-images.githubusercontent.com/7339809/206688886-095e4f15-42ae-4a0a-b1c6-ae4b547fcdfb.gif)\\n\\n### Configure Podman binary path [#941](https://github.com/containers/podman-desktop/pull/941)\\n\\nUsers may 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. Additional information is available in the documentation for Mac users: [http://podman-desktop.io/docs/troubleshooting#unable-to-set-custom-binary-path-for-podman-on-macos](http://podman-desktop.io/docs/troubleshooting#unable-to-set-custom-binary-path-for-podman-on-macos)\\n\\n![custom-path](https://user-images.githubusercontent.com/6422176/204832063-5858065a-2fc3-49de-8d23-3b99b7d10dbf.png)\\n\\n### Provide pre-defined registries [#1201](https://github.com/containers/podman-desktop/pull/1201)\\n\\nThe 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:\\n\\n- Dockerhub\\n- Red Hat Quay\\n- GitHub\\n- IBM Container Registry\\n- Google Container Registry\\n\\n\\n\\n### UI/UX Improvements\\n\\n#### View Pods logs [#1122](https://github.com/containers/podman-desktop/pull/1122)\\n\\nThe 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.\\n\\n![pods-logs](https://user-images.githubusercontent.com/6422176/211024673-eee9bad8-1b0c-4446-b8d1-97a226282c4d.png)\\n\\n#### Improved feedback when clicking on container list action icons [#1150](https://github.com/containers/podman-desktop/pull/1150) [#1161](https://github.com/containers/podman-desktop/pull/1161)\\n\\nWhen 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.\\n\\n\\n\\nFor 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](https://github.com/containers/podman-desktop/pull/1161).\\n\\n\\n\\n#### Allows to change the default font size for the editor [#1160](https://github.com/containers/podman-desktop/pull/1160)\\n\\nAn 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).\\n\\n\\n\\n#### Keep expanded state of pods when refreshing containers [#1042](https://github.com/containers/podman-desktop/pull/1042)\\n\\nWhen 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.\\n\\n\\n\\n#### Click on the Pod name redirects to the Pod details page [#1159](https://github.com/containers/podman-desktop/pull/1159)\\n\\nThe list of containers also displays pods, now clicking on the pod name directly redirects to the Pod details page.\\n\\n\\n\\n#### Improved styles of buttons for actions [#984](https://github.com/containers/podman-desktop/pull/984)\\n\\nThe 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.\\n\\nOn lists:\\n![list-actions](https://user-images.githubusercontent.com/6422176/205979121-b49a0ddf-03bb-4a4d-8d12-bc8d0bd52387.png)\\n\\nOn details pages:\\n![details-actions](https://user-images.githubusercontent.com/6422176/205979123-ea420b17-e834-4029-82eb-22949889eee9.png)\\n\\n#### Improved alignments in pages with lists [#1182](https://github.com/containers/podman-desktop/pull/1182)\\n\\nThe 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.\\n\\n![list-actions](https://user-images.githubusercontent.com/19958075/212712580-096fd090-0beb-40a4-8dc6-b3fdc5e81e35.png)\\n\\n---\\n\\n## Other Notable Enhancements\\n\\n- Statistics area in container details are always shown. ([#1131](https://github.com/containers/podman-desktop/pull/1131))\\n- Add more descriptive wording and more information to extensions. ([#985](https://github.com/containers/podman-desktop/pull/985))\\n- Allow to install on-the fly Podman Desktop extensions using an OCI image. ([#1187](https://github.com/containers/podman-desktop/pull/1187))\\n- Display correctly non-multiplexed stream in logs (when using non interactive mode). ([#1197](https://github.com/containers/podman-desktop/pull/1197))\\n- Font changed from white to gray for non-name sections (creation date, size). ([#1206](https://github.com/containers/podman-desktop/pull/1206))\\n- Add Help/about menu for macOS/Windows/Linux. ([#1207](https://github.com/containers/podman-desktop/pull/1207))\\n\\n---\\n\\n## Documentation\\n\\nComing with this new version of Podman Desktop, the documentation has been getting attention (with number of editorial reviews) and new content have been added.\\n\\nContent for helping users to migrate from Docker to Podman has been added:\\n\\n- [Using the `podman-mac-helper` tool to migrate from Docker to Podman on macOS](https://github.com/containers/podman-desktop/pull/1088)\\n- [better identify podman-mac-helper verification steps](https://github.com/containers/podman-desktop/pull/1129)\\n- [Emulating Docker CLI using Podman to migrate from Docker to Podman](https://github.com/containers/podman-desktop/pull/1143)\\n- [Migrating from Docker section](https://github.com/containers/podman-desktop/pull/1146)\\n- [Verifying that your tools are using Podman](https://github.com/containers/podman-desktop/pull/1152)\\n- [Importing saved containers](https://github.com/containers/podman-desktop/pull/1144)\\n\\nSeveral of other improvements have been made to the documentation and the website:\\n\\n- [Troubleshooting for Apple Silicon and brew x86_64 installs](https://github.com/containers/podman-desktop/pull/962)\\n- [Change text of custom binary location, add docs](https://github.com/containers/podman-desktop/pull/972)\\n- [Silent install option for windows](https://github.com/containers/podman-desktop/pull/974)\\n- [Upgrade to vite v4 and rollup v3](https://github.com/containers/podman-desktop/pull/1079)\\n- [Refreshing documentation on installing on Linux](https://github.com/containers/podman-desktop/pull/1118)\\n- [Identify the shell sessions in Installing on Linux](https://github.com/containers/podman-desktop/pull/1130)\\n- [Website: the linux binary is not a source, it should be promoted as a binary](https://github.com/containers/podman-desktop/pull/1133)\\n- [Introducing tabs for operatings systems and container engines](https://github.com/containers/podman-desktop/pull/1162)\\n- [website: In the landing page, update plugins and container engines lists](https://github.com/containers/podman-desktop/pull/1165)\\n- [Document where code is located within Podman Desktop](https://github.com/containers/podman-desktop/pull/1163)\\n- [(extension-api): Documentation on how to write an extension and use the api](https://github.com/containers/podman-desktop/pull/1172)\\n\\n---\\n\\n## Notable bug fixes\\n\\n- Update to v0.3.2 Docker Desktop API for extensions - [#1070](https://github.com/containers/podman-desktop/pull/1070)\\n- Updated link to the Matrix room - [#1076](https://github.com/containers/podman-desktop/pull/1076)\\n- Report error when container name already exists - [#1142](https://github.com/containers/podman-desktop/pull/1142)\\n- Fixed connectivity to the Podman machine when the generated socket length is greater than 104 characters in MacOS - [#1145](https://github.com/containers/podman-desktop/pull/1145)\\n- Do not use long calls for external clients - [#1151](https://github.com/containers/podman-desktop/pull/1151)\\n- Invalid name/tag for images with registries using a different port - [#1127](https://github.com/containers/podman-desktop/pull/1127)\\n- Invalid badge count for images when two images have the same tag - [#1124](https://github.com/containers/podman-desktop/pull/1124)\\n- Fixed detection of WSL2 - [#981](https://github.com/containers/podman-desktop/pull/981)\\n- Handle invalid kubeconfig files instead of crashing - [#953](https://github.com/containers/podman-desktop/pull/953)\\n- Removed redundant actions from details pages - [#1200](https://github.com/containers/podman-desktop/pull/1200)\\n- Fixed registry URL not aligned with header - [#1205](https://github.com/containers/podman-desktop/pull/1205)\\n- Moved SVGs to reusable components - [#1211](https://github.com/containers/podman-desktop/pull/1211)\\n\\n**Extensions API has also been improved in this new release:**\\n\\n- (extension-api): Allows to register a factory for kubernetes connection objects (like for container connections) - [#1040](https://github.com/containers/podman-desktop/pull/1040)\\n- (extension-api): List or inspect containers, be notified on events - [#1041](https://github.com/containers/podman-desktop/pull/1041)\\n- (extension-api): Allows to get provider notification - [#1045](https://github.com/containers/podman-desktop/pull/1045)\\n- (dd-extension-api): Implement toast API - [#1154](https://github.com/containers/podman-desktop/pull/1154)\\n- (extension-api): Moved extension properties to preferences - [#948](https://github.com/containers/podman-desktop/pull/948)\\n- (dd-extension-api): Added open dev console on dd webview in development mode - [#1071](https://github.com/containers/podman-desktop/pull/1071)\\n- (extension-api): Added notes on extension and frameworks/tooling of Podman Desktop - [#1166](https://github.com/containers/podman-desktop/pull/1166)\\n- (extension-api): Documentation on how to write an extension and use the api - [#1172](https://github.com/containers/podman-desktop/pull/1172)\\n- (dd-extension-api): DD extensions should see only minimal information on containers - [#1191](https://github.com/containers/podman-desktop/pull/1191)\\n\\n---\\n\\n## Community Thank You\\n\\n\ud83c\udf89 We\u2019d like to say a big thank you to everyone who helped to make Podman Desktop 0.11 even better:\\n\\n- [Emmanuel Bernard](https://github.com/emmanuelbernard) in [#962 - Troubleshooting for Apple Silicon](https://github.com/containers/podman-desktop/pull/962)\\n- [Michael Prankl](https://github.com/eidottermihi) in [#974 - Silent install option for windows](https://github.com/containers/podman-desktop/pull/974)\\n- [Endre Lervik](https://github.com/elervik) in [#1008 - Namespace selection for deploy to kubernetes](https://github.com/containers/podman-desktop/pull/1008)\\n- [Evan FP](https://github.com/evanfpearson) in [#1145 - fixed socket path length error](https://github.com/containers/podman-desktop/pull/1145)\\n- [Lokesh Mandvekar](https://github.com/lsm5) in [#956 - add repository key to package.json](https://github.com/containers/podman-desktop/pull/956)\\n- [Jean Fran\xe7ois Maury](https://github.com/jeffmaury) in [#1194 - Cannot create Kind cluster on Windows](https://github.com/containers/podman-desktop/pull/1194)\\n\\n## Final Notes\\n\\nThe complete list of issues fixed in this release is available [here](https://github.com/containers/podman-desktop/issues?q=is%3Aclosed+milestone%3A0.11.0).\\n\\nGet the latest release from the [Downloads](/downloads) section of the website and boost your development journey with Podman Desktop. Additionally, visit the [GitHub repository](https://github.com/containers/podman-desktop) and see how you can help us make Podman Desktop better."},{"id":"podman-desktop-release-0.10","metadata":{"permalink":"/blog/podman-desktop-release-0.10","source":"@site/blog/2022-12-01-release-0.10-blog.md","title":"Release Notes - Podman Desktop 0.10","description":"Podman Desktop 0.10 has been released! New Create Container Wizard, improved Kubernetes workflows, revamped registries configuration, and more!","date":"2022-12-01T00:00:00.000Z","formattedDate":"December 1, 2022","tags":[{"label":"podman-desktop","permalink":"/blog/tags/podman-desktop"},{"label":"release","permalink":"/blog/tags/release"},{"label":"kubernetes","permalink":"/blog/tags/kubernetes"}],"readingTime":4.115,"hasTruncateMarker":true,"authors":[{"name":"Dev Kumar","title":"Technical PMM Intern","url":"https://github.com/deekay2310","imageURL":"https://github.com/deekay2310.png","key":"deekay2310"}],"frontMatter":{"title":"Release Notes - Podman Desktop 0.10","description":"Podman Desktop 0.10 has been released! New Create Container Wizard, improved Kubernetes workflows, revamped registries configuration, and more!","slug":"podman-desktop-release-0.10","authors":["deekay2310"],"tags":["podman-desktop","release","kubernetes"],"hide_table_of_contents":false},"prevItem":{"title":"Release Notes - Podman Desktop 0.11","permalink":"/blog/podman-desktop-release-0.11"},"nextItem":{"title":"Build & run Podman Desktop in a DevContainer","permalink":"/blog/develop-using-devcontainer"}},"content":"This release note covers Podman Desktop 0.10 release changes.\\n\\n- **Containers Configuration**: Container creation wizzard allowing to define environment variables, networking and more configuration options.\\n- **Kubernetes Improvements**: Play Kubernetes YAML, custom Kubeconfig path support, reload of kube context.\\n- **Registries Configuration**: Revamped registries configuration UI.\\n- **Podman Version**: Podman 4.3.1 now included in Windows and Mac installers.\\n- **UX/UI Improvements**: Improved lists, better contrast, and more.\\n\\nPodman Desktop 0.10 is now available. [Click here to download it](/downloads)!\\n\\n\x3c!--truncate--\x3e\\n\\n---\\n\\n## Release Details\\n\\n### New configuration wizzard to create containers ([#773](https://github.com/containers/podman-desktop/pull/773))\\n\\nUntil now, we could only specify port binding when building images to start containers. The create container wizzard now includes several options enabling configuring volumes, environment variables, restart policy and settings on networking and security. It is also possible to reuse an existing (and already configured) a network when creating containers.\\n\\n![new container creation wizard](img/podman-desktop-release-0.10/new_container_creation_wizard.gif)\\n\\n### Kubernetes Capabilities Improvements\\n\\n**Custom Kubeconfig file path ([#780](https://github.com/containers/podman-desktop/pull/780))**\\n\\nKubeconfig path location is now configurable from ** Settings > Preferences > Kubernetes: Kubeconfig** and can be set to a custom path. By default, Podman Desktop use the path `$HOME/.kube/config` for the Kubeconfig file.\\n\\n![custom kubeconfig file path](img/podman-desktop-release-0.10/custom-kubeconfig.png)\\n\\n**Play Kubernetes YAML from the Pods list ([#739](https://github.com/containers/podman-desktop/pull/739))**\\n\\nPodman Desktop enables to play existing Kubernetes YAML files. This is now available from `Play Kubernetes YAML` button added to the Pods list, in addition to the Containers list.\\n\\n![play k8s yaml](img/podman-desktop-release-0.10/play_k8s_yaml.gif)\\n\\n**Kube context automatically reloaded when updated ([#813](https://github.com/containers/podman-desktop/pull/813))**\\n\\nAny change to the kube context will now be detected by Podman Desktop in its running state. The system tray, allowing to select which Kubernetes environment to work with, will now reload the kube context without restarting Podman Desktop.\\n\\n### Revamped Container Registries UI ([#446](https://github.com/containers/podman-desktop/issues/446))\\n\\nThe registries configuration UI has been revamped. Instead of using tiles for displaying the registries, now it uses a list where each registry can be added or edited directly in the list. The kebab menu provides options to edit or remove a registry from the list.\\n\\n![registries](img/podman-desktop-release-0.10/registries.png)\\n\\n### Update to Podman 4.3.1 ([#913](https://github.com/containers/podman-desktop/issues/913))\\n\\nPodman Desktop 0.10 is now embedding [Podman 4.3.1](https://github.com/containers/podman/releases/tag/v4.3.1) in Windows and macOS installers.\\n\\n### UI/UX Improvements\\n\\n**Improved lists UX ([#877](https://github.com/containers/podman-desktop/pull/877))**\\n\\nTo reduce the width used in the lists when displaying all the icons, main actions icons are now always displayed (before it was on hover) and the secondary actions are displayed in a kebab menu. For example Start/Stop and delete are primary actions while open the browser, inspect, generate kube yaml, etc. are secondary options.\\n\\n![kebab menu](img/podman-desktop-release-0.10/kebab-menu.png)\\n\\n**Delay appearance of text in navbar ([#767](https://github.com/containers/podman-desktop/pull/767))**\\n\\nWhen minimizing or expanding the navbar, the text was overlapping for a few second the page. Now it\'s displayed with a fading animation.\\n\\n**Selected state: better text color contrast ([#802](https://github.com/containers/podman-desktop/pull/802))**\\n\\nIn the `Images` page, on hover for both the image and the name column, the text contrast has been increased for better visibility: violet indicates that you have selected it.\\n\\n![text color when hover](img/podman-desktop-release-0.10/text-color.gif)\\n\\n**On Linux and Windows, the menu bar is now hidden by default ([#668](https://github.com/containers/podman-desktop/pull/668))**\\n\\nWith this change, the menu bar looks more integrated to the Operating System. The menu can appear if you hit the `Alt` key. Thanks to [Dylan M. Taylor](https://github.com/dylanmtaylor) for contributing to fix this.\\n\\n**Exit when clicking on the close icon of the dashboard on Linux ([#671](https://github.com/containers/podman-desktop/pull/671))**\\n\\nFor most users on Linux, there is no tray icon support. In this situation, when closed, Podman Desktop continues to run in background. [Dylan M. Taylor](https://github.com/dylanmtaylor) added a property to exit the app by default when clicking on the close icon. For people having tray icon support or with the desire of a different behavior, it is possible to disable it from the Settings.\\n\\n---\\n\\n## Other Notable Enhancements\\n\\n- Rename `Started` into `Age` in Containers list.([#878](https://github.com/containers/podman-desktop/pull/878))\\n- Added domain validation when adding a registry. ([#838](https://github.com/containers/podman-desktop/pull/838))\\n- Provided a consistent behavior with Podman CLI, `podman-machine-default` is now the default name when creating a Podman machine from Podman Desktop. ([#775](https://github.com/containers/podman-desktop/pull/775))\\n\\n---\\n\\n## Notable bug fixes\\n\\n- Fixed error handling when pulling images of Desktop Extensions. ([#782](https://github.com/containers/podman-desktop/pull/782))\\n- Fixed use of the full height of the screen when displaying log in the details of a container. ([#946](https://github.com/containers/podman-desktop/discussions/946))\\n- Fixed First start of Podman Desktop on flatpak was not seeing the podman engine ([#860](https://github.com/containers/podman-desktop/pull/860))\\n\\n## Community Thank You\\n\\n\ud83c\udf89 We\u2019d like to say a big thank you to everyone who helped to make Podman Desktop 0.10 even better:\\n\\n- [Dylan M. Taylor](https://github.com/dylanmtaylor) in [#671](https://github.com/containers/podman-desktop/pull/671)\\n- [Fionn Kelleher](https://github.com/osslate) in [#713](https://github.com/containers/podman-desktop/pull/713)\\n- [Rostislav Svoboda](https://github.com/rsvoboda) in [#737](https://github.com/containers/podman-desktop/pull/737)\\n- [Denis Shemanaev](https://github.com/shemanaev) in [#783](https://github.com/containers/podman-desktop/pull/783)\\n- [Fabrice Flore-Th\xe9bault](https://github.com/themr0c) in [#856](https://github.com/containers/podman-desktop/pull/856)\\n- [Kevin](https://github.com/KevinAtSesam) in [#864](https://github.com/containers/podman-desktop/pull/864)\\n- [@sfrunza13](https://github.com/sfrunza13) in [#872](https://github.com/containers/podman-desktop/pull/872)\\n- [Anjan Nath](https://github.com/anjannath) in [#918](https://github.com/containers/podman-desktop/pull/918)\\n\\n## Final Notes\\n\\nThe complete list of issues fixed in this release is available [here](https://github.com/containers/podman-desktop/issues?q=is%3Aclosed+milestone%3A0.10.0).\\n\\nGet the latest release from the [Downloads](/downloads) section of the website and boost your development journey with Podman Desktop. Additionally, visit the [GitHub repository](https://github.com/containers/podman-desktop) and see how you can help us make Podman Desktop better."},{"id":"develop-using-devcontainer","metadata":{"permalink":"/blog/develop-using-devcontainer","source":"@site/blog/2022-11-17-develop-podman-using-codespaces.md","title":"Build & run Podman Desktop in a DevContainer","description":"Develop Podman Desktop using a DevContainer locally or using GitHub Codespaces.","date":"2022-11-17T00:00:00.000Z","formattedDate":"November 17, 2022","tags":[{"label":"podman-desktop","permalink":"/blog/tags/podman-desktop"},{"label":"devcontainer","permalink":"/blog/tags/devcontainer"},{"label":"codespaces","permalink":"/blog/tags/codespaces"}],"readingTime":6.985,"hasTruncateMarker":true,"authors":[{"name":"Florent Benoit","title":"Maintainer of Podman Desktop","url":"https://github.com/benoitf","imageURL":"https://github.com/benoitf.png","key":"benoitf"}],"frontMatter":{"title":"Build & run Podman Desktop in a DevContainer","description":"Develop Podman Desktop using a DevContainer locally or using GitHub Codespaces.","slug":"develop-using-devcontainer","authors":["benoitf"],"tags":["podman-desktop","devcontainer","codespaces"],"hide_table_of_contents":false},"prevItem":{"title":"Release Notes - Podman Desktop 0.10","permalink":"/blog/podman-desktop-release-0.10"}},"content":"GitHub [announced last week](https://github.blog/changelog/2022-11-09-codespaces-for-free-and-pro-accounts/) that Codespaces is available for everyone and it includes free minutes.\\n\\nLet see how we can use a [Development Container](https://containers.dev/) having all the tools to build and run Podman Desktop. The Development Container works locally using Visual Studio Code but in this blog post we will see how it works directly with a simple click from GitHub.\\n\\nThe challenges are to run a desktop tool (Podman Desktop) and running a container engine (Podman) inside this Development Container without using too many memory !\\n\\n\x3c!--truncate--\x3e\\n\\n## Defining image of the container\\n\\nThe first thing is in the choice of the image for the container. It is possible to pick-up a default image and add some features but there is no existing feature for Podman at and most of the features are expecting to run on top of Debian/Ubuntu\\n\\nIf you are not interested in how to setup the image, jump to the [next section](#configure-the-devcontainer-using-devcontainerjson).\\n\\nPodman binaries are available quickly after the releases for Fedora. I decided then to use `Fedora 37` as the base image.\\n\\nLet start the Containerfile using:\\n\\n```docker\\nFROM quay.io/fedora/fedora:37\\n```\\n\\nThen I install Node.js 16 from official nodejs.org repository. It\'s easier to switch to the version that we need.\\n\\n```docker\\n# install Node.js + yarn\\nENV NODE_VERSION 16.18.1\\nRUN curl -SLO \\"https://nodejs.org/dist/v$NODE_VERSION/node-v$NODE_VERSION-linux-x64.tar.gz\\" && \\\\\\n tar -xzf \\"node-v$NODE_VERSION-linux-x64.tar.gz\\" -C /usr/local --strip-components=1 && \\\\\\n rm \\"node-v$NODE_VERSION-linux-x64.tar.gz\\" && \\\\\\n npm install -g yarn\\n```\\n\\nNow, all system dependencies used to run an Electron application needs to be installed.\\n\\nPodman is also installed so we can run some containers inside this container.\\n\\nAnd of course, we need to install VNC (I choose [tigervnc](https://tigervnc.org/)) with a light Window Manager ([fluxbox](http://fluxbox.org/)).\\n\\nTo connect to the display of the container, we need to expose VNC over HTML/websocket using [noVNC](https://novnc.com/)\\n\\nxterm is installed to start a terminal from the VNC side.\\n\\n```docker\\nRUN dnf -y update && \\\\\\n yum -y reinstall shadow-utils && \\\\\\n yum install -y git \\\\\\n # dependencies for Podman Desktop\\n nss \\\\\\n atk \\\\\\n at-spi2-atk \\\\\\n cups-libs \\\\\\n gtk3 \\\\\\n # for remote Display\\n fluxbox \\\\\\n tigervnc-server \\\\\\n xorg-x11-fonts-Type1 \\\\\\n novnc \\\\\\n supervisor \\\\\\n xdpyinfo \\\\\\n # for podman\\n podman \\\\\\n fuse-overlayfs --exclude container-selinux \\\\\\n xterm && \\\\\\n rm -rf /var/cache /var/log/dnf* /var/log/yum.*\\n```\\n\\nSupervisord setup the launch of the VNC server and the Window manager\\n\\n```docker\\nCOPY supervisord.conf /etc/supervisord.conf\\n```\\n\\nA custom theme for fluxbox:\\n\\n```docker\\nCOPY fluxbox /usr/share/fluxbox/init\\n```\\n\\nThen we need a special configuration to allow to have Podman working inside the container\\n\\nWe add the `podman-desktop` user with correct range on subuid and subgid when running containers. I used the [tutorial](https://github.com/containers/podman/blob/main/docs/tutorials/rootless_tutorial.md#etcsubuid-and-etcsubgid-configuration).\\n\\n```docker\\nRUN useradd -u 1000 podman-desktop && echo podman-desktop:10000:5000 > /etc/subuid && echo podman-desktop:10000:5000 > /etc/subgid\\n```\\n\\nThen use some default configuration files\\n\\n```docker\\n# initialize conf files\\nADD https://raw.githubusercontent.com/containers/libpod/master/contrib/podmanimage/stable/containers.conf /etc/containers/containers.conf\\nADD https://raw.githubusercontent.com/containers/libpod/master/contrib/podmanimage/stable/podman-containers.conf /home/podman-desktop/.config/containers/containers.conf\\n```\\n\\nand make sure that all permissions are correct following the guide [https://www.redhat.com/sysadmin/podman-inside-container](https://www.redhat.com/sysadmin/podman-inside-container)\\n\\n```docker\\n# set permissions\\nRUN chown podman-desktop:podman-desktop -R /home/podman-desktop && chmod 644 /etc/containers/containers.conf && \\\\\\n mkdir -p /var/lib/shared/overlay-images /var/lib/shared/overlay-layers /var/lib/shared/vfs-images /var/lib/shared/vfs-layers; touch /var/lib/shared/overlay-images/images.lock; touch /var/lib/shared/overlay-layers/layers.lock; touch /var/lib/shared/vfs-images/images.lock; touch /var/lib/shared/vfs-layers/layers.lock && \\\\\\n mkdir -p /run/user/1000 && chown podman-desktop:podman-desktop /run/user/1000\\n```\\n\\nplus define an empty user namespace.\\n\\n```docker\\nENV _CONTAINERS_USERNS_CONFIGURED=\\"\\"\\n```\\n\\nMake sure Podman will create the socket in an expected directory:\\n\\n```docker\\n# socket path for podman\\nENV XDG_RUNTIME_DIR=/run/user/1000\\n```\\n\\nOK ! we have a custom Containerfile providing all the tools to build and run Podman Desktop (using VNC for the display), run Podman and run Electron.\\n\\nThe current file is available at \\n\\nLet\'s configure the DevContainer.\\n\\n## Configure the DevContainer using devcontainer.json\\n\\nDevContainer definition is stored at `.devcontainer/devcontainer.json` file.\\n\\nWe need to reuse the image of the previous step. For that let\'s use the build section of the `devcontainer.json` file.\\n\\n```json\\n\\"build\\": {\\n \\"dockerfile\\": \\"Containerfile\\"\\n},\\n```\\n\\nIn order to avoid to redo all the build steps each time we open a workspace using this dev container, we published the image to quay.io at [quay.io/podman-desktop/devcontainer-parent:next\\n](https://quay.io/repository/podman-desktop/devcontainer-parent?tab=tags&tag=next). This parent image is not changing much so it\'s better to use is as a parent one.\\n\\nInside `.devcontainer` directory there is a `.parent` directory with everything related to the parent image.\\n\\nAnd in the `.devcontainer/Containerfile` file we reference this image\\n\\n```docker\\nFROM quay.io/podman-desktop/devcontainer-parent:next\\n```\\n\\nBy default, we will be `root` in the container and this is probably not what we expect. Let\'s change that.\\n\\n```json\\n\\"containerUser\\": \\"podman-desktop\\"\\n```\\n\\nSome Visual Studio Code extensions are nice to use and we can add them\\n\\n```json\\n \\"extensions\\": [\\"svelte.svelte-vscode\\", \\"bradlc.vscode-tailwindcss\\"]\\n```\\n\\nThen here is the tricky part, how to run our container allowing to run again inside the container some containers with podman.\\n\\nWe specify the arguments to make it possible. It\'s possible to use `--privileged` flag but I prefer to list the subset of permissions.\\nUsing `--privileged` we don\'t really know what are the privilege that are required while specifying all of them, people are aware of what is granted/denied.\\n\\n```json\\n\\"runArgs\\": [\\n \\"--cap-add=sys_admin\\",\\n \\"--security-opt\\",\\n \\"seccomp=unconfined\\",\\n \\"--device\\",\\n \\"/dev/fuse\\",\\n \\"--security-opt\\",\\n \\"label=disable\\",\\n \\"--security-opt\\",\\n \\"apparmor=unconfined\\"\\n ],\\n```\\n\\nSource code of Podman Desktop needs to be editable within the DevContainer so it needs to be mounted.\\n\\n```json\\n\\"workspaceMount\\": \\"source=${localWorkspaceFolder},target=/workspace,type=bind\\",\\n\\"workspaceFolder\\": \\"/workspace\\",\\n```\\n\\nThen we need a command to build Podman Desktop.\\n\\nFor that, we use `onCreateCommand` hook with a custom command\\n\\n```json\\n\\"onCreateCommand\\": \\"${containerWorkspaceFolder}/.devcontainer/onCreateCommand.sh\\",\\n```\\n\\nand in the `.devcontainer` folder the `onCreateCommand.sh` script is the following\\n\\n```shell\\n#!/bin/sh\\nyarn\\n\\nMODE=production yarn run build && yarn run electron-builder build --linux --dir --config .electron-builder.config.cjs\\n```\\n\\nTwo instructions:\\n\\n1. Fetch all Node.js dependencies.\\n2. build Podman Desktop in the `dist` folder using `Linux` as target Operating System.\\n\\nAfter the start of the container, how to launch Podman Desktop, the website and VNC, etc ?\\n\\nJust use `postStartCommand` hook.\\n\\n```json\\n\\"postStartCommand\\": \\"${containerWorkspaceFolder}/.devcontainer/postStartCommand.sh\\",\\n```\\n\\nand in the `.devcontainer` folder the `postStartCommand.sh` script is the following:\\n\\n```shell\\n#!/bin/sh\\n\\n# Start all services\\n/usr/bin/supervisord -c /etc/supervisord.conf &\\n\\n# wait X server to be ready or after 2mn exit\\necho \\"Waiting for X server to be ready\\"\\ntimeout 120 bash -c \'until xdpyinfo -display :0 &> /dev/null; do printf \\".\\"; sleep 1; done\'\\n\\n# launch podman desktop\\necho \\"Launching Podman Desktop\\"\\ncd dist/linux-unpacked/&& ./podman-desktop &\\n\\n# Launch the 9000 redirect after 20 seconds\\nsleep 20\\nwebsockify --web=/usr/share/novnc localhost:9000 localhost:5900 &\\n\\n# launch the website rendering\\necho \\"Launching Website\\"\\ncd website && yarn start\\n```\\n\\nIt starts VNC and noVNC, start precompiled Podman Desktop and start the documentation rendering.\\n\\nIt is not launching the Watch mode/development mode of Podman Desktop as it requires a container having more than 8GB of memory.\\n\\nPicking up a larger instace with for example 16GB, it\'s possible to use development mode.\\n\\nOf course, to make VNC happy, we need to specify the `DISPLAY` environment variable.\\n\\n```json\\n\\"remoteEnv\\": {\\n \\"DISPLAY\\": \\":0\\"\\n}\\n```\\n\\nWhen the DevContainer is fully available, we want to have a way to quickly open the `Website rendering URL` and `noVNC`\\n\\nLet\'s tweak the `devcontainer.json` file by adding the `portsAttributes` section\\n\\n```json\\n\\"portsAttributes\\": {\\n \\"9000\\": {\\n \\"label\\": \\"vnc\\",\\n \\"onAutoForward\\": \\"openPreview\\"\\n },\\n \\"3000\\": {\\n \\"label\\": \\"website\\"\\n }\\n}\\n```\\n\\nAfter all post-creation steps, the `Preview` browser inside the VS Code editor will open a window to VNC. And another port (`3000`) is flagged for the website.\\n\\n## Using the DevContainer.json on Github Codespace\\n\\nAs a user, opening a workspace with all what we configured is done using a single click.\\n\\nGo to then click on the `< > Code` dropdown and click on `Create codespace on main` button.\\n\\n![Open Codespace](img/develop-podman-using-codespaces/codespaces-click-repository.png)\\n\\nOnce you click on the button, the codespace is setting up:\\n\\n![Preparing Codepace](img/develop-podman-using-codespaces/codespaces-preparing-codespace.png)\\n\\nAfter few minutes, as there is not yet [prebuilt codespaces](https://docs.github.com/en/codespaces/prebuilding-your-codespaces/about-github-codespaces-prebuilds), the codespace is opening.\\n\\nThe simple Browser displays the noVNC window:\\n![Opening Codespace](img/develop-podman-using-codespaces/codespaces-open-novnc.png)\\n\\nClick on the connect button. Then on the terminal you can enter `podman run quay.io/podman/hello` and the container is detected in Podman Desktop.\\n![Testing Codespace](img/develop-podman-using-codespaces/codespaces-testing-podman-desktop.png)\\n\\nIt\'s also possible using the port widget to get on `3000` port by clicking on the world icon a preview of the website in another tab. Changing source code of the website will refresh the content of the window.\\n\\nDepending on the usecase, it\'s also possible to open documentation in the preview browser.\\n\\n![Edit website Codespace](img/develop-podman-using-codespaces/codespaces-edit-website.png)\\n\\n## Conclusion\\n\\nThe DevContainer image for Podman Desktop is recent so it\'ll probably evolve over time by adding new capabilities but it allows you to easily build/run/experiment and **contribute** to the tool or the website."}]}')}}]); \ No newline at end of file diff --git a/assets/js/b2f554cd.feafcc1e.js b/assets/js/b2f554cd.feafcc1e.js deleted file mode 100644 index b4533c699b3..00000000000 --- a/assets/js/b2f554cd.feafcc1e.js +++ /dev/null @@ -1 +0,0 @@ -"use strict";(self.webpackChunkdocs=self.webpackChunkdocs||[]).push([[1477],{30010:e=>{e.exports=JSON.parse('{"blogPosts":[{"id":"podman-desktop-release-1.3","metadata":{"permalink":"/blog/podman-desktop-release-1.3","source":"@site/blog/2023-08-16-release-1.3.md","title":"Release Notes - Podman Desktop 1.3","description":"Podman Desktop 1.3 has been released!","date":"2023-08-16T00:00:00.000Z","formattedDate":"August 16, 2023","tags":[{"label":"podman-desktop","permalink":"/blog/tags/podman-desktop"},{"label":"release","permalink":"/blog/tags/release"},{"label":"kubernetes","permalink":"/blog/tags/kubernetes"},{"label":"openshift","permalink":"/blog/tags/openshift"}],"readingTime":5.195,"hasTruncateMarker":false,"authors":[{"name":"Denis Golovin","title":"Principal Software Engineer","url":"https://github.com/cdrage","imageURL":"https://github.com/dgolovin.png","key":"dgolovin"}],"frontMatter":{"title":"Release Notes - Podman Desktop 1.3","description":"Podman Desktop 1.3 has been released!","slug":"podman-desktop-release-1.3","authors":["dgolovin"],"tags":["podman-desktop","release","kubernetes","openshift"],"hide_table_of_contents":false,"image":"/img/blog/podman-desktop-release-1.3.webp"},"nextItem":{"title":"Release Notes - Podman Desktop 1.2","permalink":"/blog/podman-desktop-release-1.2"}},"content":"import ReactPlayer from \'react-player\'\\n\\nPodman Desktop 1.3 Release! \ud83c\udf89\\n\\nThis is essentially a bug-fix release to fix various issues in UI, extension engine and featured extensions, but as usual we also added a few new features.\\n\\n- **Podman 4.6.1**: Podman 4.6.1 included in Windows and Mac installers\\n- **Podman user-mode networking support to Windows/WSL**: A new switch `User mode networking\' is available when creating Podman machine on Windows for Podman 4.6.0+ to configure podman to work in certain VPN setups and other specialized networking configurations\\n- **Compose group new UI elements**: You can now see summary, inspect, deploy to kubernetes, generate kube yaml and view logs\\n- **Extension packs and extension dependencies**: Install group of extensions in one click\\n- **Resource details page update**: See summary and log for resource\\n- **Create Kind cluster form update**: A new `Node\'s container image` field can be used to specify the Kubernetes version used for the control-planed\\n- **Support Docker Desktop extensions using a backend**: When loading Docker Desktop extension the containers are created in the backend as described in the vm section of extension\'s descriptor\\n- **Podman Initial Onboarding (preview)**: Install and configure podman using included installer\\n\\nPodman Desktop 1.3 is now available. [Click here to download it](/downloads)!\\n\\n![Podman-desktop-1-3-bug-swatting](img/podman-desktop-release-1.3/title-bug-swatting.png)\\n\\n---\\n\\n## Release Details\\n\\n### Compose group Logs tab [#3176](https://github.com/containers/podman-desktop/pull/3176)\\n\\nWhen clicking on the group of containers, you can now view the logs of the entire group of compose containers and don\'t need to open\\nlog for every component individually.\\n\\n![Screenshot 2023-07-11 at 12 48 47 PM](https://github.com/containers/podman-desktop/assets/6422176/743a4ffc-e291-4697-8ac5-8052cc921946)\\n\\n### Podman user-mode networking support to Windows/WSL [#3251](https://github.com/containers/podman-desktop/pull/3251)\\n\\nCertain VPN setups or other specialized networking configs will block traffic from the virtual WSL networking device, resulting in the podman WSL backend from being unable to contact systems on the VPN, and potentially losing internet access altogether. The new switch allows you to create a podman VM machine configured to work correctly in mentioned above networking environments.\\n\\n![user](https://github.com/containers/podman-desktop/assets/620330/2f521576-b6a6-42b5-b24d-08df5b432608)\\n\\n### Compose group Summary tab [#3317](https://github.com/containers/podman-desktop/pull/3317),\\n\\nCompose group Summary tab shows all containers in the group and let you navigate to Details page for specific container.\\n\\n\\n\\n### Compose group Inspect tab [#3316](https://github.com/containers/podman-desktop/pull/3316)\\n\\nCompose group Inspect tab shows an array of \\"container inspect\\" from docker / podman.\\n\\n\\n\\n### `Deploy to kubernetes` in compose actions [#3299](https://github.com/containers/podman-desktop/pull/3295)\\n\\nA button to deploy to kubernetes added to Compose group.\\n\\n\\n\\n### `Generate Kube` in Compose actions and `Kube` tab in compose details [#3253](https://github.com/containers/podman-desktop/pull/3253)\\n\\n`Generate Kube` item added to Compose actions and \\"Kube\\" tab is now available in Compose details view.\\n\\n\\n\\n### Install multiple extensions using extension pack [#3150](https://github.com/containers/podman-desktop/pull/3150)\\n\\nAn Extension pack introduced in Extension engine is a way to declare set of extensions to install them all at once.\\n\\n\\n\\n### Customize icons from extension [#3131](https://github.com/containers/podman-desktop/pull/3131)\\n\\nExtensions now can customize icons for list elements using `when` clause.\\n\\n![image](https://github.com/containers/podman-desktop/assets/49404737/7aae5347-4f07-4854-ba11-1f629b5ccf22)\\n\\n### Resource details page update [#1923](https://github.com/containers/podman-desktop/pull/1923)\\n\\nIf you click on the arrow icon next to a resource name it will open up a details page (similarly to how clicking on a container in the container list opens up a details page).\\n\\n![image](https://user-images.githubusercontent.com/49404737/229542404-bae44f89-5cd3-4baf-8b08-e934e4462697.gif)\\n\\n### `Node\'s container image` field added to `Create a Kind cluster` form [#3508](https://github.com/containers/podman-desktop/pull/3508)\\n\\nThe new `Node\'s container image` field can be used to specify the Kubernetes version used for the control-planed.\\n\\n![image](https://github.com/containers/podman-desktop/assets/42176370/b2a63faf-629f-436d-8496-7c0cd8158679)\\n\\n### Support Docker Desktop extensions using a backend [#3435](https://github.com/containers/podman-desktop/pull/3435)\\n\\nPodman Desktop now loads the containers in the backend as described in the vm section of extension descriptor the same way as Docker Desktop does.\\n\\n### Initial onboarding implementation for podman (experimental) [#3308](https://github.com/containers/podman-desktop/pull/3308)\\n\\nThis is the initial implementation for the onboarding feature. It only covers a simple onboarding for podman. Check system requirements -> install podman -> yay! Done!\\n\\n### Notable Bug Fixes\\n\\n- Updating videos to be adaptive for mobile by @mairin [#3229](https://github.com/containers/podman-desktop/pull/3229)\\n- Consistent max width and padding in settings by @deboer-tim [#3232](https://github.com/containers/podman-desktop/pull/3232)\\n- Settings navigation bar resizing by @deboer-tim in [#3231](https://github.com/containers/podman-desktop/pull/3231)\\n- Move new registry button to header by @deboer-tim [#3245](https://github.com/containers/podman-desktop/pull/3245)\\n- Bigger lima logo by @afbjorklund [#3248](https://github.com/containers/podman-desktop/pull/3248)\\n- Horizontal docker logo by @afbjorklund [#3236](https://github.com/containers/podman-desktop/pull/3236)\\n- Respect LIMA_HOME environment variable by @afbjorklund [#3254](https://github.com/containers/podman-desktop/pull/3254)\\n- Add check before writing to terminal by @lstocchi [#3263](https://github.com/containers/podman-desktop/pull/3263)\\n- Wait until remote side has fully initialized the extensions by @benoitf [#3257](https://github.com/containers/podman-desktop/pull/3257)\\n- Fix loader not centered horizontally by @benoitf [#3270](https://github.com/containers/podman-desktop/pull/3270)\\n- Troubleshooting still waiting after failure by @deboer-tim [#3354](https://github.com/containers/podman-desktop/pull/3354)\\n- Store error for build by @cdrage [#3365](https://github.com/containers/podman-desktop/pull/3365)\\n- Missing checkbox tooltips by @deboer-tim [#3380](https://github.com/containers/podman-desktop/pull/3380)\\n- Load compose logs async not await by @cdrage [#3377](https://github.com/containers/podman-desktop/pull/3377)\\n- Set rootful connection when starting rootful machine by @lstocchi [#3364](https://github.com/containers/podman-desktop/pull/3364)\\n- Default last page by @deboer-tim [#3388](https://github.com/containers/podman-desktop/pull/3388)\\n- Avoid dashboard displaying providers starting while they don\'t by @benoitf [#3451](https://github.com/containers/podman-desktop/pull/3451)\\n- Do not use extensionInfo until it is defined by @benoitf [#V](https://github.com/containers/podman-desktop/pull/3450)\\n- Allow BASIC authentication (all caps) by @cdrage [#3471](https://github.com/containers/podman-desktop/pull/3471)\\n- Allow single domain registry such as localhost:5000 by @cdrage [#3468](https://github.com/containers/podman-desktop/pull/3468)\\n- Create /usr/local/bin directory if it does not exist on binary install by @cdrage [#3425](https://github.com/containers/podman-desktop/pull/3425)\\n- Only delete selected pods by @deboer-tim [#](https://github.com/containers/podman-desktop/pull/3378)\\n- Add back \'Done\' text on the button by @benoitf [#3487](https://github.com/containers/podman-desktop/pull/3487)\\n- Do not wait for more than 5s when checking for podman ping by @benoitf [#3497](https://github.com/containers/podman-desktop/pull/3497)\\n- Add proxy support for extension using patching get and request approach by @dgolovin [#2825](https://github.com/containers/podman-desktop/pull/2825)\\n- Refresh component when field is updated by @benoitf [#3525](https://github.com/containers/podman-desktop/pull/3525)\\n- Higher-res icons for featured extensions list by @mairin [#3511](https://github.com/containers/podman-desktop/pull/3511)\\n- Main nav selection by @deboer-tim [#3510](https://github.com/containers/podman-desktop/pull/3510)\\n- kube event error when switching context by @jeffmaury [#3494](https://github.com/containers/podman-desktop/pull/3494)\\n- Reset error message each time we pull image by @benoitf [#3550](https://github.com/containers/podman-desktop/pull/3550)\\n\\n### Community Thank You\\n\\n\ud83c\udf89 We\u2019d like to say a big thank you to everyone who helped to make Podman Desktop even better.\\n\\nA warm welcome to [@rostalan](https://github.com/rostalan) and [@axel7083](https://github.com/axel7083) who made their first contribution to the project in this release.\\n\\n### Final Notes\\n\\nThe complete list of issues fixed in this release is available [here](https://github.com/containers/podman-desktop/issues?q=is%3Aclosed+milestone%3A1.3.0).\\n\\nGet the latest release from the [Downloads](/downloads) section of the website and boost your development journey with Podman Desktop. Additionally, visit the [GitHub repository](https://github.com/containers/podman-desktop) and see how you can help us make Podman Desktop better."},{"id":"podman-desktop-release-1.2","metadata":{"permalink":"/blog/podman-desktop-release-1.2","source":"@site/blog/2023-07-12-release-1.2.md","title":"Release Notes - Podman Desktop 1.2","description":"Podman Desktop 1.2 has been released!","date":"2023-07-12T00:00:00.000Z","formattedDate":"July 12, 2023","tags":[{"label":"podman-desktop","permalink":"/blog/tags/podman-desktop"},{"label":"release","permalink":"/blog/tags/release"},{"label":"kubernetes","permalink":"/blog/tags/kubernetes"},{"label":"openshift","permalink":"/blog/tags/openshift"}],"readingTime":6.05,"hasTruncateMarker":false,"authors":[{"name":"Charlie Drage","title":"Software Engineer","url":"https://github.com/cdrage","imageURL":"https://github.com/cdrage.png","key":"cdrage"}],"frontMatter":{"title":"Release Notes - Podman Desktop 1.2","description":"Podman Desktop 1.2 has been released!","slug":"podman-desktop-release-1.2","authors":["cdrage"],"tags":["podman-desktop","release","kubernetes","openshift"],"hide_table_of_contents":false,"image":"/img/blog/podman-desktop-release-1.2.webp"},"prevItem":{"title":"Release Notes - Podman Desktop 1.3","permalink":"/blog/podman-desktop-release-1.3"},"nextItem":{"title":"Release Notes - Podman Desktop 1.1","permalink":"/blog/podman-desktop-release-1.1"}},"content":"import ReactPlayer from \'react-player\'\\n\\nPodman Desktop 1.2 Release! \ud83c\udf89\\n\\nWe\'re excited to announce the release of Podman Desktop version 1.2.0! This release includes many new features (Kubernetes, Compose and extension support!), bug fixes, and improvements to enhance your container management experience. Here\'s a summary of the key changes in this release:\\n\\n- **Added start/stop/delete/restart buttons for Compose**: You can now make changes to an entire Compose group of containers\\n- **Kubernetes context on the status bar**: Choose from multiple Kubernetes contexts more easily all from the status bar\\n- **Rename images**: Rename an image with a click of a button\\n- **Protocol handler support**: Added support for protocol handlers such as `open podman-desktop:extension/redhat.openshift-local`\\n- **Troubleshooting page**: A troubleshooting page for helping diagnose Podman Desktop related development issues\\n\\nPodman Desktop 1.2 is now available. [Click here to download it](/downloads)!\\n\\n![Podman-desktop-1-2-hero](img/podman-desktop-release-1.2/podman-desktop-release-1.2.png)\\n\\n---\\n\\n## Release Details\\n\\n### Added start/stop/delete/restart buttons for Compose\\n\\nIn the last month we\'ve been addind support for more Compose features. Before you were only able to control a group of containers if they were in a Pod. Now we have added the ability to control a group of Compose containers. You can now start, stop, delete and restart a group of containers launched by either `docker-compose` or `podman-compose`.\\n\\nStay tuned as we add even more features to Compose! If you have any feedback or feature requests, feel free to open an issue or start a discussion on GitHub.\\n\\n\\n\\n### Kubernetes context on the status bar\\n\\nWith Kubernetes context on the status bar, you can switch from one context to another in just a couple of clicks. Easily switch to a different cluster all together. If there are multiple contexts available, you can now click and pick which one to use.\\n\\n\\n\\n### Rename images\\n\\nDeployed an image but now you need to rename it / add a new tag? Podman Desktop allows you to edit an image now. Thanks to an awesome contributor [@tuckerrc](https://github.com/tuckerrc) who added the new feature.\\n\\n\\n\\n### Troubleshooting page\\n\\nDeveloping an extension for Podman Desktop? Want to view the logs of Podman Desktop as well as ping your container connection? We now have a troubleshooting page!\\n\\nClick on the lightbulb button on the bottom right to access the page.\\n\\n\\n\\n### Protocol handler support\\n\\nPodman Desktop now supports protocol handling when using the terminal! Want to access your favourite extension directly from a script or the terminal? If you type in `open podman-desktop:extension/redhat.openshift-local` in the terminal, Podman Desktop will automatically load up to the correct extension.\\n\\n\\n\\n---\\n\\n## Other Notable Features\\n\\n- Background colors and FormPage ([PR #2977](https://github.com/containers/podman-desktop/pull/2977))\\n- Add ability to add insecure registry / skipping cert verify ([PR #2896](https://github.com/containers/podman-desktop/pull/2896))\\n- Add support for icon contribution ([PR #2984](https://github.com/containers/podman-desktop/pull/2984))\\n- Add warning dialog message that virtual machine has low memory limit ([PR #2822](https://github.com/containers/podman-desktop/pull/2822))\\n- Propose indexed name for new pod ([PR #3028](https://github.com/containers/podman-desktop/pull/3028))\\n- Add restart button after enabling / disabling mac os compatibility ([PR #2841](https://github.com/containers/podman-desktop/pull/2841))\\n- Add environment related helper constants ([PR #3079](https://github.com/containers/podman-desktop/pull/3079))\\n- Allow entrypoint and cmd when starting container ([PR #3031](https://github.com/containers/podman-desktop/pull/3031))\\n- Add a way to debug stores in troubleshooting page ([PR #3121](https://github.com/containers/podman-desktop/pull/3121))\\n- Add custompick component (#2855) ([PR #3012](https://github.com/containers/podman-desktop/pull/3012))\\n- Dynamic breadcrumbs ([PR #3119](https://github.com/containers/podman-desktop/pull/3119))\\n- Icons on form pages ([PR #3155](https://github.com/containers/podman-desktop/pull/3155))\\n- Switch more pages to formpage ([PR #3162](https://github.com/containers/podman-desktop/pull/3162))\\n- Add rename image button ([PR #2588](https://github.com/containers/podman-desktop/pull/2588))\\n- Fixed headers, improved scrollbars ([PR #2863](https://github.com/containers/podman-desktop/pull/2863))\\n- Reports warnings on failed kube deploy, fixes error out ([PR #3050](https://github.com/containers/podman-desktop/pull/3050))\\n- Kube context on statusbar ([PR #2755](https://github.com/containers/podman-desktop/pull/2755))\\n- Install provider if not installed when clicking on create new button (#2706) ([PR #2817](https://github.com/containers/podman-desktop/pull/2817))\\n- Add tag and authenticated push capacity to the extension API ([PR #2876](https://github.com/containers/podman-desktop/pull/2876))\\n- Add navigation bar e2e tests ([PR #2950](https://github.com/containers/podman-desktop/pull/2950))\\n\\n---\\n\\n## Documentation Updates\\n\\n- Fix documentation for building image of extensions ([PR #2873](https://github.com/containers/podman-desktop/pull/2873))\\n- Add Minikube install docs ([PR #2824](https://github.com/containers/podman-desktop/pull/2824))\\n- Add Minikube documentation ([PR #2694](https://github.com/containers/podman-desktop/pull/2694))\\n- Updated Building an image procedure ([PR #2964](https://github.com/containers/podman-desktop/pull/2964))\\n- Starting a container ([PR #2958](https://github.com/containers/podman-desktop/pull/2958))\\n- Pulling an image ([PR #2956](https://github.com/containers/podman-desktop/pull/2956))\\n- Updated selecting containers to run in a pod ([PR #2970](https://github.com/containers/podman-desktop/pull/2970))\\n- Pushing an image to a registry ([PR #2969](https://github.com/containers/podman-desktop/pull/2969))\\n- How to add an insecure registry ([PR #2953](https://github.com/containers/podman-desktop/pull/2953))\\n- Add documentation for lima ([PR #2995](https://github.com/containers/podman-desktop/pull/2995))\\n- Replace broken link to podman.io ([PR #2994](https://github.com/containers/podman-desktop/pull/2994))\\n- Authenticating to a pre-configured registry ([PR #2965](https://github.com/containers/podman-desktop/pull/2965))\\n- Lima is not a container engine ([PR #3051](https://github.com/containers/podman-desktop/pull/3051))\\n- Using the Troubleshooting page ([PR #3083](https://github.com/containers/podman-desktop/pull/3083))\\n- View and select your current Kubernetes context in the status bar ([PR #3090](https://github.com/containers/podman-desktop/pull/3090))\\n\\n---\\n\\n## Notable Bug Fixes\\n\\n- Deleting a running pod generates an error ([PR #2827](https://github.com/containers/podman-desktop/pull/2827))\\n- If kubeconfig is empty, does not try to do things, cancel ([PR #2874](https://github.com/containers/podman-desktop/pull/2874))\\n- Async telemetry startup ([PR #2885](https://github.com/containers/podman-desktop/pull/2885))\\n- Do not block startup while waiting for kube resource refresh ([PR #2884](https://github.com/containers/podman-desktop/pull/2884))\\n- Images list too wide ([PR #2918](https://github.com/containers/podman-desktop/pull/2918))\\n- Compose deactivate function never called ([PR #2922](https://github.com/containers/podman-desktop/pull/2922))\\n- Auto-scrolling on form pages, layout issues ([PR #2927](https://github.com/containers/podman-desktop/pull/2927))\\n- Show current context in quick pick ([PR #2920](https://github.com/containers/podman-desktop/pull/2920))\\n- Remove sticky position of loader in dashboard UI (#2535) ([PR #2959](https://github.com/containers/podman-desktop/pull/2959))\\n- Undo change that broke the website ([PR #2992](https://github.com/containers/podman-desktop/pull/2992))\\n- Detailspage, resizing & consistency ([PR #2987](https://github.com/containers/podman-desktop/pull/2987))\\n- Quick pick click to close and over nav bar ([PR #2758](https://github.com/containers/podman-desktop/pull/2758))\\n- Only show empty screen when no pods ([PR #2929](https://github.com/containers/podman-desktop/pull/2929))\\n- Do not redirect to /pods when deleting pod in containerlist ([PR #2963](https://github.com/containers/podman-desktop/pull/2963))\\n- Bulk delete on pods should call the pod deletion ([PR #2979](https://github.com/containers/podman-desktop/pull/2979))\\n- Update nodejs version to 18 in .nvmrc to fix yarn install failure ([PR #2989](https://github.com/containers/podman-desktop/pull/2989))\\n- Website check targets ([PR #2996](https://github.com/containers/podman-desktop/pull/2996))\\n- Don\'t show exception to user ([PR #3034](https://github.com/containers/podman-desktop/pull/3034))\\n- Interpret arguments given to info command for example ([PR #3015](https://github.com/containers/podman-desktop/pull/3015))\\n- Change defaults for Podman machine ([PR #3061](https://github.com/containers/podman-desktop/pull/3061))\\n- Normalize development/production folders path ([PR #3113](https://github.com/containers/podman-desktop/pull/3113))\\n- Calculate machine socket path for linux ([PR #3070](https://github.com/containers/podman-desktop/pull/3070))\\n- Replace backslash with slash so to support rendering on Windows (#3120) ([PR #3122](https://github.com/containers/podman-desktop/pull/3122))\\n- Keep stdout and stderr in the error object for Docker Desktop extensions ([PR #3014](https://github.com/containers/podman-desktop/pull/3014))\\n- Mark task completed if there\'s a failure ([PR #3016](https://github.com/containers/podman-desktop/pull/3016))\\n- Handle invalid kubeconfig file ([PR #3129](https://github.com/containers/podman-desktop/pull/3129))\\n- Do not remove registries when podman extension is stopping ([PR #3136](https://github.com/containers/podman-desktop/pull/3136))\\n- Warning should be amber ([PR #3153](https://github.com/containers/podman-desktop/pull/3153))\\n- Load user extensions from plugins as removable ([PR #3152](https://github.com/containers/podman-desktop/pull/3152))\\n- Images with spaces in entrypoints or commands fail to start ([PR #3161](https://github.com/containers/podman-desktop/pull/3161))\\n- Scrolling offscreen when clicking checkbox ([PR #3178](https://github.com/containers/podman-desktop/pull/3178))\\n- Avoid messagebox expanding offscreen ([PR #2778](https://github.com/containers/podman-desktop/pull/2778))\\n- Release-notes-generator run failure ([PR #2752](https://github.com/containers/podman-desktop/pull/2752))\\n- Unable to do a new build if the previous one failed ([PR #2721](https://github.com/containers/podman-desktop/pull/2721))\\n\\n---\\n\\n## Community Thank You\\n\\n\ud83c\udf89 We\u2019d like to say a big thank you to everyone who helped to make Podman Desktop even better.\\n\\nA big shoutout to [@afbjorklund](https://github.com/afbjorklund), [@tuckerrc](https://github.com/tuckerrc) and [@evanshortiss](https://github.com/evanshortiss) who contributed to this release!\\n\\n---\\n\\n## Final notes\\n\\nThe complete list of issues fixed in this release is available [here](https://github.com/containers/podman-desktop/issues?q=is%3Aclosed+milestone%3A1.2.0) and [here](https://github.com/containers/podman-desktop/issues?q=is%3Aclosed+milestone%3A1.2.0).\\n\\nGet the latest release from the [Downloads](/downloads) section of the website and boost your development journey with Podman Desktop. Additionally, visit the [GitHub repository](https://github.com/containers/podman-desktop) and see how you can help us make Podman Desktop better."},{"id":"podman-desktop-release-1.1","metadata":{"permalink":"/blog/podman-desktop-release-1.1","source":"@site/blog/2023-06-08-release-1.1.md","title":"Release Notes - Podman Desktop 1.1","description":"Podman Desktop 1.1 has been released!","date":"2023-06-08T00:00:00.000Z","formattedDate":"June 8, 2023","tags":[{"label":"podman-desktop","permalink":"/blog/tags/podman-desktop"},{"label":"release","permalink":"/blog/tags/release"},{"label":"kubernetes","permalink":"/blog/tags/kubernetes"},{"label":"openshift","permalink":"/blog/tags/openshift"}],"readingTime":2.465,"hasTruncateMarker":true,"authors":[{"name":"Tim deBoer","title":"Architect","url":"https://github.com/deboer-tim","imageURL":"https://github.com/deboer-tim.png","key":"deboer"}],"frontMatter":{"title":"Release Notes - Podman Desktop 1.1","description":"Podman Desktop 1.1 has been released!","slug":"podman-desktop-release-1.1","authors":["deboer"],"tags":["podman-desktop","release","kubernetes","openshift"],"hide_table_of_contents":false,"image":"/img/blog/podman-desktop-release-1.1.webp"},"prevItem":{"title":"Release Notes - Podman Desktop 1.2","permalink":"/blog/podman-desktop-release-1.2"},"nextItem":{"title":"Release Notes - Podman Desktop 1.0","permalink":"/blog/podman-desktop-release-1.0"}},"content":"import ReactPlayer from \'react-player\'\\n\\nPodman Desktop 1.1 Release! \ud83c\udf89\\n\\nThis is primarily a bug-fix release to fix a few important issues, but we\'ve managed to squeeze in a few enhancements\\nalong the way.\\n\\n\x3c!--Main Features--\x3e\\n\\n- **Podman 4.5.1**: Podman 4.5.1 now included in Windows and Mac installers.\\n- **Extensions**: Update extensions from within Podman Desktop.\\n- **Lima Support**: Choose engine type and override its name from the settings.\\n- **UX and UI Improvements**: New loading screen.\\n\\nPodman Desktop 1.1 is now available. [Click here to download it](/downloads)!\\n\\n![Podman-desktop-1-1-hero](img/podman-desktop-release-1.1/podman-desktop-release-1.1.png)\\n\\n\x3c!--truncate--\x3e\\n\\n---\\n\\n## Release Details\\n\\n### Podman v4.5.1\\n\\nPodman Desktop 1.1 moves up to [Podman 4.5.1](https://github.com/containers/podman/releases/tag/v4.5.1).\\n\\n### Extensions\\n\\nOptional extensions will follow their own lifecycle and update independently from Podman Desktop. As of\\nthis release you\'ll be able to see when there is an update available and install from within\\nPodman Desktop [#2655](https://github.com/containers/podman-desktop/pull/2655).\\n\\nWe\'ve also added options in **Settings > Preferences** to\\nautomatically check for and install extension updates.\\n\\n\\n\\n![Update extensions](img/podman-desktop-release-1.1/update-extensions.png)\\n\\n### Lima Support\\n\\nThanks to contributor [Anders Bj\xf6rklund](https://github.com/afbjorklund), we have some improvements to the\\nLima extension! In **Settings > Preferences** you can select which\\nengine type Lima runs on and override the instance name [#2674](https://github.com/containers/podman-desktop/pull/2674).\\n\\n![Lima preferences](https://user-images.githubusercontent.com/10364051/241755966-0a6a293b-b18e-4222-9c40-abd6c114d464.png)\\n\\n### Other UI and UX Improvements\\n\\n#### New Loading Screen\\n\\nWe have a new loading screen, Podman Desktop style! [#2743](https://github.com/containers/podman-desktop/pull/2743).\\n\\n\\n\\n---\\n\\n## Other Notable Enhancements\\n\\n- Docker-compose can be installed system-wide [#2718](https://github.com/containers/podman-desktop/pull/2718).\\n- Show warning when creating a pod with two containers that use the same port [#2671](https://github.com/containers/podman-desktop/pull/2671).\\n- Display Kubernetes context name in pod label [#2634](https://github.com/containers/podman-desktop/pull/2634).\\n- Add Docker compatibility button using flatpak-spawn [#1925](https://github.com/containers/podman-desktop/pull/1925).\\n- Improve UI consistency of Pull Image page [#2604](https://github.com/containers/podman-desktop/pull/2604).\\n\\n---\\n\\n## Notable Bug Fixes\\n\\n- Could not install extensions on Windows 10 [#2762](https://github.com/containers/podman-desktop/pull/2762).\\n- Could not use locally built images on Kubernetes [#2710](https://github.com/containers/podman-desktop/pull/2710).\\n- Dashboard still suggests update after installation [#2648](https://github.com/containers/podman-desktop/pull/2648).\\n- Could not Play Kubernetes YAML to Podman on Windows [#2594](https://github.com/containers/podman-desktop/pull/2594).\\n- Pod label wasn\'t always shown in list [#2614](https://github.com/containers/podman-desktop/pull/2614).\\n- Dashboard button state was resetting [#2584](https://github.com/containers/podman-desktop/pull/2584).\\n- Change checkbox style so they don\'t look like stop buttons [#2723](https://github.com/containers/podman-desktop/pull/2723).\\n\\n---\\n\\n## Community Thank You\\n\\n\ud83c\udf89 We\u2019d like to say a big thank you to everyone who helped to make Podman Desktop even better. In this\\nsprint we received pull requests from the following people:\\n\\n- [wangxiaolei](https://github.com/fatelei) in [#2602 - Add meaningful tooltips to build, pull, prune buttons](https://github.com/containers/podman-desktop/pull/2602)\\n- [AsciiWolf](https://github.com/AsciiWolf) in [#2607 - fix typing error in Flathub name](https://github.com/containers/podman-desktop/pull/2607) and [#2609 - fix Flatpak install instructions](https://github.com/containers/podman-desktop/pull/2609)\\n- [Anders Bj\xf6rklund](https://github.com/afbjorklund) in [#2674 - Select engine for Lima provider](https://github.com/containers/podman-desktop/pull/2674)\\n\\n---\\n\\n## Final notes\\n\\nThe complete list of issues fixed in this release is available [here](https://github.com/containers/podman-desktop/issues?q=is%3Aclosed+milestone%3A1.1.0) and [here](https://github.com/containers/podman-desktop/issues?q=is%3Aclosed+milestone%3A1.1.0).\\n\\nGet the latest release from the [Downloads](/downloads) section of the website and boost your development journey with Podman Desktop. Additionally, visit the [GitHub repository](https://github.com/containers/podman-desktop) and see how you can help us make Podman Desktop better."},{"id":"podman-desktop-release-1.0","metadata":{"permalink":"/blog/podman-desktop-release-1.0","source":"@site/blog/2023-05-17-release-1.0.md","title":"Release Notes - Podman Desktop 1.0","description":"Podman Desktop 1.0 has been released!","date":"2023-05-17T00:00:00.000Z","formattedDate":"May 17, 2023","tags":[{"label":"podman-desktop","permalink":"/blog/tags/podman-desktop"},{"label":"release","permalink":"/blog/tags/release"},{"label":"kubernetes","permalink":"/blog/tags/kubernetes"},{"label":"kind","permalink":"/blog/tags/kind"},{"label":"openshift","permalink":"/blog/tags/openshift"}],"readingTime":5,"hasTruncateMarker":true,"authors":[{"name":"Tim deBoer","title":"Architect","url":"https://github.com/deboer-tim","imageURL":"https://github.com/deboer-tim.png","key":"deboer"}],"frontMatter":{"title":"Release Notes - Podman Desktop 1.0","description":"Podman Desktop 1.0 has been released!","slug":"podman-desktop-release-1.0","authors":["deboer"],"tags":["podman-desktop","release","kubernetes","kind","openshift"],"hide_table_of_contents":false,"image":"/img/blog/podman-desktop-release-1.0.jpg"},"prevItem":{"title":"Release Notes - Podman Desktop 1.1","permalink":"/blog/podman-desktop-release-1.1"},"nextItem":{"title":"Release Notes - Podman Desktop 0.15","permalink":"/blog/podman-desktop-release-0.15"}},"content":"import ReactPlayer from \'react-player\'\\n\\nPodman Desktop 1.0 Release! \ud83c\udf89\\n\\nWe still have many things planned, but with a little polish and a few more bug fixes we\\nfelt we\'ve reached a level of maturity and it is now time to declare our 1.0 release.\\n\\nThank you to everyone who has been with us on this journey so far! Please keep the\\nfeedback coming!\\n\\n\x3c!--Main Features--\x3e\\n\\n- **Highlighting Featured Extensions**: Easily find and install new extensions.\\n- **Featured Extensions**: Two new extensions supporting OpenShift.\\n- **Podman Machine as Root**: Ability to run a Podman machine as root.\\n- **UX and UI Improvements**: Opening external websites, editing numbers, and tooltips.\\n\\nPodman Desktop 1.0 is now available. [Click here to download it](/downloads)!\\n\\n![Podman-desktop-1-0-hero](img/podman-desktop-release-1.0/podman-desktop-release-1.0.jpg)\\n\\n\x3c!--truncate--\x3e\\n\\n---\\n\\n## Release Details\\n\\n### Highlighting Featured Extensions\\n\\nA critical part of our vision for Podman Deskop is the ability to install extensions to\\nsupport additional container engines, Kubernetes providers, or other tools. However, it\\nhas not been easy to discover new extensions.\\n\\nWith 1.0 we show a list of featured extensions in the **Welcome**\\n[#2354](https://github.com/containers/podman-desktop/pull/2354), the **Dashboard** and in\\n** Settings > Extensions**\\n[#2355](https://github.com/containers/podman-desktop/pull/2355). Check out the new\\nextensions for **Red Hat OpenShift Local** and the **Developer Sandbox for Red Hat OpenShift**!\\n\\n![Featured extensions](img/podman-desktop-release-1.0/featured-extensions.png)\\n\\n### Featured Extensions\\n\\nSpeaking of extensions, let\'s take a minute to turn the spotlight on these two!\\n\\nHave another idea for extending Podman Desktop? We would love to hear from you or see\\nwhat you can create with the [Extension documentation](../docs/extensions),\\nand feature your extension here.\\n\\n#### Red Hat OpenShift Local\\n\\nOpenShift Local is a fully-featured single-node OpenShift cluster designed to run on your local computer.\\nWith this extension you can install, start/stop, and deploy pods or YAML to OpenShift Local,\\nallowing you to test your applications on a full OpenShift environment, ensuring a consistent\\nexperience between development, test, and production.\\n\\nThe recent addition of the MicroShift preset provides a lighter, optimized option that\\nstarts faster and uses less resources for deployments that still want OpenShift compatibility\\nwithout the full set of OpenShift services.\\n\\n![OpenShift Local](img/podman-desktop-release-1.0/openshift-local.png)\\n\\n#### Developer Sandbox for Red Hat OpenShift\\n\\nThe OpenShift Developer Sandbox is a free, cloud-based OpenShift environment that allows developers to\\ncreate, build, and deploy applications to OpenShift for 30 days. With this extension you can sign up\\nand easily deploy pods or YAML to a hosted OpenShift environment without a local installation or\\nleaving Podman Desktop.\\n\\n![Developer Sandbox](img/podman-desktop-release-1.0/sandbox.png)\\n\\n### Podman Machine as Root\\n\\nWhen creating a Podman machine you can now decide to run as root [#2427](https://github.com/containers/podman-desktop/pull/2427). This is a prerequisite for some scenarios, such as running Kind on Windows.\\n\\n![Podman machine as root](img/podman-desktop-release-1.0/podman-root.png)\\n\\n### Other UI and UX Improvements\\n\\n#### Prompt to Open External Website\\n\\nIn the previous release links to external websites were blocked due to the security risk.\\nIn 1.0 you can click to see the URL and have the option of opening or copying it\\n[#2414](https://github.com/containers/podman-desktop/pull/2414).\\n\\n![External link dialog](img/podman-desktop-release-1.0/external-link.png)\\n\\n#### Editable Numeric Preferences\\n\\nTired of clicking +, +, +? Us too. Numeric preferences are now editable so\\nyou can directly enter the value you want\\n[#2368](https://github.com/containers/podman-desktop/pull/2368).\\n\\n![Editing numbers](img/podman-desktop-release-1.0/edit-number.png)\\n\\n#### Navigation tooltips\\n\\nWe like our new navigation bar, but the tooltips were slow to appear. This made it harder for new\\nusers to discover the pages and for power users to see the container/pod/image counts. The\\ntooltips are now a little nicer and appear immediately\\n[#2286](https://github.com/containers/podman-desktop/pull/2286).\\n\\n![Navigation tooltips](img/podman-desktop-release-1.0/nav-tooltips.png)\\n\\n---\\n\\n## Other Notable Enhancements\\n\\n- If you use a non-default Podman machine you are now prompted to make it the default, so\\n that command line tools will use the same machine [#2205](https://github.com/containers/podman-desktop/pull/2205).\\n\\n- Extensions can now be installed without requiring a running local container engine\\n [#2273](https://github.com/containers/podman-desktop/pull/2273).\\n\\n- When extensions fail to load there is a new state (failed!) and an error message\\n to help you fix or report the problem [#2424](https://github.com/containers/podman-desktop/pull/2424).\\n\\n- The showInputBox API has support for Markdown [#2418](https://github.com/containers/podman-desktop/pull/2418).\\n\\n---\\n\\n## Notable Bug Fixes\\n\\n- Fixed shared status when using multiple Podman 4.5 machines [#2441](https://github.com/containers/podman-desktop/pull/2441).\\n- Fixed hang on exit when telemetry is unreachable [#2431](https://github.com/containers/podman-desktop/pull/2431).\\n- Reduced initial Podman REST API calls to improve performance [#2419](https://github.com/containers/podman-desktop/pull/2419).\\n- **Play Kubernetes YAML** now honors the namespace [#2509](https://github.com/containers/podman-desktop/pull/2509).\\n- **Container** list was not remembering expand/collapsed status [#2491](https://github.com/containers/podman-desktop/pull/2491).\\n- Clear previous error when installing Docker extension [#2469](https://github.com/containers/podman-desktop/pull/2469).\\n- Ensure correct path with running Kind CLI [#2455](https://github.com/containers/podman-desktop/pull/2455).\\n- Use IPv4 over IPv6 by default [#2398](https://github.com/containers/podman-desktop/pull/2398).\\n- When changing the Kubernetes pod name, change the app name to match [#2389](https://github.com/containers/podman-desktop/pull/2389).\\n- Fixed incorrect pod status in **Containers** view [#2387](https://github.com/containers/podman-desktop/pull/2387).\\n- **Dashboard** wasn\'t correctly refreshing Podman status [#2359](https://github.com/containers/podman-desktop/pull/2359).\\n\\n---\\n\\n## Community Thank You\\n\\n\ud83c\udf89 We\u2019d like to say a big thank you to everyone who helped to make Podman Desktop even better. In this final\\nsprint we received pull requests from the following people:\\n\\n- [Taha Attari](https://github.com/TahaAttari) in [#2470 - Update docker command in importing-saved-containers.md](https://github.com/containers/podman-desktop/pull/2470)\\n- [Jason Greene](https://github.com/n1hility) in [#2431 - Fix hang on exit when telemetry endpoint is unreachable](https://github.com/containers/podman-desktop/pull/2431)\\n- [Anders Bj\xf6rklund](https://github.com/afbjorklund) in [#2571 - Fix the location of the lima podman socket](https://github.com/containers/podman-desktop/pull/2571) and [#2572 - Fix the state of the lima container provider](https://github.com/containers/podman-desktop/pull/2572)\\n- [Tucker Chapman](https://github.com/tuckerrc) in [#2567 - Add example image name in placeholder](https://github.com/containers/podman-desktop/pull/2567)\\n\\nThere are now a total of 54 people (and two bots!) who have contributed PRs to Podman Desktop, and we\'d\\nlike to extend an extra thanks to all of those outside of the immediate development team who contributed\\nto get us here:\\n\\n[afbjorklund](https://github.com/afbjorklund),\\n[alv67](https://github.com/alv67),\\n[anjannath](https://github.com/anjannath),\\n[ankanroy-code](https://github.com/ankanroy-code),\\n[arixmkii](https://github.com/arixmkii),\\n[cblecker](https://github.com/cblecker),\\n[cfergeau](https://github.com/cfergeau),\\n[chevdor](https://github.com/chevdor),\\n[chrisjsimpson](https://github.com/chrisjsimpson),\\n[cu8code](https://github.com/cu8code),\\n[doehyunbaek](https://github.com/doehyunbaek),\\n[dylanmtaylor](https://github.com/dylanmtaylor),\\n[eidottermihi](https://github.com/eidottermihi),\\n[elervik](https://github.com/elervik),\\n[emmanuelbernard](https://github.com/emmanuelbernard),\\n[evanfpearson](https://github.com/evanfpearson),\\n[gorkem](https://github.com/gorkem),\\n[idjohnson](https://github.com/idjohnson),\\n[imphil](https://github.com/imphil),\\n[iongion](https://github.com/iongion),\\n[jlosito](https://github.com/jlosito),\\n[KevinAtSesam](https://github.com/KevinAtSesam),\\n[lsm5](https://github.com/lsm5),\\n[Mitch9378](https://github.com/Mitch9378),\\n[n1hility](https://github.com/n1hility),\\n[osslate](https://github.com/osslate),\\n[PatentLobster](https://github.com/PatentLobster),\\n[pwright](https://github.com/pwright),\\n[rdwz](https://github.com/rdwz),\\n[redhatrises](https://github.com/redhatrises),\\n[rhatdan](https://github.com/rhatdan),\\n[RobotSail](https://github.com/RobotSail),\\n[rohit-rambade](https://github.com/rohit-rambade),\\n[rsvoboda](https://github.com/rsvoboda),\\n[sfrunza13](https://github.com/sfrunza13),\\n[shemanaev](https://github.com/shemanaev),\\n[sstosh](https://github.com/sstosh),\\n[stickster](https://github.com/stickster),\\n[TahaAttari](https://github.com/TahaAttari),\\n[ths83](https://github.com/ths83),\\n[Tony-Sol](https://github.com/Tony-Sol),\\n[tuckerrc](https://github.com/tuckerrc),\\n[ucomesdag](https://github.com/ucomesdag),\\n[xbabalov](https://github.com/xbabalov),\\n[zezo2019](https://github.com/zezo2019).\\n\\n---\\n\\n## Final notes\\n\\nThe complete list of issues fixed in this release is available [here](https://github.com/containers/podman-desktop/issues?q=is%3Aclosed+milestone%3A1.0.0) and [here](https://github.com/containers/podman-desktop/issues?q=is%3Aclosed+milestone%3A1.0.1).\\n\\nGet the latest release from the [Downloads](/downloads) section of the website and boost your development journey with Podman Desktop. Additionally, visit the [GitHub repository](https://github.com/containers/podman-desktop) and see how you can help us make Podman Desktop better."},{"id":"podman-desktop-release-0.15","metadata":{"permalink":"/blog/podman-desktop-release-0.15","source":"@site/blog/2023-05-02-release-0.15.md","title":"Release Notes - Podman Desktop 0.15","description":"Podman Desktop 0.15 has been released!","date":"2023-05-02T00:00:00.000Z","formattedDate":"May 2, 2023","tags":[{"label":"podman-desktop","permalink":"/blog/tags/podman-desktop"},{"label":"release","permalink":"/blog/tags/release"},{"label":"kubernetes","permalink":"/blog/tags/kubernetes"},{"label":"kind","permalink":"/blog/tags/kind"}],"readingTime":3.685,"hasTruncateMarker":true,"authors":[{"name":"Tim deBoer","title":"Architect","url":"https://github.com/deboer-tim","imageURL":"https://github.com/deboer-tim.png","key":"deboer"}],"frontMatter":{"title":"Release Notes - Podman Desktop 0.15","description":"Podman Desktop 0.15 has been released!","slug":"podman-desktop-release-0.15","authors":["deboer"],"tags":["podman-desktop","release","kubernetes","kind"],"hide_table_of_contents":false,"image":"/img/blog/podman-desktop-release-0.15.webp"},"prevItem":{"title":"Release Notes - Podman Desktop 1.0","permalink":"/blog/podman-desktop-release-1.0"},"nextItem":{"title":"Setting up and running a Kubernetes cluster locally with Podman Desktop","permalink":"/blog/running-a-local-kubernetes-cluster-with-podman-desktop"}},"content":"import ReactPlayer from \'react-player\'\\n\\nPodman Desktop 0.15 - Cleanliness is next to Podliness!\\n\\nIt has only been two weeks since our last release, but we really wanted to complete a few scenarios,\\nfix a few bugs, and show off several design updates and UI improvements that we have been working on.\\n\\n\x3c!--Main Features--\x3e\\n\\n- **Podman Version**: Podman 4.5 now included in Windows and Mac installers.\\n- **Kind Ingress**: Creating an ingress to expose services outside the Kind cluster.\\n- **Podliness**: Ability to choose external ports when podifying containers.\\n- **Cleanliness**: New navigation bar, dialog, and palette update.\\n- **UX and UI Improvements**: Markdown support for extensions.\\n\\nPodman Desktop 0.15 is now available. [Click here to download it](/downloads)!\\n\\n![Podman-desktop-0-15-hero](img/podman-desktop-release-0.15/podman-desktop-release-0.15.webp)\\n\\n\x3c!--truncate--\x3e\\n\\n---\\n\\n## Release Details\\n\\n### Update to Podman v4.5\\n\\nPodman Desktop 0.15 embeds [Podman 4.5](https://github.com/containers/podman/releases/tag/v4.5) in\\nWindows and macOS installers [#2115](https://github.com/containers/podman-desktop/issues/2115).\\n\\n### Kind Ingress\\n\\nWait a minute, didn\'t we enable this last release? Well yes, last time we did add support for installing\\nthe Contour ingress controller on Kind [#1675](https://github.com/containers/podman-desktop/issues/1675),\\nbut you still couldn\'t access your containers without the corresponding ingress.\\n\\nThis release adds a simple checkbox you can use when deploying to Kind to create an ingress and\\nmake your service accessible [#1322](https://github.com/containers/podman-desktop/issues/1322).\\n\\n\\n\\n### Podliness: Ability to Choose External Ports when Podifying Containers\\n\\nWhen you create a pod from of a set of containers (Podifying!), you probably don\'t want to expose every\\nsingle port from every container to the world. With an updated panel you can now see which ports each container\\nexposes, pick which should remain visible outside the pod, and which are for internal use\\n[#2232](https://github.com/containers/podman-desktop/pull/2232).\\n\\n![Podify page](https://user-images.githubusercontent.com/49404737/234527674-ed14f52c-8f66-445f-8038-c8135bb61136.gif)\\n\\n### Cleanliness: New Navigation Bar, Dialogs, and Palette\\n\\nIt was time to catch up on some design ideas and do some UI cleanup!\\n\\n#### New Navgation Bar\\n\\nThe navigation bar is now always fixed on the left size, without labels. This opens up more space\\nfor the content on each page, and is easier to jump in and out of ** Settings**.\\n[#2167](https://github.com/containers/podman-desktop/issues/2167)\\n\\n![Navigation bar](img/podman-desktop-release-0.15/navigation.png)\\n\\n#### Updated Dialogs\\n\\nWe wanted messages and dialog boxes to feel a bit more integrated, so we have a new message box\\n[#1808](https://github.com/containers/podman-desktop/pull/1808) and use it for all dialogs opened by\\nextensions, pruning containers/pods/images/volumes [#2138](https://github.com/containers/podman-desktop/pull/2138),\\nand updating Podman Desktop itself [#2249](https://github.com/containers/podman-desktop/pull/2249).\\n\\n![Dialog](img/podman-desktop-release-0.15/dialog.png)\\n\\n#### Colors\\n\\nWe spent some time tweaking colors and closing on our final palette\\n[#2199](https://github.com/containers/podman-desktop/pull/2199), updating the colors in the terminal & detail page\\n[#2222](https://github.com/containers/podman-desktop/pull/2222), tweaking the navigation and main page colors\\n[#2223](https://github.com/containers/podman-desktop/pull/2223),\\nand improving the look of forms [#2156](https://github.com/containers/podman-desktop/issues/2156).\\n\\nWe\'re not done yet, but hopefully you will notice a more polished, consistent, good-looking application!\\n\\n### Other UI and UX Improvements\\n\\n#### Markdown Support for Extensions\\n\\nWe added a new component to display markdown [#2219](https://github.com/containers/podman-desktop/pull/2219) and\\nenabled it in preferences [#2253](https://github.com/containers/podman-desktop/pull/2253), and\\nprovider properties/creation pages [#2152](https://github.com/containers/podman-desktop/issues/2152).\\nWe can now embed links and other formatting in preferences, and extensions can use them in many places, for example:\\n\\n![Markdown](img/podman-desktop-release-0.15/markdown.png)\\n\\n---\\n\\n## Other Notable Enhancements\\n\\n- We know which **Settings** page is used the most often, so now it\'s the default: ** Settings > Resources** [#2105](https://github.com/containers/podman-desktop/issues/2105).\\n\\n- Extensions can now use the Tasks API to let long running tasks continue in the background [#2019](https://github.com/containers/podman-desktop/issues/2019) and the existing withProgress API also uses the task manager now\\n [#2187](https://github.com/containers/podman-desktop/pull/2187).\\n\\n![Task API](https://user-images.githubusercontent.com/695993/233560830-85cfa685-5dcd-4efa-9fae-730a8a9eef3b.gif)\\n\\n- Images are now sorted by age [#2311](https://github.com/containers/podman-desktop/pull/2311).\\n\\n- When you start/stop a container or pod, the button is now animated instead of having an separate spinner\\n [#2101](https://github.com/containers/podman-desktop/issues/2101).\\n\\n- The ** Settings > Preferences** page now has a search bar [#2128](https://github.com/containers/podman-desktop/pull/2128).\\n\\n![Search preferences](img/podman-desktop-release-0.15/prefs.png)\\n\\n- The Help page has been updated [#431](https://github.com/containers/podman-desktop/issues/431).\\n\\n![Updated Help](img/podman-desktop-release-0.15/help.png)\\n\\n---\\n\\n## Notable Bug Fixes\\n\\n- There was no way to see log or outcome if you leave the Kind cluster creation page [#2079](https://github.com/containers/podman-desktop/issues/2079).\\n- Kind image load doesn\'t show a notification [#2225](https://github.com/containers/podman-desktop/issues/2225).\\n- Fix odd selection in ** Settings > Extensions** [#2130](https://github.com/containers/podman-desktop/issues/2130).\\n- Menus are now cleaned up properly when extensions are stopped [#2188](https://github.com/containers/podman-desktop/pull/2188).\\n- Kind clusters are now cleaned up when Podman machine is stopped [#2306](https://github.com/containers/podman-desktop/pull/2306).\\n\\n---\\n\\n## Final notes\\n\\nThe complete list of issues fixed in this release is available [here](https://github.com/containers/podman-desktop/issues?q=is%3Aclosed+milestone%3A0.15.0).\\n\\nGet the latest release from the [Downloads](/downloads) section of the website and boost your development journey with Podman Desktop. Additionally, visit the [GitHub repository](https://github.com/containers/podman-desktop) and see how you can help us make Podman Desktop better."},{"id":"running-a-local-kubernetes-cluster-with-podman-desktop","metadata":{"permalink":"/blog/running-a-local-kubernetes-cluster-with-podman-desktop","source":"@site/blog/2023-04-19-running-a-local-kubernetes-cluster-with-podman-desktop.md","title":"Setting up and running a Kubernetes cluster locally with Podman Desktop","description":"Setting up and running a Kubernetes cluster locally with Podman Desktop","date":"2023-04-19T00:00:00.000Z","formattedDate":"April 19, 2023","tags":[{"label":"podman-desktop","permalink":"/blog/tags/podman-desktop"},{"label":"story","permalink":"/blog/tags/story"},{"label":"kubernetes","permalink":"/blog/tags/kubernetes"},{"label":"kind","permalink":"/blog/tags/kind"}],"readingTime":8.86,"hasTruncateMarker":true,"authors":[{"name":"Fabrice Flore-Thebault","title":"Technical writer","url":"https://github.com/themr0c","imageURL":"https://github.com/themr0c.png","key":"themr0c"}],"frontMatter":{"title":"Setting up and running a Kubernetes cluster locally with Podman Desktop","description":"Setting up and running a Kubernetes cluster locally with Podman Desktop","slug":"running-a-local-kubernetes-cluster-with-podman-desktop","authors":["themr0c"],"tags":["podman-desktop","story","kubernetes","kind"],"hide_table_of_contents":false},"prevItem":{"title":"Release Notes - Podman Desktop 0.15","permalink":"/blog/podman-desktop-release-0.15"},"nextItem":{"title":"Release Notes - Podman Desktop 0.14","permalink":"/blog/podman-desktop-release-0.14"}},"content":"In this blog post you will learn to use Podman Desktop to run the [Kubernetes documentation example: Deploying PHP Guestbook application with Redis](https://kubernetes.io/docs/tutorials/stateless-application/guestbook/).\\n\\nOn the agenda:\\n\\n1. Installing Podman Desktop.\\n1. Installing and initializing your container engine: Podman.\\n1. Installing and starting your local Kubernetes provider: Kind.\\n1. Starting the Redis leader.\\n1. Starting and scaling the Redis followers.\\n1. Starting and exposing the Guestbook frontend.\\n\\n\x3c!--truncate--\x3e\\n\\n## Installing Podman Desktop\\n\\nYou need Podman Desktop.\\n\\n1. Go to [Podman Desktop installation documentation](/docs/Installation).\\n1. Click on your platform name: [Windows](/docs/installation/windows-install), [macOS](/docs/installation/macos-install), or [Linux](/docs/installation/linux-install).\\n1. Follow the instructions. Stick to the default installation method.\\n1. Start **Podman Desktop**.\\n\\nAt this point, you have a graphical user interface to:\\n\\n- Install Podman and Kind.\\n- Control and work with your container engines and Kubernetes clusters.\\n- Run your application on your container engine and migrate it to Kubernetes.\\n\\n## Installing and initializing your container engine: Podman\\n\\nPodman Desktop can control various container engines, such as:\\n\\n- Docker\\n- Lima\\n- Podman\\n\\nConsider installing the Podman container engine for:\\n\\n- Added security\\n- No daemon\\n- Open source\\n\\nContainers are a Linux technology.\\n\\n- On Linux, you can install Podman natively.\\n See: [Installing Podman on Linux](https://podman.io/docs/installation#installing-on-linux).\\n- On macOS and Windows, Podman requires to run in a Linux virtual machine: the Podman machine.\\n Use Podman Desktop to install Podman and initialize your Podman machine:\\n\\n#### Procedure\\n\\n1. Open Podman Desktop **Dashboard**\\n1. The **Dashboard** displays _Podman Desktop was not able to find an installation of Podman_.\\n1. Click on **Install**.\\n1. Podman Desktop checks the prerequisites to install Podman Engine. When necessary, follow the instructions to install prerequisites.\\n1. Podman displays the dialog: _Podman is not installed on this system, would you like to install Podman?_. Click on **Yes** to install Podman.\\n1. Click on **Initialize and start**.\\n\\n#### Verification\\n\\n- The **Dashboard** displays _Podman is running_.\\n\\n ![Podman is running](img/running-a-local-kubernetes-cluster-with-podman-desktop/podman-is-running.png)\\n\\nAt this point, you can start working with containers.\\n\\n## Installing and starting your local Kubernetes provider: Kind\\n\\nYou want to deploy your application to a local Kubernetes cluster.\\n\\nPodman Desktop can help you run Kind-powered local Kubernetes clusters on a container engine, such as Podman.\\n\\nPodman Desktop helps you [installing the `kind` CLI](/docs/kubernetes/kind/installing-kind):\\n\\n1. In the status bar, click on **Kind**, and follow the prompts.\\n1. When the `kind` CLI is available, the status bar does not display **Kind**.\\n1. On Windows, [configure Podman in rootful mode](/docs/kubernetes/kind/configuring-podman-for-kind-on-windows)\\n\\n ```shell-session\\n $ podman system connection default podman-machine-default-root\\n ```\\n\\n1. Go to ** Settings > Resources**\\n1. In the **\\"Podman Podman** tile, click on the **** icon to restart the Podman container engine.\\n1. In the **\\"Kind Kind** tile, click on the **Create new** button.\\n 1. **Name**: enter `kind-cluster`.\\n 1. **Provider Type**: select `podman`.\\n 1. **HTTP Port**: select `9090`.\\n 1. **HTTPS Port**: select `9443`.\\n 1. **Setup an ingress controller**: `Enabled`\\n 1. Click the **Create** button.\\n ![Create a Kind cluster screen](img/running-a-local-kubernetes-cluster-with-podman-desktop/create-a-kind-cluster.png)\\n1. After successful creation, click on the **Go back to resources** button\\n\\n#### Verification\\n\\n1. In ** Settings > Resources** your Kind cluster is running/\\n\\n ![Kind cluster is running](img/running-a-local-kubernetes-cluster-with-podman-desktop/kind-cluster-is-running.png)\\n\\n1. In the **Podman Desktop** tray, open the **Kubernetes** menu: you can set the context to your Kind cluster: `kind-kind-cluster`.\\n\\n ![Kind cluster Kubernetes context in the tray](img/running-a-local-kubernetes-cluster-with-podman-desktop/kind-cluster-context-in-the-tray.png)\\n\\n At this point, you can start working with containers, and your local Kubernetes cluster.\\n\\n#### Additional resources\\n\\n- [Creating a local Kind-powered Kubernetes cluster](/docs/kubernetes/kind/creating-a-kind-cluster)\\n\\n## Starting the Redis leader\\n\\nThe Guestbook application uses Redis to store its data.\\n\\nWith Podman Desktop, you can prepare the Redis leader image and container on your local container engine, and deploy the results to a Kubernetes pod and service.\\nThis is functionally equal to the `redis-leader` deployment that the Kubernetes example propose.\\n\\n#### Procedure\\n\\n1. Open ** Images > Pull an image**.\\n 1. **Image to Pull**: enter `docker.io/redis:6.0.5`\\n 1. Click **Pull image** to pull the image to your container engine local image registry.\\n 1. Click **Done** to get back to the images list.\\n1. ** Search images**: enter `redis:6.0.5` to find the image.\\n1. Click **** to open the **Create a container from image** dialog.\\n 1. **Container name**: enter `leader`,\\n 1. **Local port for `6379/tcp`**: `6379`.\\n 1. Click ** Start Container** to start the container in your container engine.\\n1. ** Search containers**: enter `leader` to find the running container.\\n1. Click **** to stop the container, and leave the `6379` port available for the Redis follower container.\\n\\n1. Click ** > Deploy to Kubernetes** to open the **Deploy generated pod to Kubernetes** screen.\\n\\n 1. **Pod Name**: enter `redis-leader`.\\n 1. **Use Kubernetes Services**: select **Replace `hostPort` exposure on containers by Services. It is the recommended way to expose ports, as a cluster policy might prevent to use `hostPort`.**\\n 1. **Expose service locally using Kubernetes Ingress**: deselect **Create a Kubernetes ingress to get access to the ports that this pod exposes, at the default ingress controller location. Example: on a default Kind cluster created with Podman Desktop: `http://localhost:9090`. Requirements: your cluster has an ingress controller`**.\\n 1. **Kubernetes namespaces**: select `default`.\\n 1. Click ** Deploy**.\\n ![Deploy generated leader pod to Kubernetes screen](img/running-a-local-kubernetes-cluster-with-podman-desktop/deploy-generated-leader-pod-to-kubernetes.png)\\n 1. Wait for the pod to reach the state: **Phase: Running**.\\n 1. Click **Done**.\\n\\n#### Verification\\n\\n- The ** Pods** screen lists the running `redis-leader` pod.\\n\\n ![leader pod is running](img/running-a-local-kubernetes-cluster-with-podman-desktop/leader-pod-is-running.png)\\n\\n## Starting the Redis followers\\n\\nAlthough the Redis leader is a single Pod, you can make it highly available and meet traffic demands by adding a few Redis followers, or replicas.\\n\\n**With Podman Desktop, you can prepare the Redis follower image and container on your local container engine, and deploy the results to Kubernetes pods and services.**\\nThis is functionally equal to the `redis-follower` deployment that the Kubernetes example propose.\\n\\n#### Procedure\\n\\n1. Open ** Images > Pull an image**.\\n 1. **Image to Pull**: enter `gcr.io/google_samples/gb-redis-follower:v2`\\n 1. Click **Pull image** to pull the image to your container engine local image registry.\\n 1. Click **Done** to get back to the images list.\\n1. ** Search images**: enter `gb-redis-follower:v2` to find the image.\\n1. Click **** to open the **Create a container from image** dialog.\\n 1. **Container name**: enter `follower`,\\n 1. **Local port for `6379/tcp`**: `6379`.\\n 1. Click ** Start Container** to start the container in your container engine.\\n1. ** Search containers**: enter `follower` to find the running container.\\n1. Click **** to stop the container: you do not need it to run in the container engine.\\n1. Click ** > Deploy to Kubernetes** to open the **Deploy generated pod to Kubernetes** screen.\\n 1. **Pod Name**: enter `redis-follower`.\\n 1. **Use Kubernetes Services**: select **Replace `hostPort` exposure on containers by Services. It is the recommended way to expose ports, as a cluster policy might prevent to use `hostPort`.**\\n 1. **Expose service locally using Kubernetes Ingress**: deselect **Create a Kubernetes ingress to get access to the ports that this pod exposes, at the default ingress controller location. Example: on a default Kind cluster created with Podman Desktop: `http://localhost:9090`. Requirements: your cluster has an ingress controller`**.\\n 1. **Kubernetes namespaces**: select `default`.\\n 1. Click ** Deploy**.\\n ![Deploy generated follower pod to Kubernetes screen](img/running-a-local-kubernetes-cluster-with-podman-desktop/deploy-generated-follower-pod-to-kubernetes.png)\\n 1. Wait for the pod to reach the state: **Phase: Running**.\\n 1. Click **Done**.\\n1. To add replicas, repeat the last step with another **Pod Name** value.\\n\\n#### Verification\\n\\n- The ** Pods** screen lists the running `redis-follower` pods.\\n\\n ![follower pods are running](img/running-a-local-kubernetes-cluster-with-podman-desktop/follower-pods-are-running.png)\\n\\n## Starting the default frontend\\n\\nNow that you have the Redis storage of your Guestbook up and running, start the Guestbook web servers.\\nLike the Redis followers, deploy the frontend using Kubernetes pods and services.\\n\\nThe Guestbook app uses a PHP frontend.\\nIt is configured to communicate with either the Redis follower or leader Services, depending on whether the request is a read or a write.\\nThe frontend exposes a JSON interface, and serves a jQuery-Ajax-based UX.\\n\\nWith Podman Desktop, you can prepare the Guestbook frontend image and container on your local container engine, and deploy the results to Kubernetes pods and services.\\nThis is functionally equal to the `frontend` deployment that the Kubernetes example propose.\\n\\n#### Procedure\\n\\n1. Open ** Images > Pull an image**.\\n 1. **Image to Pull**: enter `gcr.io/google_samples/gb-frontend:v5`\\n 1. Click **Pull image** to pull the image to your container engine local image registry.\\n 1. Wait for the pull to complete.\\n 1. Click **Done** to get back to the images list.\\n1. ** Search images**: enter `gb-frontend:v5` to find the image.\\n1. Click **** to open the **Create a container from image** dialog.\\n 1. **Container name**: enter `frontend`,\\n 1. **Local port for `80/tcp`**: `9000`.\\n 1. Click ** Start Container** to start the container in your container engine.\\n1. ** Search containers**: enter `frontend` to find the running container.\\n1. Click **** to stop the container: you do not need it to run in the container engine.\\n1. Click ** > Deploy to Kubernetes** to open the **Deploy generated pod to Kubernetes** screen.\\n 1. **Pod Name**: enter `frontend`.\\n 1. **Use Kubernetes Services**: select **Replace `hostPort` exposure on containers by Services. It is the recommended way to expose ports, as a cluster policy might prevent to use `hostPort`.**\\n 1. **Expose service locally using Kubernetes Ingress**: select **Create a Kubernetes ingress to get access to the ports that this pod exposes, at the default ingress controller location. Example: on a default Kind cluster created with Podman Desktop: `http://localhost:9090`. Requirements: your cluster has an ingress controller`**.\\n 1. **Kubernetes namespaces**: select `default`.\\n 1. Click ** Deploy**.\\n ![Deploy generated frontend pod to Kubernetes screen](img/running-a-local-kubernetes-cluster-with-podman-desktop/deploy-generated-frontend-pod-to-kubernetes.png)\\n 1. Wait for the pod to reach the state: **Phase: Running**.\\n 1. Click **Done**.\\n\\n#### Verification\\n\\n1. The ** Pods** screen lists the running `frontend` pod.\\n\\n ![`frontend` pod is running](img/running-a-local-kubernetes-cluster-with-podman-desktop/frontend-pod-is-running.png)\\n\\n1. Go to `http://localhost:9090`: the Guestbook application is running."},{"id":"podman-desktop-release-0.14","metadata":{"permalink":"/blog/podman-desktop-release-0.14","source":"@site/blog/2023-04-14-release-0.14.md","title":"Release Notes - Podman Desktop 0.14","description":"Podman Desktop 0.14 has been released!","date":"2023-04-14T00:00:00.000Z","formattedDate":"April 14, 2023","tags":[{"label":"podman-desktop","permalink":"/blog/tags/podman-desktop"},{"label":"release","permalink":"/blog/tags/release"},{"label":"kubernetes","permalink":"/blog/tags/kubernetes"},{"label":"kind","permalink":"/blog/tags/kind"}],"readingTime":4.025,"hasTruncateMarker":true,"authors":[{"name":"Tim deBoer","title":"Architect","url":"https://github.com/deboer-tim","imageURL":"https://github.com/deboer-tim.png","key":"deboer"}],"frontMatter":{"title":"Release Notes - Podman Desktop 0.14","description":"Podman Desktop 0.14 has been released!","slug":"podman-desktop-release-0.14","authors":["deboer"],"tags":["podman-desktop","release","kubernetes","kind"],"hide_table_of_contents":false},"prevItem":{"title":"Setting up and running a Kubernetes cluster locally with Podman Desktop","permalink":"/blog/running-a-local-kubernetes-cluster-with-podman-desktop"},"nextItem":{"title":"Release Notes - Podman Desktop 0.13","permalink":"/blog/podman-desktop-release-0.13"}},"content":"import ReactPlayer from \'react-player\'\\n\\nPodman Desktop 0.14 - Our Kind-est release yet!\\n\\nWe have been working on a Kind extension for a while now, and decided it is time to promote it\\ninto a release just in time for KubeCon and CloudNativeCon Europe!\\n\\nWe\'re especially excited about releasing Kind because it finally shows the full purpose\\nof Podman Desktop: not just local container engines, but Kubernetes too. More importantly,\\nproviding tools that allow you to manage both environments and seamlessly move between them.\\n\\nSome of these features were available in development mode over the last few releases,\\nbut since they are now in the release build, we will do a full roundup and talk about\\nall the Kind features.\\n\\n\x3c!--Main Features--\x3e\\n\\n- **Kind Installation**: Install Kind from the status bar\\n- **Manage Kind Clusters**: Create and manage Kind clusters from ** Settings > Resources**\\n- **Using Kind**: Deploying YAML and sharing images to a cluster\\n- **Kind Ingress**: Install a Contour ingress controller\\n- **UX and UI Improvements**: Updated preferences and telemetry prompt\\n\\nPodman Desktop 0.14 is now available. [Click here to download it](/downloads)!\\n\\n![Podman-desktop-0-14-hero](img/podman-desktop-release-0.14/podman-desktop-release-0.14.png)\\n\\n\x3c!--truncate--\x3e\\n\\n---\\n\\n## Release details\\n\\n### Kind Installation\\n\\nGet Kind up and running in seconds! The Kind extension is now bundled as part of Podman Desktop\\n[1421](https://github.com/containers/podman-desktop/issues/1421)\\nand allows you to easily [install Kind directly from the status bar](/docs/kubernetes/kind/installing-kind)\\n[1257](https://github.com/containers/podman-desktop/issues/1257).\\n\\nThe installed `kind` CLI is available from the system shell [1516](https://github.com/containers/podman-desktop/issues/1516),\\nallowing you to open a terminal window to `kind get clusters` or work with other tools.\\n\\n### Manage Kind Clusters\\n\\nOnce Kind is installed (or if you already had it), you can manage your clusters in ** Settings > Resources**.\\nFrom here you can [create Kind clusters](/docs/kubernetes/kind/creating-a-kind-cluster),\\nstart/stop [1953](https://github.com/containers/podman-desktop/issues/1953)\\nor delete [1977](https://github.com/containers/podman-desktop/issues/1977) them.\\n\\n![kind-clusters](img/podman-desktop-release-0.14/kind-clusters.png)\\n\\nThe Kind control plane runs as a container. You will see this container\\nin the **Container** list and can also start or stop it from there.\\n\\n### Using Kind\\n\\nNow that you have Kind installed and running, what can you do with it?\\nIf you like terminals, you can always open one up and use the Kind CLI to\\n[interact with your cluster](https://kind.sigs.k8s.io/docs/user/quick-start/#interacting-with-your-cluster).\\n\\nWithin Podman Desktop we have started with two ways to interact with the cluster.\\nThe first is the ability to play local YAML files on your Kind (or any other Kubernetes!) cluster [1261](https://github.com/containers/podman-desktop/issues/1261). This allows you to take existing Kubernetes YAML definitons -\\nyour deployments, services, or other objects - and deploy it to the cluster.\\n\\n\\n\\nAs you deploy pods, they will automatically appear in the list of **Pods** [1263](https://github.com/containers/podman-desktop/issues/1263), allowing you to start, stop, and interact them just like pods running on Podman.\\n\\nOne of the most common uses is to deploy a container that you have been running on Podman, and this will fail\\nif the image is not available in Kind. To solve this we have made it easy to push images from\\nPodman to Kind [1448](https://github.com/containers/podman-desktop/issues/1448).\\n\\n![push-image-kind](img/podman-desktop-release-0.14/push-image-kind.png)\\n\\n### Kind Ingress\\n\\nIf you deploy a pod to Kind, you are also going to want to reach it! To do this you will need to install a load balancer or\\ningress controller so that the pod is accessible from outside the cluster. We made it easy to install the Contour ingress\\ncontroller while creating a Kind cluster [1675](https://github.com/containers/podman-desktop/issues/1675),\\nso if you created your cluster with Podman Desktop it is already there!\\n\\n![kind-ingress](img/podman-desktop-release-0.14/kind-ingress.png)\\n\\nWe have several other Kind and Kubernetes features planned to expand the supported scenarios, but hopefully this\\nmakes it easy to get started with Kind and shows where we\'re headed. As always, feedback is appreciated!\\n\\n### UI and UX improvements\\n\\n#### Updated Preferences\\n\\nThe ** Settings > Preferences** page has been updated with a new design [1913](https://github.com/containers/podman-desktop/pull/1913),\\nmaking it easier to see and change preferences. Changes are live, no more Update button.\\n\\n![preferences](https://user-images.githubusercontent.com/49404737/229498507-e754b55c-dcbd-486d-9ee3-a1fe3bed7271.gif)\\n\\n#### Telemetry Prompt\\n\\nThe prompt to enable or disable telemetry has been moved from its own dialog into the **Welcome** screen.\\n[1927](https://github.com/containers/podman-desktop/pull/1927)\\nThis is more usable, one less prompt, and solves a window-layering issue for some users!\\n\\n![telemetry prompt](https://user-images.githubusercontent.com/19958075/229577331-365a9a01-0426-4482-a95d-f5dfe39af90a.png)\\n\\n---\\n\\n## Other notable enhancements\\n\\n- Extension support for opening an external URL [2028](https://github.com/containers/podman-desktop/pull/2028) and\\n accessing the clipboard [2023](https://github.com/containers/podman-desktop/pull/2023)\\n\\n---\\n\\n## Documentation\\n\\nNaturally, we have a section in the documentation just for [Kind](https://podman-desktop.io/docs/kubernetes/kind).\\n\\n---\\n\\n## Notable bug fixes\\n\\n- Avoid a dialog box if unable to check for updates [2062](https://github.com/containers/podman-desktop/pull/2062)\\n- Unable to get to the Dashboard if Kind (or Kubernetes) cluster was not running [2052](https://github.com/containers/podman-desktop/issues/2052)\\n\\n---\\n\\n## Final notes\\n\\nThe complete list of issues fixed in this release is available [here](https://github.com/containers/podman-desktop/issues?q=is%3Aclosed+milestone%3A0.14.0).\\n\\nGet the latest release from the [Downloads](/downloads) section of the website and boost your development journey with Podman Desktop. Additionally, visit the [GitHub repository](https://github.com/containers/podman-desktop) and see how you can help us make Podman Desktop better."},{"id":"podman-desktop-release-0.13","metadata":{"permalink":"/blog/podman-desktop-release-0.13","source":"@site/blog/2023-03-29-release-0.13.md","title":"Release Notes - Podman Desktop 0.13","description":"Podman Desktop 0.13 has been released!","date":"2023-03-29T00:00:00.000Z","formattedDate":"March 29, 2023","tags":[{"label":"podman-desktop","permalink":"/blog/tags/podman-desktop"},{"label":"release","permalink":"/blog/tags/release"},{"label":"kubernetes","permalink":"/blog/tags/kubernetes"},{"label":"compose","permalink":"/blog/tags/compose"}],"readingTime":3.155,"hasTruncateMarker":true,"authors":[{"name":"Tim deBoer","title":"Architect","url":"https://github.com/deboer-tim","imageURL":"https://github.com/deboer-tim.png","key":"deboer"}],"frontMatter":{"title":"Release Notes - Podman Desktop 0.13","description":"Podman Desktop 0.13 has been released!","slug":"podman-desktop-release-0.13","authors":["deboer"],"tags":["podman-desktop","release","kubernetes","compose"],"hide_table_of_contents":false},"prevItem":{"title":"Release Notes - Podman Desktop 0.14","permalink":"/blog/podman-desktop-release-0.14"},"nextItem":{"title":"5 things to know about Podman Desktop for a Docker user","permalink":"/blog/5-things-to-know-for-a-docker-user"}},"content":"import ReactPlayer from \'react-player\'\\n\\nThis release note covers Podman Desktop 0.13 release changes.\\n\\n\x3c!--Main Features--\x3e\\n\\n- **Podman Version**: Podman 4.4.4 now included in Windows and Mac installers.\\n- **Compose**: Support for installing Docker Compose.\\n- **Extensions**: Improved extension support for Podman Desktop with additional capabilities.\\n- **UX and UI Improvements**: Welcome page, task manager, resources, and update alerts.\\n\\nPodman Desktop 0.13 is now available. [Click here to download it](/downloads)!\\n\\n![Podman-desktop-0-13-hero](img/podman-desktop-release-0.13/podman-desktop-release-0.13.png)\\n\\n\x3c!--truncate--\x3e\\n\\n---\\n\\n## Release details\\n\\n### Update to Podman v4.4.4\\n\\nPodman Desktop 0.13 embeds [Podman 4.4.4](https://github.com/containers/podman/releases/tag/v4.4.4) in\\nWindows and macOS installers [#1456](https://github.com/containers/podman-desktop/pull/1456).\\n\\n### Compose support\\n\\nYou can install Docker Compose from the Podman Desktop UI [#1578](https://github.com/containers/podman-desktop/pull/1578). This will allow you use Compose workflows using Podman.\\n\\n### Extensions\\n\\nTo make it easier to extend Podman Desktop we have:\\n\\n- Published the [Podman Desktop Extension API](https://www.npmjs.com/package/@podman-desktop/api) to npmjs [#1727](https://github.com/containers/podman-desktop/pull/1727)\\n- Documented [how to create, publish, and install your own extensions](https://podman-desktop.io/docs/extensions)\\n- Expanded the API for `QuickPickInput` [#1839](https://github.com/containers/podman-desktop/pull/1839)\\n\\n### UI and UX improvements\\n\\n#### Welcome page [#1726](https://github.com/containers/podman-desktop/pull/1726)\\n\\nThe first time every user starts Podman Desktop, they will see a welcome page:\\n\\n![welcome-page](https://user-images.githubusercontent.com/19958075/225682776-e016ba31-5bb9-41d5-87ed-f93caeb3fb84.png)\\n\\nNote that the Welcome page will only appear the first time you run Podman Desktop 0.13.0, and none of your settings or assets in Podman Desktop will be affected by it.\\nOver time, this page will be expanded to help with initial setup and configuration.\\n\\n#### New Task Manager [#1724](https://github.com/containers/podman-desktop/pull/1724)\\n\\nA new Task Manager has been added to the status bar to see the progress (or return to) long running tasks. To start with, building images [#1725](https://github.com/containers/podman-desktop/pull/1725) and Podman machine [#1742](https://github.com/containers/podman-desktop/pull/1742) are using the task manager.\\n\\n![task-manager](img/podman-desktop-release-0.13/task-manager.png)\\n\\n#### Updated Resources Settings [#1582](https://github.com/containers/podman-desktop/pull/1582)\\n\\nThe ** Settings > Resources** page has been updated with a new design, making it easier to see and control your providers from a single place.\\n\\n![resources](https://user-images.githubusercontent.com/49404737/221908815-595715fe-4c95-4087-89e0-45e5544ed5c9.gif)\\n\\nThe other settings pages have been updated for consistency with this new design.\\n\\n#### Update Alerts [#1827](https://github.com/containers/podman-desktop/pull/1827)\\n\\nA new alert button will appear in the status bar when future updates are available.\\n\\n\\n\\n#### Prune buttons [#1481](https://github.com/containers/podman-desktop/pull/1481), [#1482](https://github.com/containers/podman-desktop/pull/1482), [#1484](https://github.com/containers/podman-desktop/pull/1484)\\n\\nWe\'ve added buttons to prune unused volumes [#1481](https://github.com/containers/podman-desktop/pull/1481), images [#1482](https://github.com/containers/podman-desktop/pull/1482) and pods [#1484](https://github.com/containers/podman-desktop/pull/1484).\\n\\n![prune-image](img/podman-desktop-release-0.13/prune-image.png)\\n\\n---\\n\\n## Other notable enhancements\\n\\n- Kubernetes pods are now shown in the Pods view [#1312](https://github.com/containers/podman-desktop/pull/1312)\\n- Easy button to fix Docker compatibility mode on macOS [#1697](https://github.com/containers/podman-desktop/pull/1697)\\n- Display extension icons [#1058](https://github.com/containers/podman-desktop/pull/1058)\\n- API to cancel long running tasks [#1777](https://github.com/containers/podman-desktop/pull/1777)\\n\\n---\\n\\n## Documentation\\n\\nThe documentation has new content:\\n\\n- [How to create, publish, and install your own Podman Desktop extensions](https://podman-desktop.io/docs/extensions)\\n- [Using Compose](https://podman-desktop.io/docs/compose/podman-compose)\\n- [Restarting Kind](https://podman-desktop.io/docs/kubernetes/kind)\\n\\n---\\n\\n## Notable bug fixes\\n\\n- Periodically check and refresh Podman connection on Windows and Mac [#1662](https://github.com/containers/podman-desktop/pull/1662)\\n- Fix inconsistent Log view behaviour [#1710](https://github.com/containers/podman-desktop/pull/1710)\\n- Don\'t create route for regular Kubernetes clusters [#1707](https://github.com/containers/podman-desktop/pull/1707)\\n- Fix copy button on empty screen [#1804](https://github.com/containers/podman-desktop/pull/1804)\\n- Register extension tray items correctly [#1778](https://github.com/containers/podman-desktop/pull/1778) and handle updates [#1800](https://github.com/containers/podman-desktop/pull/1800)\\n\\n---\\n\\n## Community thank you\\n\\n\ud83c\udf89 We\u2019d like to say a big thank you to everyone who helped to make Podman Desktop 0.13 even better:\\n\\n- [`Tony Soloveyv`](https://github.com/Tony-Sol) in [#1605 - Fix directories inconsistency in `~/.local/share/`](https://github.com/containers/podman-desktop/pull/1605)\\n- [`Oleg`](https://github.com/RobotSail) in [#1567 - Check for Flatpak when calling command from exec](https://github.com/containers/podman-desktop/pull/1567)\\n- [`Christoph Blecker`](https://github.com/cblecker) in [#1556 - Fix: Hide dock icon on macOS if starting minimized](https://github.com/containers/podman-desktop/pull/1556)\\n- [`Paul Wright`](https://github.com/pwright) in [#1604 - Docs: correct syntax of kind doc](https://github.com/containers/podman-desktop/pull/1604)\\n- [`Denis Golovin`](https://github.com/dgolovin) in [#1790 - Feat: add EventEmitter class to extension API](https://github.com/containers/podman-desktop/pull/1790)\\n- [`Christophe Fergeau`](https://github.com/cfergeau) in [#1642 - Fix: Pod list \\"an pod\\" typing error](https://github.com/containers/podman-desktop/pull/1642)\\n\\n## Final notes\\n\\nThe complete list of issues fixed in this release is available [here](https://github.com/containers/podman-desktop/issues?q=is%3Aclosed+milestone%3A0.13.0).\\n\\nGet the latest release from the [Downloads](/downloads) section of the website and boost your development journey with Podman Desktop. Additionally, visit the [GitHub repository](https://github.com/containers/podman-desktop) and see how you can help us make Podman Desktop better."},{"id":"5-things-to-know-for-a-docker-user","metadata":{"permalink":"/blog/5-things-to-know-for-a-docker-user","source":"@site/blog/2023-03-24-5-things-to-know-for-a-docker-user.md","title":"5 things to know about Podman Desktop for a Docker user","description":"Important things to know when switching from Docker Desktop to Podman Desktop","date":"2023-03-24T00:00:00.000Z","formattedDate":"March 24, 2023","tags":[{"label":"podman-desktop","permalink":"/blog/tags/podman-desktop"},{"label":"docker","permalink":"/blog/tags/docker"},{"label":"migrating","permalink":"/blog/tags/migrating"}],"readingTime":4.275,"hasTruncateMarker":true,"authors":[{"name":"Florent Benoit","title":"Maintainer of Podman Desktop","url":"https://github.com/benoitf","imageURL":"https://github.com/benoitf.png","key":"benoitf"}],"frontMatter":{"title":"5 things to know about Podman Desktop for a Docker user","description":"Important things to know when switching from Docker Desktop to Podman Desktop","slug":"5-things-to-know-for-a-docker-user","authors":["benoitf"],"tags":["podman-desktop","docker","migrating"],"hide_table_of_contents":false},"prevItem":{"title":"Release Notes - Podman Desktop 0.13","permalink":"/blog/podman-desktop-release-0.13"},"nextItem":{"title":"Release Notes - Podman Desktop 0.12","permalink":"/blog/podman-desktop-release-0.12"}},"content":"The 5 things to know being a Docker user by using Podman Desktop:\\n\\n- **Use a single UI**: Podman Desktop works with several container engines, including Docker.\\n- The **compatibility mode**: How to ensure tools are working with Podman instead of Docker.\\n- **Compose** support: How to work with Compose files and Podman.\\n- **Kubernetes** support: How to use Kubernetes with Podman.\\n- **Security**: Use `rootless` mode or containers without root privileges.\\n\\n![5-things-to-know-for-a-docker-user-hero](img/5-things-to-know-for-a-docker-user/5-things-to-know-for-a-docker-user-hero.png)\\n\\n\x3c!--truncate--\x3e\\n\\n---\\n\\n## Use Podman Desktop to interact with containers running in Docker\\n\\nDocker Desktop provides a UI to interact with containers and images. But the UI depends on Docker API and it is not possible to use the UI with Docker and Podman at the same time.\\n\\nPodman Desktop is a multi-engine UI tool. The UI is compatible with the API of Docker and Podman. It means all containers and images from all the engines at the same time are visible in the UI.\\n\\nWhen migrating from Docker to Podman, you can use Podman Desktop to interact with containers running in Docker. Explore all commands and features of Podman Desktop and see all the resources from Docker.\\n\\n![Many container engines at the same time](img/5-things-to-know-for-a-docker-user/multiple-container-engines.png)\\n\\n## Docker compatibility mode\\n\\nUsing Podman with Podman Desktop or with the Podman CLI is straightforward. But some tools expect to find `docker` CLI or `docker.sock` socket. In this case, you have to use the compatibility mode of Podman.\\n\\n### Socket file compatibility\\n\\nThe socket compatibility mode is a feature of Podman that allows to bind the Podman socket under the Docker socket path.\\n\\nOn Windows the socket compatibility mode is always enabled by default. On macOS, by using the `.pkg installer` it is active by default. But when installing with `brew`, it will not be there because it requires some admin permissions.\\n\\nThat is not an issue because you can enable it by [invoking a CLI tool](https://podman-desktop.io/docs/migrating-from-docker/using-podman-mac-helper) that will setup the compatibility mode.\\n\\nFor example if you use [`TestContainers`](https://www.testcontainers.org/) in your Java project, you can use the compatibility mode to ensure that the tool will use Podman instead of Docker.\\n\\n### CLI compatibility\\n\\nIf you have scripts relying on `docker` CLI, you can use the compatibility mode to ensure that the tool is working with Podman instead of Docker.\\n\\nIf you have the `docker` CLI installed on your computer, you can use the socket file compatibility of docker to ensure that the tool is working with Podman engine instead of Docker.\\n\\nIf you do not have the `docker` CLI installed on your computer, you can [Create a script](https://podman-desktop.io/docs/migrating-from-docker/emulating-docker-cli-with-podman) called `docker` that will call the `podman` CLI\\n\\n**_NOTE:_** creating a shell prompt alias, for example `alias docker=podman`, will not work inside scripts that you call.\\n\\n## Compose\\n\\nAs a user of Docker, you might use `docker compose` (or `docker-compose`) to run some of your applications.\\n\\nFor now Podman does not include a `Compose` support directly in the CLI with a command `podman compose`.\\n\\n`Compose` can work with the Podman socket.\\n\\nBased on the compatibility mode (see [section about Docker compatibility mode](#docker-compatibility-mode)):\\n\\n- Enabled: you can use the `compose` binary to run your applications.\\n- Disabled: you need to [export the environment variable DOCKER_HOST](https://podman-desktop.io/docs/migrating-from-docker/using-the-docker_host-environment-variable) before running compose.\\n\\nYou can now use the `compose` binary to run your applications and it will use Podman engine.\\n\\nPodman Desktop has a `compose` extension that can fetch `compose` binary if not already available on the filesystem.\\n\\nPodman Desktop UI displays the containers created by `Compose` are in the same group.\\n\\n![Compose support in the UI](img/5-things-to-know-for-a-docker-user/compose-containers-in-ui.png)\\n\\n## Kubernetes\\n\\nIt is possible to start a Kubernetes cluster with Docker.\\n\\nPodman supports directly a subset of Kubernetes resources that you can use with `.yaml` files.\\n\\nFor example if you only want to create a `Pod` resource, you can use the `Play Kubernetes YAML` button from the `Containers` list screen with your `.yaml` file. No need to install or start a Kubernetes cluster.\\n\\n![Play Kubernetes YAML](img/5-things-to-know-for-a-docker-user/play-kubernetes-yaml.png)\\n\\nIt is possible to do the counter-part. Export the definition of a container or pod to a Kubernetes resource. You can use the `Generate kube` button from the kebab menu of a given container or pod.\\n\\n![Kubernetes generate](img/5-things-to-know-for-a-docker-user/kube-generate.png)\\n\\nPodman handles pods and in the Podman Desktop UI, you can see all the pods inside a Pod section. All containers inside the pod are in the same group.\\n\\n![Pods in the UI](img/5-things-to-know-for-a-docker-user/pods-in-ui.png)\\n\\n![Containers from pod](img/5-things-to-know-for-a-docker-user/containers-from-pod.png)\\n\\nAn experimental `kind` extension is bringing the creation of full-blown Kubernetes cluster with Podman.\\n\\n## Rootless mode\\n\\nOne of the difference of Docker and Podman is the way they handle containers. Docker requires root privileges to run containers by default. Podman can run containers without root privileges by default.\\n\\nIt means that for example, starting a container with a port < 1024 will not work. You need to use a port > 1024.\\n\\nIf you still need to create containers with a port < 1024, you can change the Podman machine configuration of the Podman Machine if you are on Windows or macOS.\\n\\nThe command is `podman machine --rootful` to enable the execution with root privileges or `podman machine --rootful=false` to switch back to rootless mode."},{"id":"podman-desktop-release-0.12","metadata":{"permalink":"/blog/podman-desktop-release-0.12","source":"@site/blog/2023-02-15-release-0.12.md","title":"Release Notes - Podman Desktop 0.12","description":"Podman Desktop 0.12 has been released!","date":"2023-02-15T00:00:00.000Z","formattedDate":"February 15, 2023","tags":[{"label":"podman-desktop","permalink":"/blog/tags/podman-desktop"},{"label":"release","permalink":"/blog/tags/release"},{"label":"kubernetes","permalink":"/blog/tags/kubernetes"}],"readingTime":4.505,"hasTruncateMarker":true,"authors":[{"name":"Stevan Le Meur","title":"Product Manager","url":"https://github.com/slemeur","imageURL":"https://github.com/slemeur.png","key":"slemeur"}],"frontMatter":{"title":"Release Notes - Podman Desktop 0.12","description":"Podman Desktop 0.12 has been released!","slug":"podman-desktop-release-0.12","authors":["slemeur"],"tags":["podman-desktop","release","kubernetes"],"hide_table_of_contents":false},"prevItem":{"title":"5 things to know about Podman Desktop for a Docker user","permalink":"/blog/5-things-to-know-for-a-docker-user"},"nextItem":{"title":"Release Notes - Podman Desktop 0.11","permalink":"/blog/podman-desktop-release-0.11"}},"content":"import ReactPlayer from \'react-player\'\\n\\nThis release note covers Podman Desktop 0.12 release changes.\\n\\n\x3c!--Main Features--\x3e\\n\\n- **Podman Version**: Podman 4.4.1 now included in Windows and Mac installers.\\n- **Containers Configuration**: Configure port mappings for an image without exported ports.\\n- **Windows Home Support**: Podman Desktop now supports Windows Home Edition.\\n- **Start minimized**: Option to start Podman Desktop minimized to system tray.\\n- **UX and UI Improvements**: Consistent actions, placeholder for logs, unified icons and others.\\n\\nPodman Desktop 0.12 is now available. [Click here to download it](/downloads)!\\n\\n![podman-desktop-0-12-hero](img/podman-desktop-release-0.12/podman-desktop-release-0.12.png)\\n\\n\x3c!--truncate--\x3e\\n\\n---\\n\\n## Release Details\\n\\n### Update to Podman v4.4.1 [#1456](https://github.com/containers/podman-desktop/pull/1456)\\n\\nPodman Desktop 0.12 embeds [Podman 4.4.1](https://github.com/containers/podman/releases/tag/v4.4.1) in Windows and macOS installers. Make sure to upgrade to benefit from the latest Podman features and bug fixes.\\n\\n### Configuring port mappings when an image has no exported port [#1265](https://github.com/containers/podman-desktop/pull/1265)\\n\\nWith the latest update, users can now add multiple local-to-remote port mappings when starting a container from an image that has no exported ports. This feature provides users with the flexibility to specify which ports on their local machine should map to which ports on the container, even if the container does not have any exported ports by default.\\n\\n![port-mapping](https://user-images.githubusercontent.com/49404737/215112797-86dcf3f0-121a-487e-a71f-ad41e91f93da.gif)\\n\\n### Installing Podman Dekstop on Windows Home Edition [#1268](https://github.com/containers/podman-desktop/pull/1268)\\n\\nPodman Desktop 0.12 offers the ability to be installed on Windows Home Edition. The mechanism uses Virtual Machine Platform detection, instead of hyper-v. WSL2 is still requires but can be installed along with the installation process.\\n\\n![install-windows-home-edition-2](https://user-images.githubusercontent.com/436777/215121429-7c757aaa-a838-43db-98a2-78ad368f407e.png)\\n\\n### Option to automatically minimize Podman Desktop on login [#1374](https://github.com/containers/podman-desktop/pull/1374)\\n\\nPodman Desktop now provides a \\"start minimized\\" option when users log in onto the laptop. This option, available from the application\'s settings, can be useful if users want to automatically launch Podman Desktop at log in, but prefer not to have the window visible on the screen. With this feature, you can ensure that Podman Desktop is up and running in the background without any interruption to your workflows.\\n\\n- Go to ** Settings > Preferences > Login: Minimize** to activate the option.\\n\\n![minimize-on-login](https://user-images.githubusercontent.com/6422176/216651424-bcf756fd-7554-4b24-a838-e3e2f798fe6e.png)\\n\\n### UI and UX Improvements\\n\\n#### Improved actions consistency [#1225](https://github.com/containers/podman-desktop/pull/1225)\\n\\nActions displayed in the list pages for Images and Containers have been reviewed and made consistent between other pages.\\n\\n![action-consistency-1](https://user-images.githubusercontent.com/19958075/214104678-2d4148d7-484e-41f9-9da9-aecee328ae2b.png)\\n\\nActions displayed in the header of the container\'s details page have been improved so that the actions are always displayed in the same order.\\n\\n![action-consistency-2](https://user-images.githubusercontent.com/19958075/214104663-64fa0601-bb79-49bf-8226-6a78a88d3622.png)\\n\\n#### Consistent status icons for Pods, Containers, Images and Volumes [#1326](https://github.com/containers/podman-desktop/pull/1326), [#1377](https://github.com/containers/podman-desktop/pull/1377), [#1459](https://github.com/containers/podman-desktop/pull/1459) and [#1245](https://github.com/containers/podman-desktop/pull/1245)\\n\\nThe status icons for Pods, Containers, Images, and Volumes have been unified and use consistent states.\\n\\n![pods-status-icon](https://user-images.githubusercontent.com/19958075/216671859-bdd8dca4-56b7-40a8-961a-dcb6e01be61e.png)\\n\\nIcons in empty screens have been updated to use the same consistent SVG icon as the status icons.\\n\\n![empty-screen-2](https://user-images.githubusercontent.com/436777/214577726-f4cfde7b-017a-499d-a2a9-e50d455ffaf0.png)\\n\\n#### Placeholder when logs for containers are being fetched [#1353](https://github.com/containers/podman-desktop/pull/1353)\\n\\nA placeholder is now displayed when logs are being fetched.\\n![placeholder-loading-logs](https://user-images.githubusercontent.com/49404737/216952505-899308ae-183e-487a-b6e5-28832a0b6452.gif)\\n\\n#### Fixed alignement in badges from the navigation sidebar [#1357](https://github.com/containers/podman-desktop/pull/1357)\\n\\nBadges in the sidebar are now aligned with the title of the section.\\n\\n![alignement-badges](https://user-images.githubusercontent.com/49404737/216336502-2a34dea3-fd41-4184-8cfe-9226d70da070.png)\\n\\n#### Enable/disable open browser action based on container state [#1395](https://github.com/containers/podman-desktop/pull/1395) and [#1397](https://github.com/containers/podman-desktop/pull/1397)\\n\\nThe action to open the browser if a port is opened in a container, is now disabled when the container is stopped. It is also hidden in the kebab menu.\\n\\n![enable-disable-container-actions](https://user-images.githubusercontent.com/49404737/217284414-1bdc820b-30a8-485e-b0f9-485229026696.gif)\\n\\n---\\n\\n## Other Notable Enhancements\\n\\n- Display extension icons [#1058](https://github.com/containers/podman-desktop/pull/1058)\\n- Solid Icons [#1267](https://github.com/containers/podman-desktop/pull/1276)\\n- Differentiate icons compared to status icons [#1268](https://github.com/containers/podman-desktop/pull/1298)\\n- Refactors window initializing [#1309](https://github.com/containers/podman-desktop/pull/1309)\\n- Change window creation background color to dark [#1310](https://github.com/containers/podman-desktop/pull/1310)\\n- Use Podman `machine inspect` to read the address to connect to the Podman machine [#1364](https://github.com/containers/podman-desktop/pull/1364)\\n- Update the editor content when the pod name changes, and disable the deploy button when empty [#1403](https://github.com/containers/podman-desktop/pull/1403)\\n- Ability to manually set color of tray icon for Windows and Linux [#1243](https://github.com/containers/podman-desktop/pull/1243)\\n- Better UI feedback when starting pods [#1242](https://github.com/containers/podman-desktop/pull/1242)\\n\\n---\\n\\n## Documentation\\n\\nThe documentation had many editorial reviews, and new content.\\n\\n- [Link to simple WSL2 installation instructions](https://podman-desktop.io/docs/Installation/windows-install)\\n- [Refresh Windows Installation](https://podman-desktop.io/docs/Installation/windows-install)\\n- [Revamped installation introduction](https://podman-desktop.io/docs/Installation)\\n- [Reorganized Linux installation](https://podman-desktop.io/docs/Installation/linux-install)\\n- [Installing Podman with OpenShift Local](https://podman-desktop.io/docs/Installation/windows-install/installing-podman-with-openshift-local)\\n- [Installing Podman Desktop on Windows in a restricted environment](https://podman-desktop.io/docs/Installation/windows-install/installing-podman-desktop-and-podman-in-a-restricted-environment)\\n- [Fixed documentation on `podman-mac-helper` setup](https://podman-desktop.io/docs/migrating-from-docker/using-podman-mac-helper)\\n\\n---\\n\\n## Notable bug fixes\\n\\n- Fixed handling path with spaces on Windows when installing Podman [#1270](https://github.com/containers/podman-desktop/pull/1270)\\n- Removed padding from SVG icons [#1253](https://github.com/containers/podman-desktop/pull/1253)\\n- Website: fixed download links for Windows and macOS binaries [#1255](https://github.com/containers/podman-desktop/pull/1255)\\n- Fixed prettier commands on Windows [#1266](https://github.com/containers/podman-desktop/pull/1267)\\n- Fixed new xterm instance spawn when clicking the logs route [#1344](https://github.com/containers/podman-desktop/pull/1344)\\n- Fixed need to wait that telemetry has been initilized before proceeding [#1373](https://github.com/containers/podman-desktop/pull/1373)\\n- Fixed new xterm instance spawn when clicking the logs route in pod details[#1393](https://github.com/containers/podman-desktop/pull/1393)\\n- Fixed stop spinner if image cannot be retrieved [#1394](https://github.com/containers/podman-desktop/pull/1394)\\n- Fixed escape command with quotes only for Windows [#1462](https://github.com/containers/podman-desktop/pull/1462)\\n- Fixed random CRC status change [#1420](https://github.com/containers/podman-desktop/pull/1420)\\n\\n---\\n\\n## Community Thank You\\n\\n\ud83c\udf89 We\u2019d like to say a big thank you to everyone who helped to make Podman Desktop 0.12 even better:\\n\\n- [Philipp Wagner](https://github.com/imphil) in [#1274 - Link to simple WSL2 installation instructions](https://github.com/containers/podman-desktop/pull/1274)\\n- [Arthur S](https://github.com/arixmkii) in [#1364 - Get podman machine socketPath from podman machine inspect first](https://github.com/containers/podman-desktop/pull/1364)\\n- [Mitch West](https://github.com/Mitch9378) in [#1428 - Fix old documentation for \'podman-mac-helper setup\'](https://github.com/containers/podman-desktop/pull/1428)\\n\\n## Final Notes\\n\\nThe complete list of issues fixed in this release is available [here](https://github.com/containers/podman-desktop/issues?q=is%3Aclosed+milestone%3A0.12.0).\\n\\nGet the latest release from the [Downloads](/downloads) section of the website and boost your development journey with Podman Desktop. Additionally, visit the [GitHub repository](https://github.com/containers/podman-desktop) and see how you can help us make Podman Desktop better."},{"id":"podman-desktop-release-0.11","metadata":{"permalink":"/blog/podman-desktop-release-0.11","source":"@site/blog/2023-01-18-release-0.11.md","title":"Release Notes - Podman Desktop 0.11","description":"Podman Desktop 0.11 has been released!","date":"2023-01-18T00:00:00.000Z","formattedDate":"January 18, 2023","tags":[{"label":"podman-desktop","permalink":"/blog/tags/podman-desktop"},{"label":"release","permalink":"/blog/tags/release"},{"label":"kubernetes","permalink":"/blog/tags/kubernetes"}],"readingTime":9.43,"hasTruncateMarker":true,"authors":[{"name":"Stevan Le Meur","title":"Product Manager","url":"https://github.com/slemeur","imageURL":"https://github.com/slemeur.png","key":"slemeur"}],"frontMatter":{"title":"Release Notes - Podman Desktop 0.11","description":"Podman Desktop 0.11 has been released!","slug":"podman-desktop-release-0.11","authors":["slemeur"],"tags":["podman-desktop","release","kubernetes"],"hide_table_of_contents":false},"prevItem":{"title":"Release Notes - Podman Desktop 0.12","permalink":"/blog/podman-desktop-release-0.12"},"nextItem":{"title":"Release Notes - Podman Desktop 0.10","permalink":"/blog/podman-desktop-release-0.10"}},"content":"import ReactPlayer from \'react-player\'\\n\\nThis release note covers Podman Desktop 0.11 release changes.\\n\\n- **Air-Gapped Installation**: New all-in-one binaries for air-gapped installation.\\n- **Feedback**: Submit feedback directly from Podman Desktop.\\n- **Docker Compatibility Mode**: Information about the Docker compatibility mode.\\n- **Proxy Setting**: Toggle on/off the proxy setting.\\n- **Deploy to Kubernetes**: Select the namespace to deploy to Kubernetes.\\n- **Registry Configuration**: Simplified registry configuration for well known registries.\\n- **UX/UI Improvements**: View pod\'s container logs, better visual feedback, configurable editor font size, and more.\\n\\nPodman Desktop 0.11 is now available. [Click here to download it](/downloads)!\\n\\n\x3c!--truncate--\x3e\\n\\n---\\n\\n## Release Details\\n\\n### Air-Gapped installation [#1104](https://github.com/containers/podman-desktop/pull/1104) [#1120](https://github.com/containers/podman-desktop/pull/1120)\\n\\nFor 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:\\n\\n- on Mac, it embeds the qemu FCOS binaries.\\n- on Windows, it embeds the WSL binary.\\n\\nTo differentiate the air-gapped binaries from the regular ones, you can check the artifactname, they\'re containing \'airgap\' and are bigger.\\nPlease note, that those binaries are available only on releases and not the pre-releases.\\n\\nThere 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).\\n\\n\\n\\n### Feedback within Podman Desktop [#1078](https://github.com/containers/podman-desktop/pull/1078)\\n\\nSubmitting 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.\\n\\n\\n\\nPlease feel free to submit any feedback you have, we are looking forward to hearing from you!\\n\\n### Docker compatibility mode [#1047](https://github.com/containers/podman-desktop/pull/1047)\\n\\nThe 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](https://www.testcontainers.org/) or others are relying on this to communicate to the container engine.\\n\\nIn 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:\\n\\n- When Docker is running: the socket is pointing to Docker.\\n- When Podman is starting and Docker is not running: the docker API socket will use Podman.\\n\\nIn 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](https://podman-desktop.io/docs/migrating-from-docker).\\n\\nThis is a warning displayed for Windows users:\\n![windows-docker-compatibility](https://user-images.githubusercontent.com/436777/209305744-9056addd-f122-4f75-9e03-ad27a0109375.png)\\n\\nThis is the warning for Mac users:\\n![mac-docker-compatibility](https://user-images.githubusercontent.com/6422176/207964861-a9c1f72c-89d6-4816-beab-397af4125620.png)\\n\\n### Allow to toggle on/off the proxy setting [#983](https://github.com/containers/podman-desktop/pull/983)\\n\\nIn 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.\\n\\n\\n\\nNote: extensions can read this information and then update the proxy configuration.\\n\\n### Namespace selection for deploy to Kubernetes [#1008](https://github.com/containers/podman-desktop/pull/1008)\\n\\nA 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.\\n\\nIf the user have set `kubectl config set-context --current --namespace=NAMESPACE` it honors that as the chosen value.\\n\\n![deploy-kubernetes-namespace](https://user-images.githubusercontent.com/7339809/206688886-095e4f15-42ae-4a0a-b1c6-ae4b547fcdfb.gif)\\n\\n### Configure Podman binary path [#941](https://github.com/containers/podman-desktop/pull/941)\\n\\nUsers may 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. Additional information is available in the documentation for Mac users: [http://podman-desktop.io/docs/troubleshooting#unable-to-set-custom-binary-path-for-podman-on-macos](http://podman-desktop.io/docs/troubleshooting#unable-to-set-custom-binary-path-for-podman-on-macos)\\n\\n![custom-path](https://user-images.githubusercontent.com/6422176/204832063-5858065a-2fc3-49de-8d23-3b99b7d10dbf.png)\\n\\n### Provide pre-defined registries [#1201](https://github.com/containers/podman-desktop/pull/1201)\\n\\nThe 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:\\n\\n- Dockerhub\\n- Red Hat Quay\\n- GitHub\\n- IBM Container Registry\\n- Google Container Registry\\n\\n\\n\\n### UI/UX Improvements\\n\\n#### View Pods logs [#1122](https://github.com/containers/podman-desktop/pull/1122)\\n\\nThe 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.\\n\\n![pods-logs](https://user-images.githubusercontent.com/6422176/211024673-eee9bad8-1b0c-4446-b8d1-97a226282c4d.png)\\n\\n#### Improved feedback when clicking on container list action icons [#1150](https://github.com/containers/podman-desktop/pull/1150) [#1161](https://github.com/containers/podman-desktop/pull/1161)\\n\\nWhen 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.\\n\\n\\n\\nFor 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](https://github.com/containers/podman-desktop/pull/1161).\\n\\n\\n\\n#### Allows to change the default font size for the editor [#1160](https://github.com/containers/podman-desktop/pull/1160)\\n\\nAn 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).\\n\\n\\n\\n#### Keep expanded state of pods when refreshing containers [#1042](https://github.com/containers/podman-desktop/pull/1042)\\n\\nWhen 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.\\n\\n\\n\\n#### Click on the Pod name redirects to the Pod details page [#1159](https://github.com/containers/podman-desktop/pull/1159)\\n\\nThe list of containers also displays pods, now clicking on the pod name directly redirects to the Pod details page.\\n\\n\\n\\n#### Improved styles of buttons for actions [#984](https://github.com/containers/podman-desktop/pull/984)\\n\\nThe 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.\\n\\nOn lists:\\n![list-actions](https://user-images.githubusercontent.com/6422176/205979121-b49a0ddf-03bb-4a4d-8d12-bc8d0bd52387.png)\\n\\nOn details pages:\\n![details-actions](https://user-images.githubusercontent.com/6422176/205979123-ea420b17-e834-4029-82eb-22949889eee9.png)\\n\\n#### Improved alignments in pages with lists [#1182](https://github.com/containers/podman-desktop/pull/1182)\\n\\nThe 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.\\n\\n![list-actions](https://user-images.githubusercontent.com/19958075/212712580-096fd090-0beb-40a4-8dc6-b3fdc5e81e35.png)\\n\\n---\\n\\n## Other Notable Enhancements\\n\\n- Statistics area in container details are always shown. ([#1131](https://github.com/containers/podman-desktop/pull/1131))\\n- Add more descriptive wording and more information to extensions. ([#985](https://github.com/containers/podman-desktop/pull/985))\\n- Allow to install on-the fly Podman Desktop extensions using an OCI image. ([#1187](https://github.com/containers/podman-desktop/pull/1187))\\n- Display correctly non-multiplexed stream in logs (when using non interactive mode). ([#1197](https://github.com/containers/podman-desktop/pull/1197))\\n- Font changed from white to gray for non-name sections (creation date, size). ([#1206](https://github.com/containers/podman-desktop/pull/1206))\\n- Add Help/about menu for macOS/Windows/Linux. ([#1207](https://github.com/containers/podman-desktop/pull/1207))\\n\\n---\\n\\n## Documentation\\n\\nComing with this new version of Podman Desktop, the documentation has been getting attention (with number of editorial reviews) and new content have been added.\\n\\nContent for helping users to migrate from Docker to Podman has been added:\\n\\n- [Using the `podman-mac-helper` tool to migrate from Docker to Podman on macOS](https://github.com/containers/podman-desktop/pull/1088)\\n- [better identify podman-mac-helper verification steps](https://github.com/containers/podman-desktop/pull/1129)\\n- [Emulating Docker CLI using Podman to migrate from Docker to Podman](https://github.com/containers/podman-desktop/pull/1143)\\n- [Migrating from Docker section](https://github.com/containers/podman-desktop/pull/1146)\\n- [Verifying that your tools are using Podman](https://github.com/containers/podman-desktop/pull/1152)\\n- [Importing saved containers](https://github.com/containers/podman-desktop/pull/1144)\\n\\nSeveral of other improvements have been made to the documentation and the website:\\n\\n- [Troubleshooting for Apple Silicon and brew x86_64 installs](https://github.com/containers/podman-desktop/pull/962)\\n- [Change text of custom binary location, add docs](https://github.com/containers/podman-desktop/pull/972)\\n- [Silent install option for windows](https://github.com/containers/podman-desktop/pull/974)\\n- [Upgrade to vite v4 and rollup v3](https://github.com/containers/podman-desktop/pull/1079)\\n- [Refreshing documentation on installing on Linux](https://github.com/containers/podman-desktop/pull/1118)\\n- [Identify the shell sessions in Installing on Linux](https://github.com/containers/podman-desktop/pull/1130)\\n- [Website: the linux binary is not a source, it should be promoted as a binary](https://github.com/containers/podman-desktop/pull/1133)\\n- [Introducing tabs for operatings systems and container engines](https://github.com/containers/podman-desktop/pull/1162)\\n- [website: In the landing page, update plugins and container engines lists](https://github.com/containers/podman-desktop/pull/1165)\\n- [Document where code is located within Podman Desktop](https://github.com/containers/podman-desktop/pull/1163)\\n- [(extension-api): Documentation on how to write an extension and use the api](https://github.com/containers/podman-desktop/pull/1172)\\n\\n---\\n\\n## Notable bug fixes\\n\\n- Update to v0.3.2 Docker Desktop API for extensions - [#1070](https://github.com/containers/podman-desktop/pull/1070)\\n- Updated link to the Matrix room - [#1076](https://github.com/containers/podman-desktop/pull/1076)\\n- Report error when container name already exists - [#1142](https://github.com/containers/podman-desktop/pull/1142)\\n- Fixed connectivity to the Podman machine when the generated socket length is greater than 104 characters in MacOS - [#1145](https://github.com/containers/podman-desktop/pull/1145)\\n- Do not use long calls for external clients - [#1151](https://github.com/containers/podman-desktop/pull/1151)\\n- Invalid name/tag for images with registries using a different port - [#1127](https://github.com/containers/podman-desktop/pull/1127)\\n- Invalid badge count for images when two images have the same tag - [#1124](https://github.com/containers/podman-desktop/pull/1124)\\n- Fixed detection of WSL2 - [#981](https://github.com/containers/podman-desktop/pull/981)\\n- Handle invalid kubeconfig files instead of crashing - [#953](https://github.com/containers/podman-desktop/pull/953)\\n- Removed redundant actions from details pages - [#1200](https://github.com/containers/podman-desktop/pull/1200)\\n- Fixed registry URL not aligned with header - [#1205](https://github.com/containers/podman-desktop/pull/1205)\\n- Moved SVGs to reusable components - [#1211](https://github.com/containers/podman-desktop/pull/1211)\\n\\n**Extensions API has also been improved in this new release:**\\n\\n- (extension-api): Allows to register a factory for kubernetes connection objects (like for container connections) - [#1040](https://github.com/containers/podman-desktop/pull/1040)\\n- (extension-api): List or inspect containers, be notified on events - [#1041](https://github.com/containers/podman-desktop/pull/1041)\\n- (extension-api): Allows to get provider notification - [#1045](https://github.com/containers/podman-desktop/pull/1045)\\n- (dd-extension-api): Implement toast API - [#1154](https://github.com/containers/podman-desktop/pull/1154)\\n- (extension-api): Moved extension properties to preferences - [#948](https://github.com/containers/podman-desktop/pull/948)\\n- (dd-extension-api): Added open dev console on dd webview in development mode - [#1071](https://github.com/containers/podman-desktop/pull/1071)\\n- (extension-api): Added notes on extension and frameworks/tooling of Podman Desktop - [#1166](https://github.com/containers/podman-desktop/pull/1166)\\n- (extension-api): Documentation on how to write an extension and use the api - [#1172](https://github.com/containers/podman-desktop/pull/1172)\\n- (dd-extension-api): DD extensions should see only minimal information on containers - [#1191](https://github.com/containers/podman-desktop/pull/1191)\\n\\n---\\n\\n## Community Thank You\\n\\n\ud83c\udf89 We\u2019d like to say a big thank you to everyone who helped to make Podman Desktop 0.11 even better:\\n\\n- [Emmanuel Bernard](https://github.com/emmanuelbernard) in [#962 - Troubleshooting for Apple Silicon](https://github.com/containers/podman-desktop/pull/962)\\n- [Michael Prankl](https://github.com/eidottermihi) in [#974 - Silent install option for windows](https://github.com/containers/podman-desktop/pull/974)\\n- [Endre Lervik](https://github.com/elervik) in [#1008 - Namespace selection for deploy to kubernetes](https://github.com/containers/podman-desktop/pull/1008)\\n- [Evan FP](https://github.com/evanfpearson) in [#1145 - fixed socket path length error](https://github.com/containers/podman-desktop/pull/1145)\\n- [Lokesh Mandvekar](https://github.com/lsm5) in [#956 - add repository key to package.json](https://github.com/containers/podman-desktop/pull/956)\\n- [Jean Fran\xe7ois Maury](https://github.com/jeffmaury) in [#1194 - Cannot create Kind cluster on Windows](https://github.com/containers/podman-desktop/pull/1194)\\n\\n## Final Notes\\n\\nThe complete list of issues fixed in this release is available [here](https://github.com/containers/podman-desktop/issues?q=is%3Aclosed+milestone%3A0.11.0).\\n\\nGet the latest release from the [Downloads](/downloads) section of the website and boost your development journey with Podman Desktop. Additionally, visit the [GitHub repository](https://github.com/containers/podman-desktop) and see how you can help us make Podman Desktop better."},{"id":"podman-desktop-release-0.10","metadata":{"permalink":"/blog/podman-desktop-release-0.10","source":"@site/blog/2022-12-01-release-0.10-blog.md","title":"Release Notes - Podman Desktop 0.10","description":"Podman Desktop 0.10 has been released! New Create Container Wizard, improved Kubernetes workflows, revamped registries configuration, and more!","date":"2022-12-01T00:00:00.000Z","formattedDate":"December 1, 2022","tags":[{"label":"podman-desktop","permalink":"/blog/tags/podman-desktop"},{"label":"release","permalink":"/blog/tags/release"},{"label":"kubernetes","permalink":"/blog/tags/kubernetes"}],"readingTime":4.115,"hasTruncateMarker":true,"authors":[{"name":"Dev Kumar","title":"Technical PMM Intern","url":"https://github.com/deekay2310","imageURL":"https://github.com/deekay2310.png","key":"deekay2310"}],"frontMatter":{"title":"Release Notes - Podman Desktop 0.10","description":"Podman Desktop 0.10 has been released! New Create Container Wizard, improved Kubernetes workflows, revamped registries configuration, and more!","slug":"podman-desktop-release-0.10","authors":["deekay2310"],"tags":["podman-desktop","release","kubernetes"],"hide_table_of_contents":false},"prevItem":{"title":"Release Notes - Podman Desktop 0.11","permalink":"/blog/podman-desktop-release-0.11"},"nextItem":{"title":"Build & run Podman Desktop in a DevContainer","permalink":"/blog/develop-using-devcontainer"}},"content":"This release note covers Podman Desktop 0.10 release changes.\\n\\n- **Containers Configuration**: Container creation wizzard allowing to define environment variables, networking and more configuration options.\\n- **Kubernetes Improvements**: Play Kubernetes YAML, custom Kubeconfig path support, reload of kube context.\\n- **Registries Configuration**: Revamped registries configuration UI.\\n- **Podman Version**: Podman 4.3.1 now included in Windows and Mac installers.\\n- **UX/UI Improvements**: Improved lists, better contrast, and more.\\n\\nPodman Desktop 0.10 is now available. [Click here to download it](/downloads)!\\n\\n\x3c!--truncate--\x3e\\n\\n---\\n\\n## Release Details\\n\\n### New configuration wizzard to create containers ([#773](https://github.com/containers/podman-desktop/pull/773))\\n\\nUntil now, we could only specify port binding when building images to start containers. The create container wizzard now includes several options enabling configuring volumes, environment variables, restart policy and settings on networking and security. It is also possible to reuse an existing (and already configured) a network when creating containers.\\n\\n![new container creation wizard](img/podman-desktop-release-0.10/new_container_creation_wizard.gif)\\n\\n### Kubernetes Capabilities Improvements\\n\\n**Custom Kubeconfig file path ([#780](https://github.com/containers/podman-desktop/pull/780))**\\n\\nKubeconfig path location is now configurable from ** Settings > Preferences > Kubernetes: Kubeconfig** and can be set to a custom path. By default, Podman Desktop use the path `$HOME/.kube/config` for the Kubeconfig file.\\n\\n![custom kubeconfig file path](img/podman-desktop-release-0.10/custom-kubeconfig.png)\\n\\n**Play Kubernetes YAML from the Pods list ([#739](https://github.com/containers/podman-desktop/pull/739))**\\n\\nPodman Desktop enables to play existing Kubernetes YAML files. This is now available from `Play Kubernetes YAML` button added to the Pods list, in addition to the Containers list.\\n\\n![play k8s yaml](img/podman-desktop-release-0.10/play_k8s_yaml.gif)\\n\\n**Kube context automatically reloaded when updated ([#813](https://github.com/containers/podman-desktop/pull/813))**\\n\\nAny change to the kube context will now be detected by Podman Desktop in its running state. The system tray, allowing to select which Kubernetes environment to work with, will now reload the kube context without restarting Podman Desktop.\\n\\n### Revamped Container Registries UI ([#446](https://github.com/containers/podman-desktop/issues/446))\\n\\nThe registries configuration UI has been revamped. Instead of using tiles for displaying the registries, now it uses a list where each registry can be added or edited directly in the list. The kebab menu provides options to edit or remove a registry from the list.\\n\\n![registries](img/podman-desktop-release-0.10/registries.png)\\n\\n### Update to Podman 4.3.1 ([#913](https://github.com/containers/podman-desktop/issues/913))\\n\\nPodman Desktop 0.10 is now embedding [Podman 4.3.1](https://github.com/containers/podman/releases/tag/v4.3.1) in Windows and macOS installers.\\n\\n### UI/UX Improvements\\n\\n**Improved lists UX ([#877](https://github.com/containers/podman-desktop/pull/877))**\\n\\nTo reduce the width used in the lists when displaying all the icons, main actions icons are now always displayed (before it was on hover) and the secondary actions are displayed in a kebab menu. For example Start/Stop and delete are primary actions while open the browser, inspect, generate kube yaml, etc. are secondary options.\\n\\n![kebab menu](img/podman-desktop-release-0.10/kebab-menu.png)\\n\\n**Delay appearance of text in navbar ([#767](https://github.com/containers/podman-desktop/pull/767))**\\n\\nWhen minimizing or expanding the navbar, the text was overlapping for a few second the page. Now it\'s displayed with a fading animation.\\n\\n**Selected state: better text color contrast ([#802](https://github.com/containers/podman-desktop/pull/802))**\\n\\nIn the `Images` page, on hover for both the image and the name column, the text contrast has been increased for better visibility: violet indicates that you have selected it.\\n\\n![text color when hover](img/podman-desktop-release-0.10/text-color.gif)\\n\\n**On Linux and Windows, the menu bar is now hidden by default ([#668](https://github.com/containers/podman-desktop/pull/668))**\\n\\nWith this change, the menu bar looks more integrated to the Operating System. The menu can appear if you hit the `Alt` key. Thanks to [Dylan M. Taylor](https://github.com/dylanmtaylor) for contributing to fix this.\\n\\n**Exit when clicking on the close icon of the dashboard on Linux ([#671](https://github.com/containers/podman-desktop/pull/671))**\\n\\nFor most users on Linux, there is no tray icon support. In this situation, when closed, Podman Desktop continues to run in background. [Dylan M. Taylor](https://github.com/dylanmtaylor) added a property to exit the app by default when clicking on the close icon. For people having tray icon support or with the desire of a different behavior, it is possible to disable it from the Settings.\\n\\n---\\n\\n## Other Notable Enhancements\\n\\n- Rename `Started` into `Age` in Containers list.([#878](https://github.com/containers/podman-desktop/pull/878))\\n- Added domain validation when adding a registry. ([#838](https://github.com/containers/podman-desktop/pull/838))\\n- Provided a consistent behavior with Podman CLI, `podman-machine-default` is now the default name when creating a Podman machine from Podman Desktop. ([#775](https://github.com/containers/podman-desktop/pull/775))\\n\\n---\\n\\n## Notable bug fixes\\n\\n- Fixed error handling when pulling images of Desktop Extensions. ([#782](https://github.com/containers/podman-desktop/pull/782))\\n- Fixed use of the full height of the screen when displaying log in the details of a container. ([#946](https://github.com/containers/podman-desktop/discussions/946))\\n- Fixed First start of Podman Desktop on flatpak was not seeing the podman engine ([#860](https://github.com/containers/podman-desktop/pull/860))\\n\\n## Community Thank You\\n\\n\ud83c\udf89 We\u2019d like to say a big thank you to everyone who helped to make Podman Desktop 0.10 even better:\\n\\n- [Dylan M. Taylor](https://github.com/dylanmtaylor) in [#671](https://github.com/containers/podman-desktop/pull/671)\\n- [Fionn Kelleher](https://github.com/osslate) in [#713](https://github.com/containers/podman-desktop/pull/713)\\n- [Rostislav Svoboda](https://github.com/rsvoboda) in [#737](https://github.com/containers/podman-desktop/pull/737)\\n- [Denis Shemanaev](https://github.com/shemanaev) in [#783](https://github.com/containers/podman-desktop/pull/783)\\n- [Fabrice Flore-Th\xe9bault](https://github.com/themr0c) in [#856](https://github.com/containers/podman-desktop/pull/856)\\n- [Kevin](https://github.com/KevinAtSesam) in [#864](https://github.com/containers/podman-desktop/pull/864)\\n- [@sfrunza13](https://github.com/sfrunza13) in [#872](https://github.com/containers/podman-desktop/pull/872)\\n- [Anjan Nath](https://github.com/anjannath) in [#918](https://github.com/containers/podman-desktop/pull/918)\\n\\n## Final Notes\\n\\nThe complete list of issues fixed in this release is available [here](https://github.com/containers/podman-desktop/issues?q=is%3Aclosed+milestone%3A0.10.0).\\n\\nGet the latest release from the [Downloads](/downloads) section of the website and boost your development journey with Podman Desktop. Additionally, visit the [GitHub repository](https://github.com/containers/podman-desktop) and see how you can help us make Podman Desktop better."},{"id":"develop-using-devcontainer","metadata":{"permalink":"/blog/develop-using-devcontainer","source":"@site/blog/2022-11-17-develop-podman-using-codespaces.md","title":"Build & run Podman Desktop in a DevContainer","description":"Develop Podman Desktop using a DevContainer locally or using GitHub Codespaces.","date":"2022-11-17T00:00:00.000Z","formattedDate":"November 17, 2022","tags":[{"label":"podman-desktop","permalink":"/blog/tags/podman-desktop"},{"label":"devcontainer","permalink":"/blog/tags/devcontainer"},{"label":"codespaces","permalink":"/blog/tags/codespaces"}],"readingTime":6.985,"hasTruncateMarker":true,"authors":[{"name":"Florent Benoit","title":"Maintainer of Podman Desktop","url":"https://github.com/benoitf","imageURL":"https://github.com/benoitf.png","key":"benoitf"}],"frontMatter":{"title":"Build & run Podman Desktop in a DevContainer","description":"Develop Podman Desktop using a DevContainer locally or using GitHub Codespaces.","slug":"develop-using-devcontainer","authors":["benoitf"],"tags":["podman-desktop","devcontainer","codespaces"],"hide_table_of_contents":false},"prevItem":{"title":"Release Notes - Podman Desktop 0.10","permalink":"/blog/podman-desktop-release-0.10"}},"content":"GitHub [announced last week](https://github.blog/changelog/2022-11-09-codespaces-for-free-and-pro-accounts/) that Codespaces is available for everyone and it includes free minutes.\\n\\nLet see how we can use a [Development Container](https://containers.dev/) having all the tools to build and run Podman Desktop. The Development Container works locally using Visual Studio Code but in this blog post we will see how it works directly with a simple click from GitHub.\\n\\nThe challenges are to run a desktop tool (Podman Desktop) and running a container engine (Podman) inside this Development Container without using too many memory !\\n\\n\x3c!--truncate--\x3e\\n\\n## Defining image of the container\\n\\nThe first thing is in the choice of the image for the container. It is possible to pick-up a default image and add some features but there is no existing feature for Podman at and most of the features are expecting to run on top of Debian/Ubuntu\\n\\nIf you are not interested in how to setup the image, jump to the [next section](#configure-the-devcontainer-using-devcontainerjson).\\n\\nPodman binaries are available quickly after the releases for Fedora. I decided then to use `Fedora 37` as the base image.\\n\\nLet start the Containerfile using:\\n\\n```docker\\nFROM quay.io/fedora/fedora:37\\n```\\n\\nThen I install Node.js 16 from official nodejs.org repository. It\'s easier to switch to the version that we need.\\n\\n```docker\\n# install Node.js + yarn\\nENV NODE_VERSION 16.18.1\\nRUN curl -SLO \\"https://nodejs.org/dist/v$NODE_VERSION/node-v$NODE_VERSION-linux-x64.tar.gz\\" && \\\\\\n tar -xzf \\"node-v$NODE_VERSION-linux-x64.tar.gz\\" -C /usr/local --strip-components=1 && \\\\\\n rm \\"node-v$NODE_VERSION-linux-x64.tar.gz\\" && \\\\\\n npm install -g yarn\\n```\\n\\nNow, all system dependencies used to run an Electron application needs to be installed.\\n\\nPodman is also installed so we can run some containers inside this container.\\n\\nAnd of course, we need to install VNC (I choose [tigervnc](https://tigervnc.org/)) with a light Window Manager ([fluxbox](http://fluxbox.org/)).\\n\\nTo connect to the display of the container, we need to expose VNC over HTML/websocket using [noVNC](https://novnc.com/)\\n\\nxterm is installed to start a terminal from the VNC side.\\n\\n```docker\\nRUN dnf -y update && \\\\\\n yum -y reinstall shadow-utils && \\\\\\n yum install -y git \\\\\\n # dependencies for Podman Desktop\\n nss \\\\\\n atk \\\\\\n at-spi2-atk \\\\\\n cups-libs \\\\\\n gtk3 \\\\\\n # for remote Display\\n fluxbox \\\\\\n tigervnc-server \\\\\\n xorg-x11-fonts-Type1 \\\\\\n novnc \\\\\\n supervisor \\\\\\n xdpyinfo \\\\\\n # for podman\\n podman \\\\\\n fuse-overlayfs --exclude container-selinux \\\\\\n xterm && \\\\\\n rm -rf /var/cache /var/log/dnf* /var/log/yum.*\\n```\\n\\nSupervisord setup the launch of the VNC server and the Window manager\\n\\n```docker\\nCOPY supervisord.conf /etc/supervisord.conf\\n```\\n\\nA custom theme for fluxbox:\\n\\n```docker\\nCOPY fluxbox /usr/share/fluxbox/init\\n```\\n\\nThen we need a special configuration to allow to have Podman working inside the container\\n\\nWe add the `podman-desktop` user with correct range on subuid and subgid when running containers. I used the [tutorial](https://github.com/containers/podman/blob/main/docs/tutorials/rootless_tutorial.md#etcsubuid-and-etcsubgid-configuration).\\n\\n```docker\\nRUN useradd -u 1000 podman-desktop && echo podman-desktop:10000:5000 > /etc/subuid && echo podman-desktop:10000:5000 > /etc/subgid\\n```\\n\\nThen use some default configuration files\\n\\n```docker\\n# initialize conf files\\nADD https://raw.githubusercontent.com/containers/libpod/master/contrib/podmanimage/stable/containers.conf /etc/containers/containers.conf\\nADD https://raw.githubusercontent.com/containers/libpod/master/contrib/podmanimage/stable/podman-containers.conf /home/podman-desktop/.config/containers/containers.conf\\n```\\n\\nand make sure that all permissions are correct following the guide [https://www.redhat.com/sysadmin/podman-inside-container](https://www.redhat.com/sysadmin/podman-inside-container)\\n\\n```docker\\n# set permissions\\nRUN chown podman-desktop:podman-desktop -R /home/podman-desktop && chmod 644 /etc/containers/containers.conf && \\\\\\n mkdir -p /var/lib/shared/overlay-images /var/lib/shared/overlay-layers /var/lib/shared/vfs-images /var/lib/shared/vfs-layers; touch /var/lib/shared/overlay-images/images.lock; touch /var/lib/shared/overlay-layers/layers.lock; touch /var/lib/shared/vfs-images/images.lock; touch /var/lib/shared/vfs-layers/layers.lock && \\\\\\n mkdir -p /run/user/1000 && chown podman-desktop:podman-desktop /run/user/1000\\n```\\n\\nplus define an empty user namespace.\\n\\n```docker\\nENV _CONTAINERS_USERNS_CONFIGURED=\\"\\"\\n```\\n\\nMake sure Podman will create the socket in an expected directory:\\n\\n```docker\\n# socket path for podman\\nENV XDG_RUNTIME_DIR=/run/user/1000\\n```\\n\\nOK ! we have a custom Containerfile providing all the tools to build and run Podman Desktop (using VNC for the display), run Podman and run Electron.\\n\\nThe current file is available at \\n\\nLet\'s configure the DevContainer.\\n\\n## Configure the DevContainer using devcontainer.json\\n\\nDevContainer definition is stored at `.devcontainer/devcontainer.json` file.\\n\\nWe need to reuse the image of the previous step. For that let\'s use the build section of the `devcontainer.json` file.\\n\\n```json\\n\\"build\\": {\\n \\"dockerfile\\": \\"Containerfile\\"\\n},\\n```\\n\\nIn order to avoid to redo all the build steps each time we open a workspace using this dev container, we published the image to quay.io at [quay.io/podman-desktop/devcontainer-parent:next\\n](https://quay.io/repository/podman-desktop/devcontainer-parent?tab=tags&tag=next). This parent image is not changing much so it\'s better to use is as a parent one.\\n\\nInside `.devcontainer` directory there is a `.parent` directory with everything related to the parent image.\\n\\nAnd in the `.devcontainer/Containerfile` file we reference this image\\n\\n```docker\\nFROM quay.io/podman-desktop/devcontainer-parent:next\\n```\\n\\nBy default, we will be `root` in the container and this is probably not what we expect. Let\'s change that.\\n\\n```json\\n\\"containerUser\\": \\"podman-desktop\\"\\n```\\n\\nSome Visual Studio Code extensions are nice to use and we can add them\\n\\n```json\\n \\"extensions\\": [\\"svelte.svelte-vscode\\", \\"bradlc.vscode-tailwindcss\\"]\\n```\\n\\nThen here is the tricky part, how to run our container allowing to run again inside the container some containers with podman.\\n\\nWe specify the arguments to make it possible. It\'s possible to use `--privileged` flag but I prefer to list the subset of permissions.\\nUsing `--privileged` we don\'t really know what are the privilege that are required while specifying all of them, people are aware of what is granted/denied.\\n\\n```json\\n\\"runArgs\\": [\\n \\"--cap-add=sys_admin\\",\\n \\"--security-opt\\",\\n \\"seccomp=unconfined\\",\\n \\"--device\\",\\n \\"/dev/fuse\\",\\n \\"--security-opt\\",\\n \\"label=disable\\",\\n \\"--security-opt\\",\\n \\"apparmor=unconfined\\"\\n ],\\n```\\n\\nSource code of Podman Desktop needs to be editable within the DevContainer so it needs to be mounted.\\n\\n```json\\n\\"workspaceMount\\": \\"source=${localWorkspaceFolder},target=/workspace,type=bind\\",\\n\\"workspaceFolder\\": \\"/workspace\\",\\n```\\n\\nThen we need a command to build Podman Desktop.\\n\\nFor that, we use `onCreateCommand` hook with a custom command\\n\\n```json\\n\\"onCreateCommand\\": \\"${containerWorkspaceFolder}/.devcontainer/onCreateCommand.sh\\",\\n```\\n\\nand in the `.devcontainer` folder the `onCreateCommand.sh` script is the following\\n\\n```shell\\n#!/bin/sh\\nyarn\\n\\nMODE=production yarn run build && yarn run electron-builder build --linux --dir --config .electron-builder.config.cjs\\n```\\n\\nTwo instructions:\\n\\n1. Fetch all Node.js dependencies.\\n2. build Podman Desktop in the `dist` folder using `Linux` as target Operating System.\\n\\nAfter the start of the container, how to launch Podman Desktop, the website and VNC, etc ?\\n\\nJust use `postStartCommand` hook.\\n\\n```json\\n\\"postStartCommand\\": \\"${containerWorkspaceFolder}/.devcontainer/postStartCommand.sh\\",\\n```\\n\\nand in the `.devcontainer` folder the `postStartCommand.sh` script is the following:\\n\\n```shell\\n#!/bin/sh\\n\\n# Start all services\\n/usr/bin/supervisord -c /etc/supervisord.conf &\\n\\n# wait X server to be ready or after 2mn exit\\necho \\"Waiting for X server to be ready\\"\\ntimeout 120 bash -c \'until xdpyinfo -display :0 &> /dev/null; do printf \\".\\"; sleep 1; done\'\\n\\n# launch podman desktop\\necho \\"Launching Podman Desktop\\"\\ncd dist/linux-unpacked/&& ./podman-desktop &\\n\\n# Launch the 9000 redirect after 20 seconds\\nsleep 20\\nwebsockify --web=/usr/share/novnc localhost:9000 localhost:5900 &\\n\\n# launch the website rendering\\necho \\"Launching Website\\"\\ncd website && yarn start\\n```\\n\\nIt starts VNC and noVNC, start precompiled Podman Desktop and start the documentation rendering.\\n\\nIt is not launching the Watch mode/development mode of Podman Desktop as it requires a container having more than 8GB of memory.\\n\\nPicking up a larger instace with for example 16GB, it\'s possible to use development mode.\\n\\nOf course, to make VNC happy, we need to specify the `DISPLAY` environment variable.\\n\\n```json\\n\\"remoteEnv\\": {\\n \\"DISPLAY\\": \\":0\\"\\n}\\n```\\n\\nWhen the DevContainer is fully available, we want to have a way to quickly open the `Website rendering URL` and `noVNC`\\n\\nLet\'s tweak the `devcontainer.json` file by adding the `portsAttributes` section\\n\\n```json\\n\\"portsAttributes\\": {\\n \\"9000\\": {\\n \\"label\\": \\"vnc\\",\\n \\"onAutoForward\\": \\"openPreview\\"\\n },\\n \\"3000\\": {\\n \\"label\\": \\"website\\"\\n }\\n}\\n```\\n\\nAfter all post-creation steps, the `Preview` browser inside the VS Code editor will open a window to VNC. And another port (`3000`) is flagged for the website.\\n\\n## Using the DevContainer.json on Github Codespace\\n\\nAs a user, opening a workspace with all what we configured is done using a single click.\\n\\nGo to then click on the `< > Code` dropdown and click on `Create codespace on main` button.\\n\\n![Open Codespace](img/develop-podman-using-codespaces/codespaces-click-repository.png)\\n\\nOnce you click on the button, the codespace is setting up:\\n\\n![Preparing Codepace](img/develop-podman-using-codespaces/codespaces-preparing-codespace.png)\\n\\nAfter few minutes, as there is not yet [prebuilt codespaces](https://docs.github.com/en/codespaces/prebuilding-your-codespaces/about-github-codespaces-prebuilds), the codespace is opening.\\n\\nThe simple Browser displays the noVNC window:\\n![Opening Codespace](img/develop-podman-using-codespaces/codespaces-open-novnc.png)\\n\\nClick on the connect button. Then on the terminal you can enter `podman run quay.io/podman/hello` and the container is detected in Podman Desktop.\\n![Testing Codespace](img/develop-podman-using-codespaces/codespaces-testing-podman-desktop.png)\\n\\nIt\'s also possible using the port widget to get on `3000` port by clicking on the world icon a preview of the website in another tab. Changing source code of the website will refresh the content of the window.\\n\\nDepending on the usecase, it\'s also possible to open documentation in the preview browser.\\n\\n![Edit website Codespace](img/develop-podman-using-codespaces/codespaces-edit-website.png)\\n\\n## Conclusion\\n\\nThe DevContainer image for Podman Desktop is recent so it\'ll probably evolve over time by adding new capabilities but it allows you to easily build/run/experiment and **contribute** to the tool or the website."}]}')}}]); \ No newline at end of file diff --git a/assets/js/de311ed4.307b490a.js b/assets/js/de311ed4.307b490a.js new file mode 100644 index 00000000000..2831273e51a --- /dev/null +++ b/assets/js/de311ed4.307b490a.js @@ -0,0 +1 @@ +"use strict";(self.webpackChunkdocs=self.webpackChunkdocs||[]).push([[1625],{35318:(e,t,n)=>{n.d(t,{Zo:()=>d,kt:()=>m});var a=n(27378);function i(e,t,n){return t in e?Object.defineProperty(e,t,{value:n,enumerable:!0,configurable:!0,writable:!0}):e[t]=n,e}function o(e,t){var n=Object.keys(e);if(Object.getOwnPropertySymbols){var a=Object.getOwnPropertySymbols(e);t&&(a=a.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),n.push.apply(n,a)}return n}function r(e){for(var t=1;t=0||(i[n]=e[n]);return i}(e,t);if(Object.getOwnPropertySymbols){var o=Object.getOwnPropertySymbols(e);for(a=0;a=0||Object.prototype.propertyIsEnumerable.call(e,n)&&(i[n]=e[n])}return i}var s=a.createContext({}),p=function(e){var t=a.useContext(s),n=t;return e&&(n="function"==typeof e?e(t):r(r({},t),e)),n},d=function(e){var t=p(e.components);return a.createElement(s.Provider,{value:t},e.children)},c={inlineCode:"code",wrapper:function(e){var t=e.children;return a.createElement(a.Fragment,{},t)}},k=a.forwardRef((function(e,t){var n=e.components,i=e.mdxType,o=e.originalType,s=e.parentName,d=l(e,["components","mdxType","originalType","parentName"]),k=p(n),m=i,u=k["".concat(s,".").concat(m)]||k[m]||c[m]||o;return n?a.createElement(u,r(r({ref:t},d),{},{components:n})):a.createElement(u,r({ref:t},d))}));function m(e,t){var n=arguments,i=t&&t.mdxType;if("string"==typeof e||i){var o=n.length,r=new Array(o);r[0]=k;var l={};for(var s in t)hasOwnProperty.call(t,s)&&(l[s]=t[s]);l.originalType=e,l.mdxType="string"==typeof e?e:i,r[1]=l;for(var p=2;p{n.r(t),n.d(t,{assets:()=>s,contentTitle:()=>r,default:()=>c,frontMatter:()=>o,metadata:()=>l,toc:()=>p});var a=n(25773),i=(n(27378),n(35318));const o={title:"Setting up and running a Kubernetes cluster locally with Podman Desktop",description:"Setting up and running a Kubernetes cluster locally with Podman Desktop",slug:"running-a-local-kubernetes-cluster-with-podman-desktop",authors:["themr0c"],tags:["podman-desktop","story","kubernetes","kind"],hide_table_of_contents:!1},r="Setting up and running a Kubernetes cluster locally with Podman Desktop",l={permalink:"/blog/running-a-local-kubernetes-cluster-with-podman-desktop",source:"@site/blog/2023-04-19-running-a-local-kubernetes-cluster-with-podman-desktop.md",title:"Setting up and running a Kubernetes cluster locally with Podman Desktop",description:"Setting up and running a Kubernetes cluster locally with Podman Desktop",date:"2023-04-19T00:00:00.000Z",formattedDate:"April 19, 2023",tags:[{label:"podman-desktop",permalink:"/blog/tags/podman-desktop"},{label:"story",permalink:"/blog/tags/story"},{label:"kubernetes",permalink:"/blog/tags/kubernetes"},{label:"kind",permalink:"/blog/tags/kind"}],readingTime:8.86,hasTruncateMarker:!0,authors:[{name:"Fabrice Flore-Thebault",title:"Technical writer",url:"https://github.com/themr0c",imageURL:"https://github.com/themr0c.png",key:"themr0c"}],frontMatter:{title:"Setting up and running a Kubernetes cluster locally with Podman Desktop",description:"Setting up and running a Kubernetes cluster locally with Podman Desktop",slug:"running-a-local-kubernetes-cluster-with-podman-desktop",authors:["themr0c"],tags:["podman-desktop","story","kubernetes","kind"],hide_table_of_contents:!1},prevItem:{title:"Release Notes - Podman Desktop 0.15",permalink:"/blog/podman-desktop-release-0.15"},nextItem:{title:"Release Notes - Podman Desktop 0.14",permalink:"/blog/podman-desktop-release-0.14"}},s={authorsImageUrls:[void 0]},p=[{value:"Installing Podman Desktop",id:"installing-podman-desktop",level:2},{value:"Installing and initializing your container engine: Podman",id:"installing-and-initializing-your-container-engine-podman",level:2},{value:"Procedure",id:"procedure",level:4},{value:"Verification",id:"verification",level:4},{value:"Installing and starting your local Kubernetes provider: Kind",id:"installing-and-starting-your-local-kubernetes-provider-kind",level:2},{value:"Verification",id:"verification-1",level:4},{value:"Additional resources",id:"additional-resources",level:4},{value:"Starting the Redis leader",id:"starting-the-redis-leader",level:2},{value:"Procedure",id:"procedure-1",level:4},{value:"Verification",id:"verification-2",level:4},{value:"Starting the Redis followers",id:"starting-the-redis-followers",level:2},{value:"Procedure",id:"procedure-2",level:4},{value:"Verification",id:"verification-3",level:4},{value:"Starting the default frontend",id:"starting-the-default-frontend",level:2},{value:"Procedure",id:"procedure-3",level:4},{value:"Verification",id:"verification-4",level:4}],d={toc:p};function c(e){let{components:t,...o}=e;return(0,i.kt)("wrapper",(0,a.Z)({},d,o,{components:t,mdxType:"MDXLayout"}),(0,i.kt)("p",null,"In this blog post you will learn to use Podman Desktop to run the ",(0,i.kt)("a",{parentName:"p",href:"https://kubernetes.io/docs/tutorials/stateless-application/guestbook/"},"Kubernetes documentation example: Deploying PHP Guestbook application with Redis"),"."),(0,i.kt)("p",null,"On the agenda:"),(0,i.kt)("ol",null,(0,i.kt)("li",{parentName:"ol"},"Installing Podman Desktop."),(0,i.kt)("li",{parentName:"ol"},"Installing and initializing your container engine: Podman."),(0,i.kt)("li",{parentName:"ol"},"Installing and starting your local Kubernetes provider: Kind."),(0,i.kt)("li",{parentName:"ol"},"Starting the Redis leader."),(0,i.kt)("li",{parentName:"ol"},"Starting and scaling the Redis followers."),(0,i.kt)("li",{parentName:"ol"},"Starting and exposing the Guestbook frontend.")),(0,i.kt)("h2",{id:"installing-podman-desktop"},"Installing Podman Desktop"),(0,i.kt)("p",null,"You need Podman Desktop."),(0,i.kt)("ol",null,(0,i.kt)("li",{parentName:"ol"},"Go to ",(0,i.kt)("a",{parentName:"li",href:"/docs/Installation"},"Podman Desktop installation documentation"),"."),(0,i.kt)("li",{parentName:"ol"},"Click on your platform name: ",(0,i.kt)("a",{parentName:"li",href:"/docs/installation/windows-install"},"Windows"),", ",(0,i.kt)("a",{parentName:"li",href:"/docs/installation/macos-install"},"macOS"),", or ",(0,i.kt)("a",{parentName:"li",href:"/docs/installation/linux-install"},"Linux"),"."),(0,i.kt)("li",{parentName:"ol"},"Follow the instructions. Stick to the default installation method."),(0,i.kt)("li",{parentName:"ol"},"Start ",(0,i.kt)("strong",{parentName:"li"},"Podman Desktop"),".")),(0,i.kt)("p",null,"At this point, you have a graphical user interface to:"),(0,i.kt)("ul",null,(0,i.kt)("li",{parentName:"ul"},"Install Podman and Kind."),(0,i.kt)("li",{parentName:"ul"},"Control and work with your container engines and Kubernetes clusters."),(0,i.kt)("li",{parentName:"ul"},"Run your application on your container engine and migrate it to Kubernetes.")),(0,i.kt)("h2",{id:"installing-and-initializing-your-container-engine-podman"},"Installing and initializing your container engine: Podman"),(0,i.kt)("p",null,"Podman Desktop can control various container engines, such as:"),(0,i.kt)("ul",null,(0,i.kt)("li",{parentName:"ul"},"Docker"),(0,i.kt)("li",{parentName:"ul"},"Lima"),(0,i.kt)("li",{parentName:"ul"},"Podman")),(0,i.kt)("p",null,"Consider installing the Podman container engine for:"),(0,i.kt)("ul",null,(0,i.kt)("li",{parentName:"ul"},"Added security"),(0,i.kt)("li",{parentName:"ul"},"No daemon"),(0,i.kt)("li",{parentName:"ul"},"Open source")),(0,i.kt)("p",null,"Containers are a Linux technology."),(0,i.kt)("ul",null,(0,i.kt)("li",{parentName:"ul"},"On Linux, you can install Podman natively.\nSee: ",(0,i.kt)("a",{parentName:"li",href:"https://podman.io/getting-started/installation#installing-on-linux"},"Installing Podman on Linux"),"."),(0,i.kt)("li",{parentName:"ul"},"On macOS and Windows, Podman requires to run in a Linux virtual machine: the Podman machine.\nUse Podman Desktop to install Podman and initialize your Podman machine:")),(0,i.kt)("h4",{id:"procedure"},"Procedure"),(0,i.kt)("ol",null,(0,i.kt)("li",{parentName:"ol"},"Open Podman Desktop ",(0,i.kt)("strong",{parentName:"li"},"Dashboard")),(0,i.kt)("li",{parentName:"ol"},"The ",(0,i.kt)("strong",{parentName:"li"},"Dashboard")," displays ",(0,i.kt)("em",{parentName:"li"},"Podman Desktop was not able to find an installation of Podman"),"."),(0,i.kt)("li",{parentName:"ol"},"Click on ",(0,i.kt)("strong",{parentName:"li"},"Install"),"."),(0,i.kt)("li",{parentName:"ol"},"Podman Desktop checks the prerequisites to install Podman Engine. When necessary, follow the instructions to install prerequisites."),(0,i.kt)("li",{parentName:"ol"},"Podman displays the dialog: ",(0,i.kt)("em",{parentName:"li"},"Podman is not installed on this system, would you like to install Podman?"),". Click on ",(0,i.kt)("strong",{parentName:"li"},"Yes")," to install Podman."),(0,i.kt)("li",{parentName:"ol"},"Click on ",(0,i.kt)("strong",{parentName:"li"},"Initialize and start"),".")),(0,i.kt)("h4",{id:"verification"},"Verification"),(0,i.kt)("ul",null,(0,i.kt)("li",{parentName:"ul"},(0,i.kt)("p",{parentName:"li"},"The ",(0,i.kt)("strong",{parentName:"p"},"Dashboard")," displays ",(0,i.kt)("em",{parentName:"p"},"Podman is running"),"."),(0,i.kt)("p",{parentName:"li"},(0,i.kt)("img",{alt:"Podman is running",src:n(65986).Z,width:"611",height:"219"})))),(0,i.kt)("p",null,"At this point, you can start working with containers."),(0,i.kt)("h2",{id:"installing-and-starting-your-local-kubernetes-provider-kind"},"Installing and starting your local Kubernetes provider: Kind"),(0,i.kt)("p",null,"You want to deploy your application to a local Kubernetes cluster."),(0,i.kt)("p",null,"Podman Desktop can help you run Kind-powered local Kubernetes clusters on a container engine, such as Podman."),(0,i.kt)("p",null,"Podman Desktop helps you ",(0,i.kt)("a",{parentName:"p",href:"/docs/kubernetes/kind/installing-kind"},"installing the ",(0,i.kt)("inlineCode",{parentName:"a"},"kind")," CLI"),":"),(0,i.kt)("ol",null,(0,i.kt)("li",{parentName:"ol"},(0,i.kt)("p",{parentName:"li"},"In the status bar, click on ",(0,i.kt)("strong",{parentName:"p"},"Kind"),", and follow the prompts.")),(0,i.kt)("li",{parentName:"ol"},(0,i.kt)("p",{parentName:"li"},"When the ",(0,i.kt)("inlineCode",{parentName:"p"},"kind")," CLI is available, the status bar does not display ",(0,i.kt)("strong",{parentName:"p"},"Kind"),".")),(0,i.kt)("li",{parentName:"ol"},(0,i.kt)("p",{parentName:"li"},"On Windows, ",(0,i.kt)("a",{parentName:"p",href:"docs/kubernetes/kind/configuring-podman-for-kind-on-windows"},"configure Podman in rootful mode")),(0,i.kt)("pre",{parentName:"li"},(0,i.kt)("code",{parentName:"pre",className:"language-shell-session"},"$ podman system connection default podman-machine-default-root\n"))),(0,i.kt)("li",{parentName:"ol"},(0,i.kt)("p",{parentName:"li"},"Go to ",(0,i.kt)("strong",{parentName:"p"},(0,i.kt)("icon",{icon:"fa-solid fa-cog",size:"lg"})," Settings > Resources"))),(0,i.kt)("li",{parentName:"ol"},(0,i.kt)("p",{parentName:"li"},"In the ",(0,i.kt)("strong",{parentName:"p"},(0,i.kt)("img",{src:"/img/podman-icon.png",alt:"Podman icon",style:{height:"1.5em",display:"inline"}})," Podman")," tile, click on the ",(0,i.kt)("strong",{parentName:"p"},(0,i.kt)("icon",{icon:"fa-solid fa-repeat",size:"lg"}))," icon to restart the Podman container engine.")),(0,i.kt)("li",{parentName:"ol"},(0,i.kt)("p",{parentName:"li"},"In the ",(0,i.kt)("strong",{parentName:"p"},(0,i.kt)("img",{src:"/img/kind-icon.png",alt:"Kind icon",style:{height:"1.5em",display:"inline"}})," Kind")," tile, click on the ",(0,i.kt)("strong",{parentName:"p"},"Create new")," button."),(0,i.kt)("ol",{parentName:"li"},(0,i.kt)("li",{parentName:"ol"},(0,i.kt)("strong",{parentName:"li"},"Name"),": enter ",(0,i.kt)("inlineCode",{parentName:"li"},"kind-cluster"),"."),(0,i.kt)("li",{parentName:"ol"},(0,i.kt)("strong",{parentName:"li"},"Provider Type"),": select ",(0,i.kt)("inlineCode",{parentName:"li"},"podman"),"."),(0,i.kt)("li",{parentName:"ol"},(0,i.kt)("strong",{parentName:"li"},"HTTP Port"),": select ",(0,i.kt)("inlineCode",{parentName:"li"},"9090"),"."),(0,i.kt)("li",{parentName:"ol"},(0,i.kt)("strong",{parentName:"li"},"HTTPS Port"),": select ",(0,i.kt)("inlineCode",{parentName:"li"},"9443"),"."),(0,i.kt)("li",{parentName:"ol"},(0,i.kt)("strong",{parentName:"li"},"Setup an ingress controller"),": ",(0,i.kt)("inlineCode",{parentName:"li"},"Enabled")),(0,i.kt)("li",{parentName:"ol"},"Click the ",(0,i.kt)("strong",{parentName:"li"},"Create")," button.\n",(0,i.kt)("img",{alt:"Create a Kind cluster screen",src:n(76893).Z,width:"793",height:"711"})))),(0,i.kt)("li",{parentName:"ol"},(0,i.kt)("p",{parentName:"li"},"After successful creation, click on the ",(0,i.kt)("strong",{parentName:"p"},"Go back to resources")," button"))),(0,i.kt)("h4",{id:"verification-1"},"Verification"),(0,i.kt)("ol",null,(0,i.kt)("li",{parentName:"ol"},(0,i.kt)("p",{parentName:"li"},"In ",(0,i.kt)("strong",{parentName:"p"},(0,i.kt)("icon",{icon:"fa-solid fa-cog",size:"lg"})," Settings > Resources")," your Kind cluster is running/"),(0,i.kt)("p",{parentName:"li"},(0,i.kt)("img",{alt:"Kind cluster is running",src:n(30712).Z,width:"452",height:"189"}))),(0,i.kt)("li",{parentName:"ol"},(0,i.kt)("p",{parentName:"li"},"In the ",(0,i.kt)("strong",{parentName:"p"},"Podman Desktop")," tray, open the ",(0,i.kt)("strong",{parentName:"p"},"Kubernetes")," menu: you can set the context to your Kind cluster: ",(0,i.kt)("inlineCode",{parentName:"p"},"kind-kind-cluster"),"."),(0,i.kt)("p",{parentName:"li"},(0,i.kt)("img",{alt:"Kind cluster Kubernetes context in the tray",src:n(10141).Z,width:"273",height:"309"})),(0,i.kt)("p",{parentName:"li"},"At this point, you can start working with containers, and your local Kubernetes cluster."))),(0,i.kt)("h4",{id:"additional-resources"},"Additional resources"),(0,i.kt)("ul",null,(0,i.kt)("li",{parentName:"ul"},(0,i.kt)("a",{parentName:"li",href:"docs/kubernetes/kind/creating-a-kind-cluster"},"Creating a local Kind-powered Kubernetes cluster"))),(0,i.kt)("h2",{id:"starting-the-redis-leader"},"Starting the Redis leader"),(0,i.kt)("p",null,"The Guestbook application uses Redis to store its data."),(0,i.kt)("p",null,"With Podman Desktop, you can prepare the Redis leader image and container on your local container engine, and deploy the results to a Kubernetes pod and service.\nThis is functionally equal to the ",(0,i.kt)("inlineCode",{parentName:"p"},"redis-leader")," deployment that the Kubernetes example propose."),(0,i.kt)("h4",{id:"procedure-1"},"Procedure"),(0,i.kt)("ol",null,(0,i.kt)("li",{parentName:"ol"},(0,i.kt)("p",{parentName:"li"},"Open ",(0,i.kt)("strong",{parentName:"p"},(0,i.kt)("icon",{icon:"fa-solid fa-cloud",size:"lg"})," Images > ",(0,i.kt)("icon",{icon:"fa-solid fa-arrow-circle-down",size:"lg"})," Pull an image"),"."),(0,i.kt)("ol",{parentName:"li"},(0,i.kt)("li",{parentName:"ol"},(0,i.kt)("strong",{parentName:"li"},"Image to Pull"),": enter ",(0,i.kt)("inlineCode",{parentName:"li"},"docker.io/redis:6.0.5")),(0,i.kt)("li",{parentName:"ol"},"Click ",(0,i.kt)("strong",{parentName:"li"},"Pull image")," to pull the image to your container engine local image registry."),(0,i.kt)("li",{parentName:"ol"},"Click ",(0,i.kt)("strong",{parentName:"li"},"Done")," to get back to the images list."))),(0,i.kt)("li",{parentName:"ol"},(0,i.kt)("p",{parentName:"li"},(0,i.kt)("strong",{parentName:"p"},(0,i.kt)("icon",{icon:"fa-solid fa-cloud",size:"lg"})," Search images"),": enter ",(0,i.kt)("inlineCode",{parentName:"p"},"redis:6.0.5")," to find the image.")),(0,i.kt)("li",{parentName:"ol"},(0,i.kt)("p",{parentName:"li"},"Click ",(0,i.kt)("strong",{parentName:"p"},(0,i.kt)("icon",{icon:"fa-solid fa-play",size:"lg"}))," to open the ",(0,i.kt)("strong",{parentName:"p"},"Create a container from image")," dialog."),(0,i.kt)("ol",{parentName:"li"},(0,i.kt)("li",{parentName:"ol"},(0,i.kt)("strong",{parentName:"li"},"Container name"),": enter ",(0,i.kt)("inlineCode",{parentName:"li"},"leader"),","),(0,i.kt)("li",{parentName:"ol"},(0,i.kt)("strong",{parentName:"li"},"Local port for ",(0,i.kt)("inlineCode",{parentName:"strong"},"6379/tcp")),": ",(0,i.kt)("inlineCode",{parentName:"li"},"6379"),"."),(0,i.kt)("li",{parentName:"ol"},"Click ",(0,i.kt)("strong",{parentName:"li"},(0,i.kt)("icon",{icon:"fa-solid fa-play",size:"lg"})," Start Container")," to start the container in your container engine."))),(0,i.kt)("li",{parentName:"ol"},(0,i.kt)("p",{parentName:"li"},(0,i.kt)("strong",{parentName:"p"},(0,i.kt)("icon",{icon:"fa-solid fa-cloud",size:"lg"})," Search containers"),": enter ",(0,i.kt)("inlineCode",{parentName:"p"},"leader")," to find the running container.")),(0,i.kt)("li",{parentName:"ol"},(0,i.kt)("p",{parentName:"li"},"Click ",(0,i.kt)("strong",{parentName:"p"},(0,i.kt)("icon",{icon:"fa-solid fa-stop",size:"lg"}))," to stop the container, and leave the ",(0,i.kt)("inlineCode",{parentName:"p"},"6379")," port available for the Redis follower container.")),(0,i.kt)("li",{parentName:"ol"},(0,i.kt)("p",{parentName:"li"},"Click ",(0,i.kt)("strong",{parentName:"p"},(0,i.kt)("icon",{icon:"fa-solid fa-ellipsis-v",size:"lg"})," > ",(0,i.kt)("icon",{icon:"fa-solid fa-rocket",size:"lg"})," Deploy to Kubernetes")," to open the ",(0,i.kt)("strong",{parentName:"p"},"Deploy generated pod to Kubernetes")," screen."),(0,i.kt)("ol",{parentName:"li"},(0,i.kt)("li",{parentName:"ol"},(0,i.kt)("strong",{parentName:"li"},"Pod Name"),": enter ",(0,i.kt)("inlineCode",{parentName:"li"},"redis-leader"),"."),(0,i.kt)("li",{parentName:"ol"},(0,i.kt)("strong",{parentName:"li"},"Use Kubernetes Services"),": select ",(0,i.kt)("strong",{parentName:"li"},"Replace ",(0,i.kt)("inlineCode",{parentName:"strong"},"hostPort")," exposure on containers by Services. It is the recommended way to expose ports, as a cluster policy might prevent to use ",(0,i.kt)("inlineCode",{parentName:"strong"},"hostPort"),".")),(0,i.kt)("li",{parentName:"ol"},(0,i.kt)("strong",{parentName:"li"},"Expose service locally using Kubernetes Ingress"),": deselect ",(0,i.kt)("strong",{parentName:"li"},"Create a Kubernetes ingress to get access to the ports that this pod exposes, at the default ingress controller location. Example: on a default Kind cluster created with Podman Desktop: ",(0,i.kt)("inlineCode",{parentName:"strong"},"http://localhost:9090"),". Requirements: your cluster has an ingress controller`"),"."),(0,i.kt)("li",{parentName:"ol"},(0,i.kt)("strong",{parentName:"li"},"Kubernetes namespaces"),": select ",(0,i.kt)("inlineCode",{parentName:"li"},"default"),"."),(0,i.kt)("li",{parentName:"ol"},"Click ",(0,i.kt)("strong",{parentName:"li"},(0,i.kt)("icon",{icon:"fa-solid fa-rocket",size:"lg"})," Deploy"),".\n",(0,i.kt)("img",{alt:"Deploy generated leader pod to Kubernetes screen",src:n(61781).Z,width:"1292",height:"968"})),(0,i.kt)("li",{parentName:"ol"},"Wait for the pod to reach the state: ",(0,i.kt)("strong",{parentName:"li"},"Phase: Running"),"."),(0,i.kt)("li",{parentName:"ol"},"Click ",(0,i.kt)("strong",{parentName:"li"},"Done"),".")))),(0,i.kt)("h4",{id:"verification-2"},"Verification"),(0,i.kt)("ul",null,(0,i.kt)("li",{parentName:"ul"},(0,i.kt)("p",{parentName:"li"},"The ",(0,i.kt)("strong",{parentName:"p"},(0,i.kt)("icon",{icon:"fa-solid fa-cubes",size:"lg"})," Pods")," screen lists the running ",(0,i.kt)("inlineCode",{parentName:"p"},"redis-leader")," pod."),(0,i.kt)("p",{parentName:"li"},(0,i.kt)("img",{alt:"leader pod is running",src:n(39272).Z,width:"684",height:"231"})))),(0,i.kt)("h2",{id:"starting-the-redis-followers"},"Starting the Redis followers"),(0,i.kt)("p",null,"Although the Redis leader is a single Pod, you can make it highly available and meet traffic demands by adding a few Redis followers, or replicas."),(0,i.kt)("p",null,(0,i.kt)("strong",{parentName:"p"},"With Podman Desktop, you can prepare the Redis follower image and container on your local container engine, and deploy the results to Kubernetes pods and services."),"\nThis is functionally equal to the ",(0,i.kt)("inlineCode",{parentName:"p"},"redis-follower")," deployment that the Kubernetes example propose."),(0,i.kt)("h4",{id:"procedure-2"},"Procedure"),(0,i.kt)("ol",null,(0,i.kt)("li",{parentName:"ol"},"Open ",(0,i.kt)("strong",{parentName:"li"},(0,i.kt)("icon",{icon:"fa-solid fa-cloud",size:"lg"})," Images > ",(0,i.kt)("icon",{icon:"fa-solid fa-arrow-circle-down",size:"lg"})," Pull an image"),".",(0,i.kt)("ol",{parentName:"li"},(0,i.kt)("li",{parentName:"ol"},(0,i.kt)("strong",{parentName:"li"},"Image to Pull"),": enter ",(0,i.kt)("inlineCode",{parentName:"li"},"gcr.io/google_samples/gb-redis-follower:v2")),(0,i.kt)("li",{parentName:"ol"},"Click ",(0,i.kt)("strong",{parentName:"li"},"Pull image")," to pull the image to your container engine local image registry."),(0,i.kt)("li",{parentName:"ol"},"Click ",(0,i.kt)("strong",{parentName:"li"},"Done")," to get back to the images list."))),(0,i.kt)("li",{parentName:"ol"},(0,i.kt)("strong",{parentName:"li"},(0,i.kt)("icon",{icon:"fa-solid fa-cloud",size:"lg"})," Search images"),": enter ",(0,i.kt)("inlineCode",{parentName:"li"},"gb-redis-follower:v2")," to find the image."),(0,i.kt)("li",{parentName:"ol"},"Click ",(0,i.kt)("strong",{parentName:"li"},(0,i.kt)("icon",{icon:"fa-solid fa-play",size:"lg"}))," to open the ",(0,i.kt)("strong",{parentName:"li"},"Create a container from image")," dialog.",(0,i.kt)("ol",{parentName:"li"},(0,i.kt)("li",{parentName:"ol"},(0,i.kt)("strong",{parentName:"li"},"Container name"),": enter ",(0,i.kt)("inlineCode",{parentName:"li"},"follower"),","),(0,i.kt)("li",{parentName:"ol"},(0,i.kt)("strong",{parentName:"li"},"Local port for ",(0,i.kt)("inlineCode",{parentName:"strong"},"6379/tcp")),": ",(0,i.kt)("inlineCode",{parentName:"li"},"6379"),"."),(0,i.kt)("li",{parentName:"ol"},"Click ",(0,i.kt)("strong",{parentName:"li"},(0,i.kt)("icon",{icon:"fa-solid fa-play",size:"lg"})," Start Container")," to start the container in your container engine."))),(0,i.kt)("li",{parentName:"ol"},(0,i.kt)("strong",{parentName:"li"},(0,i.kt)("icon",{icon:"fa-solid fa-cloud",size:"lg"})," Search containers"),": enter ",(0,i.kt)("inlineCode",{parentName:"li"},"follower")," to find the running container."),(0,i.kt)("li",{parentName:"ol"},"Click ",(0,i.kt)("strong",{parentName:"li"},(0,i.kt)("icon",{icon:"fa-solid fa-stop",size:"lg"}))," to stop the container: you do not need it to run in the container engine."),(0,i.kt)("li",{parentName:"ol"},"Click ",(0,i.kt)("strong",{parentName:"li"},(0,i.kt)("icon",{icon:"fa-solid fa-ellipsis-v",size:"lg"})," > ",(0,i.kt)("icon",{icon:"fa-solid fa-rocket",size:"lg"})," Deploy to Kubernetes")," to open the ",(0,i.kt)("strong",{parentName:"li"},"Deploy generated pod to Kubernetes")," screen.",(0,i.kt)("ol",{parentName:"li"},(0,i.kt)("li",{parentName:"ol"},(0,i.kt)("strong",{parentName:"li"},"Pod Name"),": enter ",(0,i.kt)("inlineCode",{parentName:"li"},"redis-follower"),"."),(0,i.kt)("li",{parentName:"ol"},(0,i.kt)("strong",{parentName:"li"},"Use Kubernetes Services"),": select ",(0,i.kt)("strong",{parentName:"li"},"Replace ",(0,i.kt)("inlineCode",{parentName:"strong"},"hostPort")," exposure on containers by Services. It is the recommended way to expose ports, as a cluster policy might prevent to use ",(0,i.kt)("inlineCode",{parentName:"strong"},"hostPort"),".")),(0,i.kt)("li",{parentName:"ol"},(0,i.kt)("strong",{parentName:"li"},"Expose service locally using Kubernetes Ingress"),": deselect ",(0,i.kt)("strong",{parentName:"li"},"Create a Kubernetes ingress to get access to the ports that this pod exposes, at the default ingress controller location. Example: on a default Kind cluster created with Podman Desktop: ",(0,i.kt)("inlineCode",{parentName:"strong"},"http://localhost:9090"),". Requirements: your cluster has an ingress controller`"),"."),(0,i.kt)("li",{parentName:"ol"},(0,i.kt)("strong",{parentName:"li"},"Kubernetes namespaces"),": select ",(0,i.kt)("inlineCode",{parentName:"li"},"default"),"."),(0,i.kt)("li",{parentName:"ol"},"Click ",(0,i.kt)("strong",{parentName:"li"},(0,i.kt)("icon",{icon:"fa-solid fa-rocket",size:"lg"})," Deploy"),".\n",(0,i.kt)("img",{alt:"Deploy generated follower pod to Kubernetes screen",src:n(18738).Z,width:"1292",height:"968"})),(0,i.kt)("li",{parentName:"ol"},"Wait for the pod to reach the state: ",(0,i.kt)("strong",{parentName:"li"},"Phase: Running"),"."),(0,i.kt)("li",{parentName:"ol"},"Click ",(0,i.kt)("strong",{parentName:"li"},"Done"),"."))),(0,i.kt)("li",{parentName:"ol"},"To add replicas, repeat the last step with another ",(0,i.kt)("strong",{parentName:"li"},"Pod Name")," value.")),(0,i.kt)("h4",{id:"verification-3"},"Verification"),(0,i.kt)("ul",null,(0,i.kt)("li",{parentName:"ul"},(0,i.kt)("p",{parentName:"li"},"The ",(0,i.kt)("strong",{parentName:"p"},(0,i.kt)("icon",{icon:"fa-solid fa-cubes",size:"lg"})," Pods")," screen lists the running ",(0,i.kt)("inlineCode",{parentName:"p"},"redis-follower")," pods."),(0,i.kt)("p",{parentName:"li"},(0,i.kt)("img",{alt:"follower pods are running",src:n(15740).Z,width:"668",height:"286"})))),(0,i.kt)("h2",{id:"starting-the-default-frontend"},"Starting the default frontend"),(0,i.kt)("p",null,"Now that you have the Redis storage of your Guestbook up and running, start the Guestbook web servers.\nLike the Redis followers, deploy the frontend using Kubernetes pods and services."),(0,i.kt)("p",null,"The Guestbook app uses a PHP frontend.\nIt is configured to communicate with either the Redis follower or leader Services, depending on whether the request is a read or a write.\nThe frontend exposes a JSON interface, and serves a jQuery-Ajax-based UX."),(0,i.kt)("p",null,"With Podman Desktop, you can prepare the Guestbook frontend image and container on your local container engine, and deploy the results to Kubernetes pods and services.\nThis is functionally equal to the ",(0,i.kt)("inlineCode",{parentName:"p"},"frontend")," deployment that the Kubernetes example propose."),(0,i.kt)("h4",{id:"procedure-3"},"Procedure"),(0,i.kt)("ol",null,(0,i.kt)("li",{parentName:"ol"},"Open ",(0,i.kt)("strong",{parentName:"li"},(0,i.kt)("icon",{icon:"fa-solid fa-cloud",size:"lg"})," Images > ",(0,i.kt)("icon",{icon:"fa-solid fa-arrow-circle-down",size:"lg"})," Pull an image"),".",(0,i.kt)("ol",{parentName:"li"},(0,i.kt)("li",{parentName:"ol"},(0,i.kt)("strong",{parentName:"li"},"Image to Pull"),": enter ",(0,i.kt)("inlineCode",{parentName:"li"},"gcr.io/google_samples/gb-frontend:v5")),(0,i.kt)("li",{parentName:"ol"},"Click ",(0,i.kt)("strong",{parentName:"li"},"Pull image")," to pull the image to your container engine local image registry."),(0,i.kt)("li",{parentName:"ol"},"Wait for the pull to complete."),(0,i.kt)("li",{parentName:"ol"},"Click ",(0,i.kt)("strong",{parentName:"li"},"Done")," to get back to the images list."))),(0,i.kt)("li",{parentName:"ol"},(0,i.kt)("strong",{parentName:"li"},(0,i.kt)("icon",{icon:"fa-solid fa-cloud",size:"lg"})," Search images"),": enter ",(0,i.kt)("inlineCode",{parentName:"li"},"gb-frontend:v5")," to find the image."),(0,i.kt)("li",{parentName:"ol"},"Click ",(0,i.kt)("strong",{parentName:"li"},(0,i.kt)("icon",{icon:"fa-solid fa-play",size:"lg"}))," to open the ",(0,i.kt)("strong",{parentName:"li"},"Create a container from image")," dialog.",(0,i.kt)("ol",{parentName:"li"},(0,i.kt)("li",{parentName:"ol"},(0,i.kt)("strong",{parentName:"li"},"Container name"),": enter ",(0,i.kt)("inlineCode",{parentName:"li"},"frontend"),","),(0,i.kt)("li",{parentName:"ol"},(0,i.kt)("strong",{parentName:"li"},"Local port for ",(0,i.kt)("inlineCode",{parentName:"strong"},"80/tcp")),": ",(0,i.kt)("inlineCode",{parentName:"li"},"9000"),"."),(0,i.kt)("li",{parentName:"ol"},"Click ",(0,i.kt)("strong",{parentName:"li"},(0,i.kt)("icon",{icon:"fa-solid fa-play",size:"lg"})," Start Container")," to start the container in your container engine."))),(0,i.kt)("li",{parentName:"ol"},(0,i.kt)("strong",{parentName:"li"},(0,i.kt)("icon",{icon:"fa-solid fa-cloud",size:"lg"})," Search containers"),": enter ",(0,i.kt)("inlineCode",{parentName:"li"},"frontend")," to find the running container."),(0,i.kt)("li",{parentName:"ol"},"Click ",(0,i.kt)("strong",{parentName:"li"},(0,i.kt)("icon",{icon:"fa-solid fa-stop",size:"lg"}))," to stop the container: you do not need it to run in the container engine."),(0,i.kt)("li",{parentName:"ol"},"Click ",(0,i.kt)("strong",{parentName:"li"},(0,i.kt)("icon",{icon:"fa-solid fa-ellipsis-v",size:"lg"})," > ",(0,i.kt)("icon",{icon:"fa-solid fa-rocket",size:"lg"})," Deploy to Kubernetes")," to open the ",(0,i.kt)("strong",{parentName:"li"},"Deploy generated pod to Kubernetes")," screen.",(0,i.kt)("ol",{parentName:"li"},(0,i.kt)("li",{parentName:"ol"},(0,i.kt)("strong",{parentName:"li"},"Pod Name"),": enter ",(0,i.kt)("inlineCode",{parentName:"li"},"frontend"),"."),(0,i.kt)("li",{parentName:"ol"},(0,i.kt)("strong",{parentName:"li"},"Use Kubernetes Services"),": select ",(0,i.kt)("strong",{parentName:"li"},"Replace ",(0,i.kt)("inlineCode",{parentName:"strong"},"hostPort")," exposure on containers by Services. It is the recommended way to expose ports, as a cluster policy might prevent to use ",(0,i.kt)("inlineCode",{parentName:"strong"},"hostPort"),".")),(0,i.kt)("li",{parentName:"ol"},(0,i.kt)("strong",{parentName:"li"},"Expose service locally using Kubernetes Ingress"),": select ",(0,i.kt)("strong",{parentName:"li"},"Create a Kubernetes ingress to get access to the ports that this pod exposes, at the default ingress controller location. Example: on a default Kind cluster created with Podman Desktop: ",(0,i.kt)("inlineCode",{parentName:"strong"},"http://localhost:9090"),". Requirements: your cluster has an ingress controller`"),"."),(0,i.kt)("li",{parentName:"ol"},(0,i.kt)("strong",{parentName:"li"},"Kubernetes namespaces"),": select ",(0,i.kt)("inlineCode",{parentName:"li"},"default"),"."),(0,i.kt)("li",{parentName:"ol"},"Click ",(0,i.kt)("strong",{parentName:"li"},(0,i.kt)("icon",{icon:"fa-solid fa-rocket",size:"lg"})," Deploy"),".\n",(0,i.kt)("img",{alt:"Deploy generated frontend pod to Kubernetes screen",src:n(67104).Z,width:"1292",height:"968"})),(0,i.kt)("li",{parentName:"ol"},"Wait for the pod to reach the state: ",(0,i.kt)("strong",{parentName:"li"},"Phase: Running"),"."),(0,i.kt)("li",{parentName:"ol"},"Click ",(0,i.kt)("strong",{parentName:"li"},"Done"),".")))),(0,i.kt)("h4",{id:"verification-4"},"Verification"),(0,i.kt)("ol",null,(0,i.kt)("li",{parentName:"ol"},(0,i.kt)("p",{parentName:"li"},"The ",(0,i.kt)("strong",{parentName:"p"},(0,i.kt)("icon",{icon:"fa-solid fa-cubes",size:"lg"})," Pods")," screen lists the running ",(0,i.kt)("inlineCode",{parentName:"p"},"frontend")," pod."),(0,i.kt)("p",{parentName:"li"},(0,i.kt)("img",{alt:"`frontend` pod is running",src:n(99992).Z,width:"674",height:"222"}))),(0,i.kt)("li",{parentName:"ol"},(0,i.kt)("p",{parentName:"li"},"Go to ",(0,i.kt)("inlineCode",{parentName:"p"},"http://localhost:9090"),": the Guestbook application is running."))))}c.isMDXComponent=!0},76893:(e,t,n)=>{n.d(t,{Z:()=>a});const a=n.p+"assets/images/create-a-kind-cluster-341ca1312e2e05d63d82a93726825a05.png"},18738:(e,t,n)=>{n.d(t,{Z:()=>a});const a=n.p+"assets/images/deploy-generated-follower-pod-to-kubernetes-dd643e002a1dbf69e29ef7863f0774d8.png"},67104:(e,t,n)=>{n.d(t,{Z:()=>a});const a=n.p+"assets/images/deploy-generated-frontend-pod-to-kubernetes-cf7e13dbd73427575b2cf583e223df38.png"},61781:(e,t,n)=>{n.d(t,{Z:()=>a});const a=n.p+"assets/images/deploy-generated-leader-pod-to-kubernetes-e812812296742ec54cd822d0ba969c28.png"},15740:(e,t,n)=>{n.d(t,{Z:()=>a});const a=n.p+"assets/images/follower-pods-are-running-be90e0689f30209b0694469405ecd6a9.png"},99992:(e,t,n)=>{n.d(t,{Z:()=>a});const a=n.p+"assets/images/frontend-pod-is-running-f6f55d91d200f35629788d3c550ae463.png"},10141:(e,t,n)=>{n.d(t,{Z:()=>a});const a=n.p+"assets/images/kind-cluster-context-in-the-tray-5bb9338bb1437bbcf79bf50dd401400e.png"},30712:(e,t,n)=>{n.d(t,{Z:()=>a});const a=n.p+"assets/images/kind-cluster-is-running-e721d473aa52100d8179cbb3d06e0ef9.png"},39272:(e,t,n)=>{n.d(t,{Z:()=>a});const a=n.p+"assets/images/leader-pod-is-running-a8caa174a15c06b287dff81b08041f7c.png"},65986:(e,t,n)=>{n.d(t,{Z:()=>a});const a=n.p+"assets/images/podman-is-running-745db8684c4d0240922a5aeb63e517d3.png"}}]); \ No newline at end of file diff --git a/assets/js/de311ed4.e236f50e.js b/assets/js/de311ed4.e236f50e.js deleted file mode 100644 index f00a6f9ebba..00000000000 --- a/assets/js/de311ed4.e236f50e.js +++ /dev/null @@ -1 +0,0 @@ -"use strict";(self.webpackChunkdocs=self.webpackChunkdocs||[]).push([[1625],{35318:(e,t,n)=>{n.d(t,{Zo:()=>d,kt:()=>m});var a=n(27378);function i(e,t,n){return t in e?Object.defineProperty(e,t,{value:n,enumerable:!0,configurable:!0,writable:!0}):e[t]=n,e}function o(e,t){var n=Object.keys(e);if(Object.getOwnPropertySymbols){var a=Object.getOwnPropertySymbols(e);t&&(a=a.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),n.push.apply(n,a)}return n}function r(e){for(var t=1;t=0||(i[n]=e[n]);return i}(e,t);if(Object.getOwnPropertySymbols){var o=Object.getOwnPropertySymbols(e);for(a=0;a=0||Object.prototype.propertyIsEnumerable.call(e,n)&&(i[n]=e[n])}return i}var s=a.createContext({}),p=function(e){var t=a.useContext(s),n=t;return e&&(n="function"==typeof e?e(t):r(r({},t),e)),n},d=function(e){var t=p(e.components);return a.createElement(s.Provider,{value:t},e.children)},c={inlineCode:"code",wrapper:function(e){var t=e.children;return a.createElement(a.Fragment,{},t)}},k=a.forwardRef((function(e,t){var n=e.components,i=e.mdxType,o=e.originalType,s=e.parentName,d=l(e,["components","mdxType","originalType","parentName"]),k=p(n),m=i,u=k["".concat(s,".").concat(m)]||k[m]||c[m]||o;return n?a.createElement(u,r(r({ref:t},d),{},{components:n})):a.createElement(u,r({ref:t},d))}));function m(e,t){var n=arguments,i=t&&t.mdxType;if("string"==typeof e||i){var o=n.length,r=new Array(o);r[0]=k;var l={};for(var s in t)hasOwnProperty.call(t,s)&&(l[s]=t[s]);l.originalType=e,l.mdxType="string"==typeof e?e:i,r[1]=l;for(var p=2;p{n.r(t),n.d(t,{assets:()=>s,contentTitle:()=>r,default:()=>c,frontMatter:()=>o,metadata:()=>l,toc:()=>p});var a=n(25773),i=(n(27378),n(35318));const o={title:"Setting up and running a Kubernetes cluster locally with Podman Desktop",description:"Setting up and running a Kubernetes cluster locally with Podman Desktop",slug:"running-a-local-kubernetes-cluster-with-podman-desktop",authors:["themr0c"],tags:["podman-desktop","story","kubernetes","kind"],hide_table_of_contents:!1},r="Setting up and running a Kubernetes cluster locally with Podman Desktop",l={permalink:"/blog/running-a-local-kubernetes-cluster-with-podman-desktop",source:"@site/blog/2023-04-19-running-a-local-kubernetes-cluster-with-podman-desktop.md",title:"Setting up and running a Kubernetes cluster locally with Podman Desktop",description:"Setting up and running a Kubernetes cluster locally with Podman Desktop",date:"2023-04-19T00:00:00.000Z",formattedDate:"April 19, 2023",tags:[{label:"podman-desktop",permalink:"/blog/tags/podman-desktop"},{label:"story",permalink:"/blog/tags/story"},{label:"kubernetes",permalink:"/blog/tags/kubernetes"},{label:"kind",permalink:"/blog/tags/kind"}],readingTime:8.86,hasTruncateMarker:!0,authors:[{name:"Fabrice Flore-Thebault",title:"Technical writer",url:"https://github.com/themr0c",imageURL:"https://github.com/themr0c.png",key:"themr0c"}],frontMatter:{title:"Setting up and running a Kubernetes cluster locally with Podman Desktop",description:"Setting up and running a Kubernetes cluster locally with Podman Desktop",slug:"running-a-local-kubernetes-cluster-with-podman-desktop",authors:["themr0c"],tags:["podman-desktop","story","kubernetes","kind"],hide_table_of_contents:!1},prevItem:{title:"Release Notes - Podman Desktop 0.15",permalink:"/blog/podman-desktop-release-0.15"},nextItem:{title:"Release Notes - Podman Desktop 0.14",permalink:"/blog/podman-desktop-release-0.14"}},s={authorsImageUrls:[void 0]},p=[{value:"Installing Podman Desktop",id:"installing-podman-desktop",level:2},{value:"Installing and initializing your container engine: Podman",id:"installing-and-initializing-your-container-engine-podman",level:2},{value:"Procedure",id:"procedure",level:4},{value:"Verification",id:"verification",level:4},{value:"Installing and starting your local Kubernetes provider: Kind",id:"installing-and-starting-your-local-kubernetes-provider-kind",level:2},{value:"Verification",id:"verification-1",level:4},{value:"Additional resources",id:"additional-resources",level:4},{value:"Starting the Redis leader",id:"starting-the-redis-leader",level:2},{value:"Procedure",id:"procedure-1",level:4},{value:"Verification",id:"verification-2",level:4},{value:"Starting the Redis followers",id:"starting-the-redis-followers",level:2},{value:"Procedure",id:"procedure-2",level:4},{value:"Verification",id:"verification-3",level:4},{value:"Starting the default frontend",id:"starting-the-default-frontend",level:2},{value:"Procedure",id:"procedure-3",level:4},{value:"Verification",id:"verification-4",level:4}],d={toc:p};function c(e){let{components:t,...o}=e;return(0,i.kt)("wrapper",(0,a.Z)({},d,o,{components:t,mdxType:"MDXLayout"}),(0,i.kt)("p",null,"In this blog post you will learn to use Podman Desktop to run the ",(0,i.kt)("a",{parentName:"p",href:"https://kubernetes.io/docs/tutorials/stateless-application/guestbook/"},"Kubernetes documentation example: Deploying PHP Guestbook application with Redis"),"."),(0,i.kt)("p",null,"On the agenda:"),(0,i.kt)("ol",null,(0,i.kt)("li",{parentName:"ol"},"Installing Podman Desktop."),(0,i.kt)("li",{parentName:"ol"},"Installing and initializing your container engine: Podman."),(0,i.kt)("li",{parentName:"ol"},"Installing and starting your local Kubernetes provider: Kind."),(0,i.kt)("li",{parentName:"ol"},"Starting the Redis leader."),(0,i.kt)("li",{parentName:"ol"},"Starting and scaling the Redis followers."),(0,i.kt)("li",{parentName:"ol"},"Starting and exposing the Guestbook frontend.")),(0,i.kt)("h2",{id:"installing-podman-desktop"},"Installing Podman Desktop"),(0,i.kt)("p",null,"You need Podman Desktop."),(0,i.kt)("ol",null,(0,i.kt)("li",{parentName:"ol"},"Go to ",(0,i.kt)("a",{parentName:"li",href:"/docs/Installation"},"Podman Desktop installation documentation"),"."),(0,i.kt)("li",{parentName:"ol"},"Click on your platform name: ",(0,i.kt)("a",{parentName:"li",href:"/docs/installation/windows-install"},"Windows"),", ",(0,i.kt)("a",{parentName:"li",href:"/docs/installation/macos-install"},"macOS"),", or ",(0,i.kt)("a",{parentName:"li",href:"/docs/installation/linux-install"},"Linux"),"."),(0,i.kt)("li",{parentName:"ol"},"Follow the instructions. Stick to the default installation method."),(0,i.kt)("li",{parentName:"ol"},"Start ",(0,i.kt)("strong",{parentName:"li"},"Podman Desktop"),".")),(0,i.kt)("p",null,"At this point, you have a graphical user interface to:"),(0,i.kt)("ul",null,(0,i.kt)("li",{parentName:"ul"},"Install Podman and Kind."),(0,i.kt)("li",{parentName:"ul"},"Control and work with your container engines and Kubernetes clusters."),(0,i.kt)("li",{parentName:"ul"},"Run your application on your container engine and migrate it to Kubernetes.")),(0,i.kt)("h2",{id:"installing-and-initializing-your-container-engine-podman"},"Installing and initializing your container engine: Podman"),(0,i.kt)("p",null,"Podman Desktop can control various container engines, such as:"),(0,i.kt)("ul",null,(0,i.kt)("li",{parentName:"ul"},"Docker"),(0,i.kt)("li",{parentName:"ul"},"Lima"),(0,i.kt)("li",{parentName:"ul"},"Podman")),(0,i.kt)("p",null,"Consider installing the Podman container engine for:"),(0,i.kt)("ul",null,(0,i.kt)("li",{parentName:"ul"},"Added security"),(0,i.kt)("li",{parentName:"ul"},"No daemon"),(0,i.kt)("li",{parentName:"ul"},"Open source")),(0,i.kt)("p",null,"Containers are a Linux technology."),(0,i.kt)("ul",null,(0,i.kt)("li",{parentName:"ul"},"On Linux, you can install Podman natively.\nSee: ",(0,i.kt)("a",{parentName:"li",href:"https://podman.io/docs/installation#installing-on-linux"},"Installing Podman on Linux"),"."),(0,i.kt)("li",{parentName:"ul"},"On macOS and Windows, Podman requires to run in a Linux virtual machine: the Podman machine.\nUse Podman Desktop to install Podman and initialize your Podman machine:")),(0,i.kt)("h4",{id:"procedure"},"Procedure"),(0,i.kt)("ol",null,(0,i.kt)("li",{parentName:"ol"},"Open Podman Desktop ",(0,i.kt)("strong",{parentName:"li"},"Dashboard")),(0,i.kt)("li",{parentName:"ol"},"The ",(0,i.kt)("strong",{parentName:"li"},"Dashboard")," displays ",(0,i.kt)("em",{parentName:"li"},"Podman Desktop was not able to find an installation of Podman"),"."),(0,i.kt)("li",{parentName:"ol"},"Click on ",(0,i.kt)("strong",{parentName:"li"},"Install"),"."),(0,i.kt)("li",{parentName:"ol"},"Podman Desktop checks the prerequisites to install Podman Engine. When necessary, follow the instructions to install prerequisites."),(0,i.kt)("li",{parentName:"ol"},"Podman displays the dialog: ",(0,i.kt)("em",{parentName:"li"},"Podman is not installed on this system, would you like to install Podman?"),". Click on ",(0,i.kt)("strong",{parentName:"li"},"Yes")," to install Podman."),(0,i.kt)("li",{parentName:"ol"},"Click on ",(0,i.kt)("strong",{parentName:"li"},"Initialize and start"),".")),(0,i.kt)("h4",{id:"verification"},"Verification"),(0,i.kt)("ul",null,(0,i.kt)("li",{parentName:"ul"},(0,i.kt)("p",{parentName:"li"},"The ",(0,i.kt)("strong",{parentName:"p"},"Dashboard")," displays ",(0,i.kt)("em",{parentName:"p"},"Podman is running"),"."),(0,i.kt)("p",{parentName:"li"},(0,i.kt)("img",{alt:"Podman is running",src:n(65986).Z,width:"611",height:"219"})))),(0,i.kt)("p",null,"At this point, you can start working with containers."),(0,i.kt)("h2",{id:"installing-and-starting-your-local-kubernetes-provider-kind"},"Installing and starting your local Kubernetes provider: Kind"),(0,i.kt)("p",null,"You want to deploy your application to a local Kubernetes cluster."),(0,i.kt)("p",null,"Podman Desktop can help you run Kind-powered local Kubernetes clusters on a container engine, such as Podman."),(0,i.kt)("p",null,"Podman Desktop helps you ",(0,i.kt)("a",{parentName:"p",href:"/docs/kubernetes/kind/installing-kind"},"installing the ",(0,i.kt)("inlineCode",{parentName:"a"},"kind")," CLI"),":"),(0,i.kt)("ol",null,(0,i.kt)("li",{parentName:"ol"},(0,i.kt)("p",{parentName:"li"},"In the status bar, click on ",(0,i.kt)("strong",{parentName:"p"},"Kind"),", and follow the prompts.")),(0,i.kt)("li",{parentName:"ol"},(0,i.kt)("p",{parentName:"li"},"When the ",(0,i.kt)("inlineCode",{parentName:"p"},"kind")," CLI is available, the status bar does not display ",(0,i.kt)("strong",{parentName:"p"},"Kind"),".")),(0,i.kt)("li",{parentName:"ol"},(0,i.kt)("p",{parentName:"li"},"On Windows, ",(0,i.kt)("a",{parentName:"p",href:"/docs/kubernetes/kind/configuring-podman-for-kind-on-windows"},"configure Podman in rootful mode")),(0,i.kt)("pre",{parentName:"li"},(0,i.kt)("code",{parentName:"pre",className:"language-shell-session"},"$ podman system connection default podman-machine-default-root\n"))),(0,i.kt)("li",{parentName:"ol"},(0,i.kt)("p",{parentName:"li"},"Go to ",(0,i.kt)("strong",{parentName:"p"},(0,i.kt)("icon",{icon:"fa-solid fa-cog",size:"lg"})," Settings > Resources"))),(0,i.kt)("li",{parentName:"ol"},(0,i.kt)("p",{parentName:"li"},"In the ",(0,i.kt)("strong",{parentName:"p"},(0,i.kt)("img",{src:"/img/podman-icon.png",alt:"Podman icon",style:{height:"1.5em",display:"inline"}})," Podman")," tile, click on the ",(0,i.kt)("strong",{parentName:"p"},(0,i.kt)("icon",{icon:"fa-solid fa-repeat",size:"lg"}))," icon to restart the Podman container engine.")),(0,i.kt)("li",{parentName:"ol"},(0,i.kt)("p",{parentName:"li"},"In the ",(0,i.kt)("strong",{parentName:"p"},(0,i.kt)("img",{src:"/img/kind-icon.png",alt:"Kind icon",style:{height:"1.5em",display:"inline"}})," Kind")," tile, click on the ",(0,i.kt)("strong",{parentName:"p"},"Create new")," button."),(0,i.kt)("ol",{parentName:"li"},(0,i.kt)("li",{parentName:"ol"},(0,i.kt)("strong",{parentName:"li"},"Name"),": enter ",(0,i.kt)("inlineCode",{parentName:"li"},"kind-cluster"),"."),(0,i.kt)("li",{parentName:"ol"},(0,i.kt)("strong",{parentName:"li"},"Provider Type"),": select ",(0,i.kt)("inlineCode",{parentName:"li"},"podman"),"."),(0,i.kt)("li",{parentName:"ol"},(0,i.kt)("strong",{parentName:"li"},"HTTP Port"),": select ",(0,i.kt)("inlineCode",{parentName:"li"},"9090"),"."),(0,i.kt)("li",{parentName:"ol"},(0,i.kt)("strong",{parentName:"li"},"HTTPS Port"),": select ",(0,i.kt)("inlineCode",{parentName:"li"},"9443"),"."),(0,i.kt)("li",{parentName:"ol"},(0,i.kt)("strong",{parentName:"li"},"Setup an ingress controller"),": ",(0,i.kt)("inlineCode",{parentName:"li"},"Enabled")),(0,i.kt)("li",{parentName:"ol"},"Click the ",(0,i.kt)("strong",{parentName:"li"},"Create")," button.\n",(0,i.kt)("img",{alt:"Create a Kind cluster screen",src:n(76893).Z,width:"793",height:"711"})))),(0,i.kt)("li",{parentName:"ol"},(0,i.kt)("p",{parentName:"li"},"After successful creation, click on the ",(0,i.kt)("strong",{parentName:"p"},"Go back to resources")," button"))),(0,i.kt)("h4",{id:"verification-1"},"Verification"),(0,i.kt)("ol",null,(0,i.kt)("li",{parentName:"ol"},(0,i.kt)("p",{parentName:"li"},"In ",(0,i.kt)("strong",{parentName:"p"},(0,i.kt)("icon",{icon:"fa-solid fa-cog",size:"lg"})," Settings > Resources")," your Kind cluster is running/"),(0,i.kt)("p",{parentName:"li"},(0,i.kt)("img",{alt:"Kind cluster is running",src:n(30712).Z,width:"452",height:"189"}))),(0,i.kt)("li",{parentName:"ol"},(0,i.kt)("p",{parentName:"li"},"In the ",(0,i.kt)("strong",{parentName:"p"},"Podman Desktop")," tray, open the ",(0,i.kt)("strong",{parentName:"p"},"Kubernetes")," menu: you can set the context to your Kind cluster: ",(0,i.kt)("inlineCode",{parentName:"p"},"kind-kind-cluster"),"."),(0,i.kt)("p",{parentName:"li"},(0,i.kt)("img",{alt:"Kind cluster Kubernetes context in the tray",src:n(10141).Z,width:"273",height:"309"})),(0,i.kt)("p",{parentName:"li"},"At this point, you can start working with containers, and your local Kubernetes cluster."))),(0,i.kt)("h4",{id:"additional-resources"},"Additional resources"),(0,i.kt)("ul",null,(0,i.kt)("li",{parentName:"ul"},(0,i.kt)("a",{parentName:"li",href:"/docs/kubernetes/kind/creating-a-kind-cluster"},"Creating a local Kind-powered Kubernetes cluster"))),(0,i.kt)("h2",{id:"starting-the-redis-leader"},"Starting the Redis leader"),(0,i.kt)("p",null,"The Guestbook application uses Redis to store its data."),(0,i.kt)("p",null,"With Podman Desktop, you can prepare the Redis leader image and container on your local container engine, and deploy the results to a Kubernetes pod and service.\nThis is functionally equal to the ",(0,i.kt)("inlineCode",{parentName:"p"},"redis-leader")," deployment that the Kubernetes example propose."),(0,i.kt)("h4",{id:"procedure-1"},"Procedure"),(0,i.kt)("ol",null,(0,i.kt)("li",{parentName:"ol"},(0,i.kt)("p",{parentName:"li"},"Open ",(0,i.kt)("strong",{parentName:"p"},(0,i.kt)("icon",{icon:"fa-solid fa-cloud",size:"lg"})," Images > ",(0,i.kt)("icon",{icon:"fa-solid fa-arrow-circle-down",size:"lg"})," Pull an image"),"."),(0,i.kt)("ol",{parentName:"li"},(0,i.kt)("li",{parentName:"ol"},(0,i.kt)("strong",{parentName:"li"},"Image to Pull"),": enter ",(0,i.kt)("inlineCode",{parentName:"li"},"docker.io/redis:6.0.5")),(0,i.kt)("li",{parentName:"ol"},"Click ",(0,i.kt)("strong",{parentName:"li"},"Pull image")," to pull the image to your container engine local image registry."),(0,i.kt)("li",{parentName:"ol"},"Click ",(0,i.kt)("strong",{parentName:"li"},"Done")," to get back to the images list."))),(0,i.kt)("li",{parentName:"ol"},(0,i.kt)("p",{parentName:"li"},(0,i.kt)("strong",{parentName:"p"},(0,i.kt)("icon",{icon:"fa-solid fa-cloud",size:"lg"})," Search images"),": enter ",(0,i.kt)("inlineCode",{parentName:"p"},"redis:6.0.5")," to find the image.")),(0,i.kt)("li",{parentName:"ol"},(0,i.kt)("p",{parentName:"li"},"Click ",(0,i.kt)("strong",{parentName:"p"},(0,i.kt)("icon",{icon:"fa-solid fa-play",size:"lg"}))," to open the ",(0,i.kt)("strong",{parentName:"p"},"Create a container from image")," dialog."),(0,i.kt)("ol",{parentName:"li"},(0,i.kt)("li",{parentName:"ol"},(0,i.kt)("strong",{parentName:"li"},"Container name"),": enter ",(0,i.kt)("inlineCode",{parentName:"li"},"leader"),","),(0,i.kt)("li",{parentName:"ol"},(0,i.kt)("strong",{parentName:"li"},"Local port for ",(0,i.kt)("inlineCode",{parentName:"strong"},"6379/tcp")),": ",(0,i.kt)("inlineCode",{parentName:"li"},"6379"),"."),(0,i.kt)("li",{parentName:"ol"},"Click ",(0,i.kt)("strong",{parentName:"li"},(0,i.kt)("icon",{icon:"fa-solid fa-play",size:"lg"})," Start Container")," to start the container in your container engine."))),(0,i.kt)("li",{parentName:"ol"},(0,i.kt)("p",{parentName:"li"},(0,i.kt)("strong",{parentName:"p"},(0,i.kt)("icon",{icon:"fa-solid fa-cloud",size:"lg"})," Search containers"),": enter ",(0,i.kt)("inlineCode",{parentName:"p"},"leader")," to find the running container.")),(0,i.kt)("li",{parentName:"ol"},(0,i.kt)("p",{parentName:"li"},"Click ",(0,i.kt)("strong",{parentName:"p"},(0,i.kt)("icon",{icon:"fa-solid fa-stop",size:"lg"}))," to stop the container, and leave the ",(0,i.kt)("inlineCode",{parentName:"p"},"6379")," port available for the Redis follower container.")),(0,i.kt)("li",{parentName:"ol"},(0,i.kt)("p",{parentName:"li"},"Click ",(0,i.kt)("strong",{parentName:"p"},(0,i.kt)("icon",{icon:"fa-solid fa-ellipsis-v",size:"lg"})," > ",(0,i.kt)("icon",{icon:"fa-solid fa-rocket",size:"lg"})," Deploy to Kubernetes")," to open the ",(0,i.kt)("strong",{parentName:"p"},"Deploy generated pod to Kubernetes")," screen."),(0,i.kt)("ol",{parentName:"li"},(0,i.kt)("li",{parentName:"ol"},(0,i.kt)("strong",{parentName:"li"},"Pod Name"),": enter ",(0,i.kt)("inlineCode",{parentName:"li"},"redis-leader"),"."),(0,i.kt)("li",{parentName:"ol"},(0,i.kt)("strong",{parentName:"li"},"Use Kubernetes Services"),": select ",(0,i.kt)("strong",{parentName:"li"},"Replace ",(0,i.kt)("inlineCode",{parentName:"strong"},"hostPort")," exposure on containers by Services. It is the recommended way to expose ports, as a cluster policy might prevent to use ",(0,i.kt)("inlineCode",{parentName:"strong"},"hostPort"),".")),(0,i.kt)("li",{parentName:"ol"},(0,i.kt)("strong",{parentName:"li"},"Expose service locally using Kubernetes Ingress"),": deselect ",(0,i.kt)("strong",{parentName:"li"},"Create a Kubernetes ingress to get access to the ports that this pod exposes, at the default ingress controller location. Example: on a default Kind cluster created with Podman Desktop: ",(0,i.kt)("inlineCode",{parentName:"strong"},"http://localhost:9090"),". Requirements: your cluster has an ingress controller`"),"."),(0,i.kt)("li",{parentName:"ol"},(0,i.kt)("strong",{parentName:"li"},"Kubernetes namespaces"),": select ",(0,i.kt)("inlineCode",{parentName:"li"},"default"),"."),(0,i.kt)("li",{parentName:"ol"},"Click ",(0,i.kt)("strong",{parentName:"li"},(0,i.kt)("icon",{icon:"fa-solid fa-rocket",size:"lg"})," Deploy"),".\n",(0,i.kt)("img",{alt:"Deploy generated leader pod to Kubernetes screen",src:n(61781).Z,width:"1292",height:"968"})),(0,i.kt)("li",{parentName:"ol"},"Wait for the pod to reach the state: ",(0,i.kt)("strong",{parentName:"li"},"Phase: Running"),"."),(0,i.kt)("li",{parentName:"ol"},"Click ",(0,i.kt)("strong",{parentName:"li"},"Done"),".")))),(0,i.kt)("h4",{id:"verification-2"},"Verification"),(0,i.kt)("ul",null,(0,i.kt)("li",{parentName:"ul"},(0,i.kt)("p",{parentName:"li"},"The ",(0,i.kt)("strong",{parentName:"p"},(0,i.kt)("icon",{icon:"fa-solid fa-cubes",size:"lg"})," Pods")," screen lists the running ",(0,i.kt)("inlineCode",{parentName:"p"},"redis-leader")," pod."),(0,i.kt)("p",{parentName:"li"},(0,i.kt)("img",{alt:"leader pod is running",src:n(39272).Z,width:"684",height:"231"})))),(0,i.kt)("h2",{id:"starting-the-redis-followers"},"Starting the Redis followers"),(0,i.kt)("p",null,"Although the Redis leader is a single Pod, you can make it highly available and meet traffic demands by adding a few Redis followers, or replicas."),(0,i.kt)("p",null,(0,i.kt)("strong",{parentName:"p"},"With Podman Desktop, you can prepare the Redis follower image and container on your local container engine, and deploy the results to Kubernetes pods and services."),"\nThis is functionally equal to the ",(0,i.kt)("inlineCode",{parentName:"p"},"redis-follower")," deployment that the Kubernetes example propose."),(0,i.kt)("h4",{id:"procedure-2"},"Procedure"),(0,i.kt)("ol",null,(0,i.kt)("li",{parentName:"ol"},"Open ",(0,i.kt)("strong",{parentName:"li"},(0,i.kt)("icon",{icon:"fa-solid fa-cloud",size:"lg"})," Images > ",(0,i.kt)("icon",{icon:"fa-solid fa-arrow-circle-down",size:"lg"})," Pull an image"),".",(0,i.kt)("ol",{parentName:"li"},(0,i.kt)("li",{parentName:"ol"},(0,i.kt)("strong",{parentName:"li"},"Image to Pull"),": enter ",(0,i.kt)("inlineCode",{parentName:"li"},"gcr.io/google_samples/gb-redis-follower:v2")),(0,i.kt)("li",{parentName:"ol"},"Click ",(0,i.kt)("strong",{parentName:"li"},"Pull image")," to pull the image to your container engine local image registry."),(0,i.kt)("li",{parentName:"ol"},"Click ",(0,i.kt)("strong",{parentName:"li"},"Done")," to get back to the images list."))),(0,i.kt)("li",{parentName:"ol"},(0,i.kt)("strong",{parentName:"li"},(0,i.kt)("icon",{icon:"fa-solid fa-cloud",size:"lg"})," Search images"),": enter ",(0,i.kt)("inlineCode",{parentName:"li"},"gb-redis-follower:v2")," to find the image."),(0,i.kt)("li",{parentName:"ol"},"Click ",(0,i.kt)("strong",{parentName:"li"},(0,i.kt)("icon",{icon:"fa-solid fa-play",size:"lg"}))," to open the ",(0,i.kt)("strong",{parentName:"li"},"Create a container from image")," dialog.",(0,i.kt)("ol",{parentName:"li"},(0,i.kt)("li",{parentName:"ol"},(0,i.kt)("strong",{parentName:"li"},"Container name"),": enter ",(0,i.kt)("inlineCode",{parentName:"li"},"follower"),","),(0,i.kt)("li",{parentName:"ol"},(0,i.kt)("strong",{parentName:"li"},"Local port for ",(0,i.kt)("inlineCode",{parentName:"strong"},"6379/tcp")),": ",(0,i.kt)("inlineCode",{parentName:"li"},"6379"),"."),(0,i.kt)("li",{parentName:"ol"},"Click ",(0,i.kt)("strong",{parentName:"li"},(0,i.kt)("icon",{icon:"fa-solid fa-play",size:"lg"})," Start Container")," to start the container in your container engine."))),(0,i.kt)("li",{parentName:"ol"},(0,i.kt)("strong",{parentName:"li"},(0,i.kt)("icon",{icon:"fa-solid fa-cloud",size:"lg"})," Search containers"),": enter ",(0,i.kt)("inlineCode",{parentName:"li"},"follower")," to find the running container."),(0,i.kt)("li",{parentName:"ol"},"Click ",(0,i.kt)("strong",{parentName:"li"},(0,i.kt)("icon",{icon:"fa-solid fa-stop",size:"lg"}))," to stop the container: you do not need it to run in the container engine."),(0,i.kt)("li",{parentName:"ol"},"Click ",(0,i.kt)("strong",{parentName:"li"},(0,i.kt)("icon",{icon:"fa-solid fa-ellipsis-v",size:"lg"})," > ",(0,i.kt)("icon",{icon:"fa-solid fa-rocket",size:"lg"})," Deploy to Kubernetes")," to open the ",(0,i.kt)("strong",{parentName:"li"},"Deploy generated pod to Kubernetes")," screen.",(0,i.kt)("ol",{parentName:"li"},(0,i.kt)("li",{parentName:"ol"},(0,i.kt)("strong",{parentName:"li"},"Pod Name"),": enter ",(0,i.kt)("inlineCode",{parentName:"li"},"redis-follower"),"."),(0,i.kt)("li",{parentName:"ol"},(0,i.kt)("strong",{parentName:"li"},"Use Kubernetes Services"),": select ",(0,i.kt)("strong",{parentName:"li"},"Replace ",(0,i.kt)("inlineCode",{parentName:"strong"},"hostPort")," exposure on containers by Services. It is the recommended way to expose ports, as a cluster policy might prevent to use ",(0,i.kt)("inlineCode",{parentName:"strong"},"hostPort"),".")),(0,i.kt)("li",{parentName:"ol"},(0,i.kt)("strong",{parentName:"li"},"Expose service locally using Kubernetes Ingress"),": deselect ",(0,i.kt)("strong",{parentName:"li"},"Create a Kubernetes ingress to get access to the ports that this pod exposes, at the default ingress controller location. Example: on a default Kind cluster created with Podman Desktop: ",(0,i.kt)("inlineCode",{parentName:"strong"},"http://localhost:9090"),". Requirements: your cluster has an ingress controller`"),"."),(0,i.kt)("li",{parentName:"ol"},(0,i.kt)("strong",{parentName:"li"},"Kubernetes namespaces"),": select ",(0,i.kt)("inlineCode",{parentName:"li"},"default"),"."),(0,i.kt)("li",{parentName:"ol"},"Click ",(0,i.kt)("strong",{parentName:"li"},(0,i.kt)("icon",{icon:"fa-solid fa-rocket",size:"lg"})," Deploy"),".\n",(0,i.kt)("img",{alt:"Deploy generated follower pod to Kubernetes screen",src:n(18738).Z,width:"1292",height:"968"})),(0,i.kt)("li",{parentName:"ol"},"Wait for the pod to reach the state: ",(0,i.kt)("strong",{parentName:"li"},"Phase: Running"),"."),(0,i.kt)("li",{parentName:"ol"},"Click ",(0,i.kt)("strong",{parentName:"li"},"Done"),"."))),(0,i.kt)("li",{parentName:"ol"},"To add replicas, repeat the last step with another ",(0,i.kt)("strong",{parentName:"li"},"Pod Name")," value.")),(0,i.kt)("h4",{id:"verification-3"},"Verification"),(0,i.kt)("ul",null,(0,i.kt)("li",{parentName:"ul"},(0,i.kt)("p",{parentName:"li"},"The ",(0,i.kt)("strong",{parentName:"p"},(0,i.kt)("icon",{icon:"fa-solid fa-cubes",size:"lg"})," Pods")," screen lists the running ",(0,i.kt)("inlineCode",{parentName:"p"},"redis-follower")," pods."),(0,i.kt)("p",{parentName:"li"},(0,i.kt)("img",{alt:"follower pods are running",src:n(15740).Z,width:"668",height:"286"})))),(0,i.kt)("h2",{id:"starting-the-default-frontend"},"Starting the default frontend"),(0,i.kt)("p",null,"Now that you have the Redis storage of your Guestbook up and running, start the Guestbook web servers.\nLike the Redis followers, deploy the frontend using Kubernetes pods and services."),(0,i.kt)("p",null,"The Guestbook app uses a PHP frontend.\nIt is configured to communicate with either the Redis follower or leader Services, depending on whether the request is a read or a write.\nThe frontend exposes a JSON interface, and serves a jQuery-Ajax-based UX."),(0,i.kt)("p",null,"With Podman Desktop, you can prepare the Guestbook frontend image and container on your local container engine, and deploy the results to Kubernetes pods and services.\nThis is functionally equal to the ",(0,i.kt)("inlineCode",{parentName:"p"},"frontend")," deployment that the Kubernetes example propose."),(0,i.kt)("h4",{id:"procedure-3"},"Procedure"),(0,i.kt)("ol",null,(0,i.kt)("li",{parentName:"ol"},"Open ",(0,i.kt)("strong",{parentName:"li"},(0,i.kt)("icon",{icon:"fa-solid fa-cloud",size:"lg"})," Images > ",(0,i.kt)("icon",{icon:"fa-solid fa-arrow-circle-down",size:"lg"})," Pull an image"),".",(0,i.kt)("ol",{parentName:"li"},(0,i.kt)("li",{parentName:"ol"},(0,i.kt)("strong",{parentName:"li"},"Image to Pull"),": enter ",(0,i.kt)("inlineCode",{parentName:"li"},"gcr.io/google_samples/gb-frontend:v5")),(0,i.kt)("li",{parentName:"ol"},"Click ",(0,i.kt)("strong",{parentName:"li"},"Pull image")," to pull the image to your container engine local image registry."),(0,i.kt)("li",{parentName:"ol"},"Wait for the pull to complete."),(0,i.kt)("li",{parentName:"ol"},"Click ",(0,i.kt)("strong",{parentName:"li"},"Done")," to get back to the images list."))),(0,i.kt)("li",{parentName:"ol"},(0,i.kt)("strong",{parentName:"li"},(0,i.kt)("icon",{icon:"fa-solid fa-cloud",size:"lg"})," Search images"),": enter ",(0,i.kt)("inlineCode",{parentName:"li"},"gb-frontend:v5")," to find the image."),(0,i.kt)("li",{parentName:"ol"},"Click ",(0,i.kt)("strong",{parentName:"li"},(0,i.kt)("icon",{icon:"fa-solid fa-play",size:"lg"}))," to open the ",(0,i.kt)("strong",{parentName:"li"},"Create a container from image")," dialog.",(0,i.kt)("ol",{parentName:"li"},(0,i.kt)("li",{parentName:"ol"},(0,i.kt)("strong",{parentName:"li"},"Container name"),": enter ",(0,i.kt)("inlineCode",{parentName:"li"},"frontend"),","),(0,i.kt)("li",{parentName:"ol"},(0,i.kt)("strong",{parentName:"li"},"Local port for ",(0,i.kt)("inlineCode",{parentName:"strong"},"80/tcp")),": ",(0,i.kt)("inlineCode",{parentName:"li"},"9000"),"."),(0,i.kt)("li",{parentName:"ol"},"Click ",(0,i.kt)("strong",{parentName:"li"},(0,i.kt)("icon",{icon:"fa-solid fa-play",size:"lg"})," Start Container")," to start the container in your container engine."))),(0,i.kt)("li",{parentName:"ol"},(0,i.kt)("strong",{parentName:"li"},(0,i.kt)("icon",{icon:"fa-solid fa-cloud",size:"lg"})," Search containers"),": enter ",(0,i.kt)("inlineCode",{parentName:"li"},"frontend")," to find the running container."),(0,i.kt)("li",{parentName:"ol"},"Click ",(0,i.kt)("strong",{parentName:"li"},(0,i.kt)("icon",{icon:"fa-solid fa-stop",size:"lg"}))," to stop the container: you do not need it to run in the container engine."),(0,i.kt)("li",{parentName:"ol"},"Click ",(0,i.kt)("strong",{parentName:"li"},(0,i.kt)("icon",{icon:"fa-solid fa-ellipsis-v",size:"lg"})," > ",(0,i.kt)("icon",{icon:"fa-solid fa-rocket",size:"lg"})," Deploy to Kubernetes")," to open the ",(0,i.kt)("strong",{parentName:"li"},"Deploy generated pod to Kubernetes")," screen.",(0,i.kt)("ol",{parentName:"li"},(0,i.kt)("li",{parentName:"ol"},(0,i.kt)("strong",{parentName:"li"},"Pod Name"),": enter ",(0,i.kt)("inlineCode",{parentName:"li"},"frontend"),"."),(0,i.kt)("li",{parentName:"ol"},(0,i.kt)("strong",{parentName:"li"},"Use Kubernetes Services"),": select ",(0,i.kt)("strong",{parentName:"li"},"Replace ",(0,i.kt)("inlineCode",{parentName:"strong"},"hostPort")," exposure on containers by Services. It is the recommended way to expose ports, as a cluster policy might prevent to use ",(0,i.kt)("inlineCode",{parentName:"strong"},"hostPort"),".")),(0,i.kt)("li",{parentName:"ol"},(0,i.kt)("strong",{parentName:"li"},"Expose service locally using Kubernetes Ingress"),": select ",(0,i.kt)("strong",{parentName:"li"},"Create a Kubernetes ingress to get access to the ports that this pod exposes, at the default ingress controller location. Example: on a default Kind cluster created with Podman Desktop: ",(0,i.kt)("inlineCode",{parentName:"strong"},"http://localhost:9090"),". Requirements: your cluster has an ingress controller`"),"."),(0,i.kt)("li",{parentName:"ol"},(0,i.kt)("strong",{parentName:"li"},"Kubernetes namespaces"),": select ",(0,i.kt)("inlineCode",{parentName:"li"},"default"),"."),(0,i.kt)("li",{parentName:"ol"},"Click ",(0,i.kt)("strong",{parentName:"li"},(0,i.kt)("icon",{icon:"fa-solid fa-rocket",size:"lg"})," Deploy"),".\n",(0,i.kt)("img",{alt:"Deploy generated frontend pod to Kubernetes screen",src:n(67104).Z,width:"1292",height:"968"})),(0,i.kt)("li",{parentName:"ol"},"Wait for the pod to reach the state: ",(0,i.kt)("strong",{parentName:"li"},"Phase: Running"),"."),(0,i.kt)("li",{parentName:"ol"},"Click ",(0,i.kt)("strong",{parentName:"li"},"Done"),".")))),(0,i.kt)("h4",{id:"verification-4"},"Verification"),(0,i.kt)("ol",null,(0,i.kt)("li",{parentName:"ol"},(0,i.kt)("p",{parentName:"li"},"The ",(0,i.kt)("strong",{parentName:"p"},(0,i.kt)("icon",{icon:"fa-solid fa-cubes",size:"lg"})," Pods")," screen lists the running ",(0,i.kt)("inlineCode",{parentName:"p"},"frontend")," pod."),(0,i.kt)("p",{parentName:"li"},(0,i.kt)("img",{alt:"`frontend` pod is running",src:n(99992).Z,width:"674",height:"222"}))),(0,i.kt)("li",{parentName:"ol"},(0,i.kt)("p",{parentName:"li"},"Go to ",(0,i.kt)("inlineCode",{parentName:"p"},"http://localhost:9090"),": the Guestbook application is running."))))}c.isMDXComponent=!0},76893:(e,t,n)=>{n.d(t,{Z:()=>a});const a=n.p+"assets/images/create-a-kind-cluster-341ca1312e2e05d63d82a93726825a05.png"},18738:(e,t,n)=>{n.d(t,{Z:()=>a});const a=n.p+"assets/images/deploy-generated-follower-pod-to-kubernetes-dd643e002a1dbf69e29ef7863f0774d8.png"},67104:(e,t,n)=>{n.d(t,{Z:()=>a});const a=n.p+"assets/images/deploy-generated-frontend-pod-to-kubernetes-cf7e13dbd73427575b2cf583e223df38.png"},61781:(e,t,n)=>{n.d(t,{Z:()=>a});const a=n.p+"assets/images/deploy-generated-leader-pod-to-kubernetes-e812812296742ec54cd822d0ba969c28.png"},15740:(e,t,n)=>{n.d(t,{Z:()=>a});const a=n.p+"assets/images/follower-pods-are-running-be90e0689f30209b0694469405ecd6a9.png"},99992:(e,t,n)=>{n.d(t,{Z:()=>a});const a=n.p+"assets/images/frontend-pod-is-running-f6f55d91d200f35629788d3c550ae463.png"},10141:(e,t,n)=>{n.d(t,{Z:()=>a});const a=n.p+"assets/images/kind-cluster-context-in-the-tray-5bb9338bb1437bbcf79bf50dd401400e.png"},30712:(e,t,n)=>{n.d(t,{Z:()=>a});const a=n.p+"assets/images/kind-cluster-is-running-e721d473aa52100d8179cbb3d06e0ef9.png"},39272:(e,t,n)=>{n.d(t,{Z:()=>a});const a=n.p+"assets/images/leader-pod-is-running-a8caa174a15c06b287dff81b08041f7c.png"},65986:(e,t,n)=>{n.d(t,{Z:()=>a});const a=n.p+"assets/images/podman-is-running-745db8684c4d0240922a5aeb63e517d3.png"}}]); \ No newline at end of file diff --git a/assets/js/runtime~main.345aa351.js b/assets/js/runtime~main.ca3ed97a.js similarity index 98% rename from assets/js/runtime~main.345aa351.js rename to assets/js/runtime~main.ca3ed97a.js index 3f64dc1f4fb..a242783e83f 100644 --- a/assets/js/runtime~main.345aa351.js +++ b/assets/js/runtime~main.ca3ed97a.js @@ -1 +1 @@ -(()=>{"use strict";var e,a,c,f,d,b={},t={};function r(e){var a=t[e];if(void 0!==a)return a.exports;var c=t[e]={exports:{}};return b[e].call(c.exports,c,c.exports,r),c.exports}r.m=b,e=[],r.O=(a,c,f,d)=>{if(!c){var b=1/0;for(i=0;i=d)&&Object.keys(r.O).every((e=>r.O[e](c[o])))?c.splice(o--,1):(t=!1,d0&&e[i-1][2]>d;i--)e[i]=e[i-1];e[i]=[c,f,d]},r.n=e=>{var a=e&&e.__esModule?()=>e.default:()=>e;return r.d(a,{a:a}),a},c=Object.getPrototypeOf?e=>Object.getPrototypeOf(e):e=>e.__proto__,r.t=function(e,f){if(1&f&&(e=this(e)),8&f)return e;if("object"==typeof e&&e){if(4&f&&e.__esModule)return e;if(16&f&&"function"==typeof e.then)return e}var d=Object.create(null);r.r(d);var b={};a=a||[null,c({}),c([]),c(c)];for(var t=2&f&&e;"object"==typeof t&&!~a.indexOf(t);t=c(t))Object.getOwnPropertyNames(t).forEach((a=>b[a]=()=>e[a]));return b.default=()=>e,r.d(d,b),d},r.d=(e,a)=>{for(var c in a)r.o(a,c)&&!r.o(e,c)&&Object.defineProperty(e,c,{enumerable:!0,get:a[c]})},r.f={},r.e=e=>Promise.all(Object.keys(r.f).reduce(((a,c)=>(r.f[c](e,a),a)),[])),r.u=e=>"assets/js/"+({10:"33942509",53:"935f2afb",70:"86f2a982",83:"09905e74",93:"4305e853",114:"e665718d",138:"54590fd2",182:"c276ecb2",205:"83d480e9",210:"3c6cc7c6",397:"6194ac84",465:"f7b7f9b7",506:"9aa62c0e",522:"308aae28",533:"b2b675dd",563:"c685778b",592:"b39cdcf9",649:"512fbd77",692:"6b600968",743:"61d4c13a",809:"840a98fb",873:"cabda5f8",902:"e5ba977d",921:"c37b4a03",944:"b2e1a0c8",945:"df322e14",1021:"1a0737b6",1032:"a67ca768",1074:"9e8f4e9c",1089:"e561c556",1297:"34cf6fc7",1335:"7327116e",1342:"a766a857",1441:"382c5d2b",1476:"53f302bb",1477:"b2f554cd",1591:"2d81b9d5",1625:"de311ed4",1676:"819ef483",1705:"94fb813f",1713:"a7023ddc",1724:"5087625a",1981:"b799648a",2030:"103db5ac",2051:"da78859a",2079:"1a16e8bf",2082:"e85ba0e6",2173:"36eac8b2",2178:"ba322490",2217:"d7fbbe43",2284:"4117ac4b",2323:"6c80b6fe",2472:"65a10ffa",2535:"814f3328",2557:"28726be2",2609:"6269f1c0",2667:"368cce37",2778:"608238a8",2938:"c95aa39f",2965:"4384f6ba",3010:"56c3a9b2",3089:"a6aa9e1f",3237:"1df93b7f",3259:"03ccf92d",3317:"846a5e19",3324:"1ce91f4c",3414:"35a7a45c",3505:"72486833",3584:"ed75cfcb",3608:"9e4087bc",3636:"8b4dd820",3691:"7be672a3",3751:"3720c009",3820:"a5e1f61e",3870:"5df556a2",3879:"2d629ea6",3973:"f523fb3f",4013:"01a85c17",4059:"9cb03f5d",4121:"55960ee5",4207:"beebaad6",4386:"ae79aff5",4531:"5a8fbd01",4617:"95366386",4685:"d194414f",4758:"c1fad867",4770:"538510a2",4781:"12f1535e",4929:"330dfcdb",5018:"cd509849",5068:"d83d689a",5240:"22de4147",5248:"6101b3fc",5375:"97615df2",5406:"eed60bcf",5468:"b9bde34b",5625:"657ac0bc",5708:"f0057c03",5723:"5d67f40a",5776:"f0e3a130",5803:"ff8f5ed0",5908:"eabf5d51",5974:"f20fb67e",6026:"51dec273",6038:"c9c860ee",6049:"f213dd13",6082:"a233b66e",6088:"88efc5aa",6103:"ccc49370",6120:"d4840880",6134:"3fed3fa8",6181:"4e8ec325",6308:"e8dc4d98",6536:"3ed6e2e9",6690:"4816649b",6692:"2ae2e7fe",6738:"03c9037b",6766:"e5638e51",6843:"9f97f9d1",6855:"9061acb9",6870:"dd8511d3",7007:"8593ff01",7034:"3e03f778",7134:"0b40a488",7138:"38a042e4",7141:"b5abacaa",7149:"822c343e",7155:"76cfb1f4",7220:"7591d420",7251:"ba5b9f11",7350:"8bedf5f0",7363:"583db3ef",7366:"75281220",7377:"708d858d",7438:"9c021584",7480:"eb17771c",7505:"8894e90f",7536:"f6e0e63c",7622:"dbbb982f",7673:"499ddca7",7679:"83245ae6",7698:"cd23aec9",7705:"ea2f3e28",7714:"7bdcd7a7",7739:"3ede2625",7741:"7d88b63f",7813:"933a69d3",7847:"43b416ef",7918:"17896441",7920:"1a4e3797",8065:"5ac0e5f4",8145:"006e489c",8215:"1cfced13",8221:"6af14956",8262:"059d1c6a",8290:"3fe48f60",8445:"99245987",8492:"7856861d",8502:"b4657d81",8514:"d651e2ee",8566:"9dce5486",8610:"6875c492",8698:"59c97daa",8800:"e6fb1369",8811:"3289a752",8860:"0d040286",8893:"ba1dc56d",8940:"b6cf724b",8970:"68b843fc",8989:"d4bf7e47",9019:"771d7520",9043:"473de3ed",9106:"72dd8f7e",9133:"02e265ea",9179:"79551407",9184:"b443212b",9214:"a2e79257",9372:"07f59c2a",9387:"b0f1c099",9514:"1be78505",9671:"0e384e19",9817:"4f561e31",9924:"df203c0f",9944:"08570680"}[e]||e)+"."+{10:"b3b53e4f",53:"1b694294",70:"26b5062a",83:"1ffe06c7",93:"366f43ee",114:"6f770daf",138:"6a914c7e",182:"c229eebf",205:"35a3b8f5",210:"6110e9e0",397:"7e08ca10",465:"87b0e77c",506:"10261cc8",522:"d7cd5912",533:"04eec1dc",563:"f5ac02ad",592:"20325692",649:"10a887e2",692:"99e3d625",743:"89c00deb",809:"e9c07be1",873:"919ad21c",902:"4c42f2dc",921:"f0615854",944:"a49ec1c2",945:"b31a550b",1021:"bae15ab0",1032:"facf75d8",1074:"93a815c0",1089:"a2ae8595",1297:"dee27ee5",1335:"a4d91e33",1342:"87cef355",1441:"0bfa8b3a",1476:"f57854b7",1477:"feafcc1e",1591:"822f4ad0",1625:"e236f50e",1676:"c9dc56d1",1705:"fa2462b2",1713:"dda23ed4",1724:"42ddbd00",1947:"1044b94e",1981:"4e218966",2030:"a5c5b958",2051:"6070347b",2079:"e37eaeb3",2082:"bc14e954",2173:"10c12339",2178:"13069292",2217:"e2f8abd8",2284:"90b1e4cc",2323:"f0b907ab",2472:"afc2f917",2535:"57d3061c",2557:"d11cd2ea",2609:"2963803a",2667:"d2ccc671",2778:"958d27bd",2938:"234f359a",2965:"a212fb0d",3010:"a72a058f",3089:"3a9fb420",3237:"dd740cb1",3259:"d48e5470",3317:"7ce74ef2",3324:"3cf78b95",3414:"820cc7bb",3505:"32e726e7",3584:"7eb08fc3",3608:"6b194cc3",3636:"bac4874d",3691:"a1083895",3751:"e6a1ff2c",3820:"3b327d8d",3866:"51961288",3870:"3631fdfb",3879:"6ef3ee92",3893:"43838999",3973:"66848d52",4013:"43d9b260",4059:"2e148b4d",4121:"25311c05",4178:"a197f856",4207:"7df7a061",4386:"41343000",4531:"704aafa3",4617:"61371bc1",4670:"c6602195",4685:"18125cbf",4758:"022070f4",4770:"43fea8cf",4781:"007e12d4",4929:"a0707feb",5018:"0a4f92e8",5068:"5e325c63",5240:"641ec7fc",5248:"f6dee153",5375:"f19ca62b",5406:"a8179611",5468:"b7bb11c2",5625:"c4b6a5f2",5708:"27be9a41",5723:"d8df7a74",5776:"ae475201",5803:"7724e22b",5908:"b6b284d4",5974:"5ef63543",6026:"6c6a5338",6038:"f7180e21",6049:"2f6bc428",6082:"5a47f9a5",6088:"0e41b8ce",6103:"c915a6c4",6120:"77f190e1",6134:"ead3294b",6181:"30ea8f9c",6308:"326b3a51",6536:"03c9be54",6690:"0738083d",6692:"96f08666",6738:"4c4ff8e5",6766:"b515cedd",6843:"f9fab7b7",6855:"28839681",6870:"09ade6e1",7007:"e073c454",7034:"9d2d2b1f",7134:"0d536e2b",7138:"66534a1a",7141:"aa741b27",7149:"663ec94f",7155:"fedad4b5",7171:"ed520d1e",7220:"c05fb2e2",7251:"75e3d1b3",7350:"8add5f21",7363:"2b36b11d",7366:"4ccca4a7",7377:"b821d601",7438:"53d43536",7480:"8f990f57",7505:"06cbda62",7536:"3a66b423",7622:"b17356bb",7673:"586a10c5",7679:"f15da8d9",7698:"69b40f86",7705:"f0c97be9",7714:"97621d20",7735:"b12007f7",7739:"25e7e1a5",7741:"ff546f54",7813:"59828c02",7847:"2c70676d",7849:"bb1a7e66",7918:"2ee37a96",7920:"a7306422",8065:"ca31ac6b",8145:"16412c4f",8215:"bcf97e6c",8221:"5242150e",8262:"5ff67b76",8290:"c415179d",8306:"ba445665",8445:"4fc783d0",8492:"4934ec59",8502:"7b175b26",8514:"462bdad8",8566:"ffa3aeba",8610:"a88fd9f4",8698:"ad5ffb63",8777:"e2ef1f93",8800:"a0bdbe06",8811:"0376c385",8860:"46081b6e",8893:"333d0e6f",8940:"6dd7dca8",8970:"28e3d5b8",8989:"9885d1c1",9019:"5add45ab",9043:"451a7aa8",9106:"3d077178",9127:"02f87f8d",9133:"7057011c",9179:"294090f1",9184:"3f08b82d",9214:"cd8da953",9372:"7bc1a408",9387:"5ecfd726",9514:"95039c35",9671:"2045a921",9817:"5036f126",9924:"dc218f14",9944:"91801d8b"}[e]+".js",r.miniCssF=e=>{},r.g=function(){if("object"==typeof globalThis)return globalThis;try{return this||new Function("return this")()}catch(e){if("object"==typeof window)return window}}(),r.o=(e,a)=>Object.prototype.hasOwnProperty.call(e,a),f={},d="docs:",r.l=(e,a,c,b)=>{if(f[e])f[e].push(a);else{var t,o;if(void 0!==c)for(var n=document.getElementsByTagName("script"),i=0;i{t.onerror=t.onload=null,clearTimeout(s);var d=f[e];if(delete f[e],t.parentNode&&t.parentNode.removeChild(t),d&&d.forEach((e=>e(c))),a)return a(c)},s=setTimeout(l.bind(null,void 0,{type:"timeout",target:t}),12e4);t.onerror=l.bind(null,t.onerror),t.onload=l.bind(null,t.onload),o&&document.head.appendChild(t)}},r.r=e=>{"undefined"!=typeof Symbol&&Symbol.toStringTag&&Object.defineProperty(e,Symbol.toStringTag,{value:"Module"}),Object.defineProperty(e,"__esModule",{value:!0})},r.p="/",r.gca=function(e){return e={17896441:"7918",33942509:"10",72486833:"3505",75281220:"7366",79551407:"9179",95366386:"4617",99245987:"8445","935f2afb":"53","86f2a982":"70","09905e74":"83","4305e853":"93",e665718d:"114","54590fd2":"138",c276ecb2:"182","83d480e9":"205","3c6cc7c6":"210","6194ac84":"397",f7b7f9b7:"465","9aa62c0e":"506","308aae28":"522",b2b675dd:"533",c685778b:"563",b39cdcf9:"592","512fbd77":"649","6b600968":"692","61d4c13a":"743","840a98fb":"809",cabda5f8:"873",e5ba977d:"902",c37b4a03:"921",b2e1a0c8:"944",df322e14:"945","1a0737b6":"1021",a67ca768:"1032","9e8f4e9c":"1074",e561c556:"1089","34cf6fc7":"1297","7327116e":"1335",a766a857:"1342","382c5d2b":"1441","53f302bb":"1476",b2f554cd:"1477","2d81b9d5":"1591",de311ed4:"1625","819ef483":"1676","94fb813f":"1705",a7023ddc:"1713","5087625a":"1724",b799648a:"1981","103db5ac":"2030",da78859a:"2051","1a16e8bf":"2079",e85ba0e6:"2082","36eac8b2":"2173",ba322490:"2178",d7fbbe43:"2217","4117ac4b":"2284","6c80b6fe":"2323","65a10ffa":"2472","814f3328":"2535","28726be2":"2557","6269f1c0":"2609","368cce37":"2667","608238a8":"2778",c95aa39f:"2938","4384f6ba":"2965","56c3a9b2":"3010",a6aa9e1f:"3089","1df93b7f":"3237","03ccf92d":"3259","846a5e19":"3317","1ce91f4c":"3324","35a7a45c":"3414",ed75cfcb:"3584","9e4087bc":"3608","8b4dd820":"3636","7be672a3":"3691","3720c009":"3751",a5e1f61e:"3820","5df556a2":"3870","2d629ea6":"3879",f523fb3f:"3973","01a85c17":"4013","9cb03f5d":"4059","55960ee5":"4121",beebaad6:"4207",ae79aff5:"4386","5a8fbd01":"4531",d194414f:"4685",c1fad867:"4758","538510a2":"4770","12f1535e":"4781","330dfcdb":"4929",cd509849:"5018",d83d689a:"5068","22de4147":"5240","6101b3fc":"5248","97615df2":"5375",eed60bcf:"5406",b9bde34b:"5468","657ac0bc":"5625",f0057c03:"5708","5d67f40a":"5723",f0e3a130:"5776",ff8f5ed0:"5803",eabf5d51:"5908",f20fb67e:"5974","51dec273":"6026",c9c860ee:"6038",f213dd13:"6049",a233b66e:"6082","88efc5aa":"6088",ccc49370:"6103",d4840880:"6120","3fed3fa8":"6134","4e8ec325":"6181",e8dc4d98:"6308","3ed6e2e9":"6536","4816649b":"6690","2ae2e7fe":"6692","03c9037b":"6738",e5638e51:"6766","9f97f9d1":"6843","9061acb9":"6855",dd8511d3:"6870","8593ff01":"7007","3e03f778":"7034","0b40a488":"7134","38a042e4":"7138",b5abacaa:"7141","822c343e":"7149","76cfb1f4":"7155","7591d420":"7220",ba5b9f11:"7251","8bedf5f0":"7350","583db3ef":"7363","708d858d":"7377","9c021584":"7438",eb17771c:"7480","8894e90f":"7505",f6e0e63c:"7536",dbbb982f:"7622","499ddca7":"7673","83245ae6":"7679",cd23aec9:"7698",ea2f3e28:"7705","7bdcd7a7":"7714","3ede2625":"7739","7d88b63f":"7741","933a69d3":"7813","43b416ef":"7847","1a4e3797":"7920","5ac0e5f4":"8065","006e489c":"8145","1cfced13":"8215","6af14956":"8221","059d1c6a":"8262","3fe48f60":"8290","7856861d":"8492",b4657d81:"8502",d651e2ee:"8514","9dce5486":"8566","6875c492":"8610","59c97daa":"8698",e6fb1369:"8800","3289a752":"8811","0d040286":"8860",ba1dc56d:"8893",b6cf724b:"8940","68b843fc":"8970",d4bf7e47:"8989","771d7520":"9019","473de3ed":"9043","72dd8f7e":"9106","02e265ea":"9133",b443212b:"9184",a2e79257:"9214","07f59c2a":"9372",b0f1c099:"9387","1be78505":"9514","0e384e19":"9671","4f561e31":"9817",df203c0f:"9924","08570680":"9944"}[e]||e,r.p+r.u(e)},(()=>{var e={1303:0,532:0};r.f.j=(a,c)=>{var f=r.o(e,a)?e[a]:void 0;if(0!==f)if(f)c.push(f[2]);else if(/^(1303|532)$/.test(a))e[a]=0;else{var d=new Promise(((c,d)=>f=e[a]=[c,d]));c.push(f[2]=d);var b=r.p+r.u(a),t=new Error;r.l(b,(c=>{if(r.o(e,a)&&(0!==(f=e[a])&&(e[a]=void 0),f)){var d=c&&("load"===c.type?"missing":c.type),b=c&&c.target&&c.target.src;t.message="Loading chunk "+a+" failed.\n("+d+": "+b+")",t.name="ChunkLoadError",t.type=d,t.request=b,f[1](t)}}),"chunk-"+a,a)}},r.O.j=a=>0===e[a];var a=(a,c)=>{var f,d,b=c[0],t=c[1],o=c[2],n=0;if(b.some((a=>0!==e[a]))){for(f in t)r.o(t,f)&&(r.m[f]=t[f]);if(o)var i=o(r)}for(a&&a(c);n{"use strict";var e,a,c,f,d,b={},t={};function r(e){var a=t[e];if(void 0!==a)return a.exports;var c=t[e]={exports:{}};return b[e].call(c.exports,c,c.exports,r),c.exports}r.m=b,e=[],r.O=(a,c,f,d)=>{if(!c){var b=1/0;for(i=0;i=d)&&Object.keys(r.O).every((e=>r.O[e](c[o])))?c.splice(o--,1):(t=!1,d0&&e[i-1][2]>d;i--)e[i]=e[i-1];e[i]=[c,f,d]},r.n=e=>{var a=e&&e.__esModule?()=>e.default:()=>e;return r.d(a,{a:a}),a},c=Object.getPrototypeOf?e=>Object.getPrototypeOf(e):e=>e.__proto__,r.t=function(e,f){if(1&f&&(e=this(e)),8&f)return e;if("object"==typeof e&&e){if(4&f&&e.__esModule)return e;if(16&f&&"function"==typeof e.then)return e}var d=Object.create(null);r.r(d);var b={};a=a||[null,c({}),c([]),c(c)];for(var t=2&f&&e;"object"==typeof t&&!~a.indexOf(t);t=c(t))Object.getOwnPropertyNames(t).forEach((a=>b[a]=()=>e[a]));return b.default=()=>e,r.d(d,b),d},r.d=(e,a)=>{for(var c in a)r.o(a,c)&&!r.o(e,c)&&Object.defineProperty(e,c,{enumerable:!0,get:a[c]})},r.f={},r.e=e=>Promise.all(Object.keys(r.f).reduce(((a,c)=>(r.f[c](e,a),a)),[])),r.u=e=>"assets/js/"+({10:"33942509",53:"935f2afb",70:"86f2a982",83:"09905e74",93:"4305e853",114:"e665718d",138:"54590fd2",182:"c276ecb2",205:"83d480e9",210:"3c6cc7c6",397:"6194ac84",465:"f7b7f9b7",506:"9aa62c0e",522:"308aae28",533:"b2b675dd",563:"c685778b",592:"b39cdcf9",649:"512fbd77",692:"6b600968",743:"61d4c13a",809:"840a98fb",873:"cabda5f8",902:"e5ba977d",921:"c37b4a03",944:"b2e1a0c8",945:"df322e14",1021:"1a0737b6",1032:"a67ca768",1074:"9e8f4e9c",1089:"e561c556",1297:"34cf6fc7",1335:"7327116e",1342:"a766a857",1441:"382c5d2b",1476:"53f302bb",1477:"b2f554cd",1591:"2d81b9d5",1625:"de311ed4",1676:"819ef483",1705:"94fb813f",1713:"a7023ddc",1724:"5087625a",1981:"b799648a",2030:"103db5ac",2051:"da78859a",2079:"1a16e8bf",2082:"e85ba0e6",2173:"36eac8b2",2178:"ba322490",2217:"d7fbbe43",2284:"4117ac4b",2323:"6c80b6fe",2472:"65a10ffa",2535:"814f3328",2557:"28726be2",2609:"6269f1c0",2667:"368cce37",2778:"608238a8",2938:"c95aa39f",2965:"4384f6ba",3010:"56c3a9b2",3089:"a6aa9e1f",3237:"1df93b7f",3259:"03ccf92d",3317:"846a5e19",3324:"1ce91f4c",3414:"35a7a45c",3505:"72486833",3584:"ed75cfcb",3608:"9e4087bc",3636:"8b4dd820",3691:"7be672a3",3751:"3720c009",3820:"a5e1f61e",3870:"5df556a2",3879:"2d629ea6",3973:"f523fb3f",4013:"01a85c17",4059:"9cb03f5d",4121:"55960ee5",4207:"beebaad6",4386:"ae79aff5",4531:"5a8fbd01",4617:"95366386",4685:"d194414f",4758:"c1fad867",4770:"538510a2",4781:"12f1535e",4929:"330dfcdb",5018:"cd509849",5068:"d83d689a",5240:"22de4147",5248:"6101b3fc",5375:"97615df2",5406:"eed60bcf",5468:"b9bde34b",5625:"657ac0bc",5708:"f0057c03",5723:"5d67f40a",5776:"f0e3a130",5803:"ff8f5ed0",5908:"eabf5d51",5974:"f20fb67e",6026:"51dec273",6038:"c9c860ee",6049:"f213dd13",6082:"a233b66e",6088:"88efc5aa",6103:"ccc49370",6120:"d4840880",6134:"3fed3fa8",6181:"4e8ec325",6308:"e8dc4d98",6536:"3ed6e2e9",6690:"4816649b",6692:"2ae2e7fe",6738:"03c9037b",6766:"e5638e51",6843:"9f97f9d1",6855:"9061acb9",6870:"dd8511d3",7007:"8593ff01",7034:"3e03f778",7134:"0b40a488",7138:"38a042e4",7141:"b5abacaa",7149:"822c343e",7155:"76cfb1f4",7220:"7591d420",7251:"ba5b9f11",7350:"8bedf5f0",7363:"583db3ef",7366:"75281220",7377:"708d858d",7438:"9c021584",7480:"eb17771c",7505:"8894e90f",7536:"f6e0e63c",7622:"dbbb982f",7673:"499ddca7",7679:"83245ae6",7698:"cd23aec9",7705:"ea2f3e28",7714:"7bdcd7a7",7739:"3ede2625",7741:"7d88b63f",7813:"933a69d3",7847:"43b416ef",7918:"17896441",7920:"1a4e3797",8065:"5ac0e5f4",8145:"006e489c",8215:"1cfced13",8221:"6af14956",8262:"059d1c6a",8290:"3fe48f60",8445:"99245987",8492:"7856861d",8502:"b4657d81",8514:"d651e2ee",8566:"9dce5486",8610:"6875c492",8698:"59c97daa",8800:"e6fb1369",8811:"3289a752",8860:"0d040286",8893:"ba1dc56d",8940:"b6cf724b",8970:"68b843fc",8989:"d4bf7e47",9019:"771d7520",9043:"473de3ed",9106:"72dd8f7e",9133:"02e265ea",9179:"79551407",9184:"b443212b",9214:"a2e79257",9372:"07f59c2a",9387:"b0f1c099",9514:"1be78505",9671:"0e384e19",9817:"4f561e31",9924:"df203c0f",9944:"08570680"}[e]||e)+"."+{10:"b3b53e4f",53:"1b694294",70:"26b5062a",83:"1ffe06c7",93:"366f43ee",114:"6f770daf",138:"6a914c7e",182:"c229eebf",205:"35a3b8f5",210:"6110e9e0",397:"7e08ca10",465:"87b0e77c",506:"10261cc8",522:"d7cd5912",533:"04eec1dc",563:"f5ac02ad",592:"20325692",649:"10a887e2",692:"99e3d625",743:"89c00deb",809:"e9c07be1",873:"919ad21c",902:"4c42f2dc",921:"f0615854",944:"a49ec1c2",945:"b31a550b",1021:"bae15ab0",1032:"facf75d8",1074:"93a815c0",1089:"a2ae8595",1297:"dee27ee5",1335:"a4d91e33",1342:"87cef355",1441:"0bfa8b3a",1476:"f57854b7",1477:"93d789a4",1591:"822f4ad0",1625:"307b490a",1676:"c9dc56d1",1705:"fa2462b2",1713:"dda23ed4",1724:"42ddbd00",1947:"1044b94e",1981:"4e218966",2030:"a5c5b958",2051:"6070347b",2079:"e37eaeb3",2082:"bc14e954",2173:"10c12339",2178:"13069292",2217:"e2f8abd8",2284:"90b1e4cc",2323:"f0b907ab",2472:"afc2f917",2535:"57d3061c",2557:"d11cd2ea",2609:"2963803a",2667:"d2ccc671",2778:"958d27bd",2938:"234f359a",2965:"a212fb0d",3010:"a72a058f",3089:"3a9fb420",3237:"dd740cb1",3259:"d48e5470",3317:"7ce74ef2",3324:"3cf78b95",3414:"820cc7bb",3505:"32e726e7",3584:"7eb08fc3",3608:"6b194cc3",3636:"bac4874d",3691:"a1083895",3751:"e6a1ff2c",3820:"3b327d8d",3866:"51961288",3870:"3631fdfb",3879:"6ef3ee92",3893:"43838999",3973:"66848d52",4013:"43d9b260",4059:"2e148b4d",4121:"25311c05",4178:"a197f856",4207:"7df7a061",4386:"41343000",4531:"704aafa3",4617:"61371bc1",4670:"c6602195",4685:"18125cbf",4758:"022070f4",4770:"43fea8cf",4781:"007e12d4",4929:"a0707feb",5018:"0a4f92e8",5068:"5e325c63",5240:"641ec7fc",5248:"f6dee153",5375:"f19ca62b",5406:"a8179611",5468:"b7bb11c2",5625:"c4b6a5f2",5708:"27be9a41",5723:"d8df7a74",5776:"ae475201",5803:"7724e22b",5908:"b6b284d4",5974:"5ef63543",6026:"6c6a5338",6038:"f7180e21",6049:"2f6bc428",6082:"5a47f9a5",6088:"0e41b8ce",6103:"c915a6c4",6120:"77f190e1",6134:"ead3294b",6181:"30ea8f9c",6308:"326b3a51",6536:"03c9be54",6690:"0738083d",6692:"96f08666",6738:"4c4ff8e5",6766:"b515cedd",6843:"f9fab7b7",6855:"28839681",6870:"09ade6e1",7007:"e073c454",7034:"9d2d2b1f",7134:"0d536e2b",7138:"66534a1a",7141:"aa741b27",7149:"663ec94f",7155:"fedad4b5",7171:"ed520d1e",7220:"c05fb2e2",7251:"75e3d1b3",7350:"8add5f21",7363:"2b36b11d",7366:"4ccca4a7",7377:"b821d601",7438:"53d43536",7480:"8f990f57",7505:"06cbda62",7536:"3a66b423",7622:"b17356bb",7673:"586a10c5",7679:"f15da8d9",7698:"69b40f86",7705:"f0c97be9",7714:"97621d20",7735:"b12007f7",7739:"25e7e1a5",7741:"ff546f54",7813:"59828c02",7847:"2c70676d",7849:"bb1a7e66",7918:"2ee37a96",7920:"a7306422",8065:"ca31ac6b",8145:"16412c4f",8215:"bcf97e6c",8221:"5242150e",8262:"5ff67b76",8290:"c415179d",8306:"ba445665",8445:"4fc783d0",8492:"4934ec59",8502:"7b175b26",8514:"462bdad8",8566:"ffa3aeba",8610:"a88fd9f4",8698:"ad5ffb63",8777:"e2ef1f93",8800:"a0bdbe06",8811:"0376c385",8860:"46081b6e",8893:"333d0e6f",8940:"6dd7dca8",8970:"28e3d5b8",8989:"9885d1c1",9019:"5add45ab",9043:"451a7aa8",9106:"3d077178",9127:"02f87f8d",9133:"7057011c",9179:"294090f1",9184:"3f08b82d",9214:"cd8da953",9372:"7bc1a408",9387:"5ecfd726",9514:"95039c35",9671:"2045a921",9817:"5036f126",9924:"dc218f14",9944:"91801d8b"}[e]+".js",r.miniCssF=e=>{},r.g=function(){if("object"==typeof globalThis)return globalThis;try{return this||new Function("return this")()}catch(e){if("object"==typeof window)return window}}(),r.o=(e,a)=>Object.prototype.hasOwnProperty.call(e,a),f={},d="docs:",r.l=(e,a,c,b)=>{if(f[e])f[e].push(a);else{var t,o;if(void 0!==c)for(var n=document.getElementsByTagName("script"),i=0;i{t.onerror=t.onload=null,clearTimeout(s);var d=f[e];if(delete f[e],t.parentNode&&t.parentNode.removeChild(t),d&&d.forEach((e=>e(c))),a)return a(c)},s=setTimeout(l.bind(null,void 0,{type:"timeout",target:t}),12e4);t.onerror=l.bind(null,t.onerror),t.onload=l.bind(null,t.onload),o&&document.head.appendChild(t)}},r.r=e=>{"undefined"!=typeof Symbol&&Symbol.toStringTag&&Object.defineProperty(e,Symbol.toStringTag,{value:"Module"}),Object.defineProperty(e,"__esModule",{value:!0})},r.p="/",r.gca=function(e){return e={17896441:"7918",33942509:"10",72486833:"3505",75281220:"7366",79551407:"9179",95366386:"4617",99245987:"8445","935f2afb":"53","86f2a982":"70","09905e74":"83","4305e853":"93",e665718d:"114","54590fd2":"138",c276ecb2:"182","83d480e9":"205","3c6cc7c6":"210","6194ac84":"397",f7b7f9b7:"465","9aa62c0e":"506","308aae28":"522",b2b675dd:"533",c685778b:"563",b39cdcf9:"592","512fbd77":"649","6b600968":"692","61d4c13a":"743","840a98fb":"809",cabda5f8:"873",e5ba977d:"902",c37b4a03:"921",b2e1a0c8:"944",df322e14:"945","1a0737b6":"1021",a67ca768:"1032","9e8f4e9c":"1074",e561c556:"1089","34cf6fc7":"1297","7327116e":"1335",a766a857:"1342","382c5d2b":"1441","53f302bb":"1476",b2f554cd:"1477","2d81b9d5":"1591",de311ed4:"1625","819ef483":"1676","94fb813f":"1705",a7023ddc:"1713","5087625a":"1724",b799648a:"1981","103db5ac":"2030",da78859a:"2051","1a16e8bf":"2079",e85ba0e6:"2082","36eac8b2":"2173",ba322490:"2178",d7fbbe43:"2217","4117ac4b":"2284","6c80b6fe":"2323","65a10ffa":"2472","814f3328":"2535","28726be2":"2557","6269f1c0":"2609","368cce37":"2667","608238a8":"2778",c95aa39f:"2938","4384f6ba":"2965","56c3a9b2":"3010",a6aa9e1f:"3089","1df93b7f":"3237","03ccf92d":"3259","846a5e19":"3317","1ce91f4c":"3324","35a7a45c":"3414",ed75cfcb:"3584","9e4087bc":"3608","8b4dd820":"3636","7be672a3":"3691","3720c009":"3751",a5e1f61e:"3820","5df556a2":"3870","2d629ea6":"3879",f523fb3f:"3973","01a85c17":"4013","9cb03f5d":"4059","55960ee5":"4121",beebaad6:"4207",ae79aff5:"4386","5a8fbd01":"4531",d194414f:"4685",c1fad867:"4758","538510a2":"4770","12f1535e":"4781","330dfcdb":"4929",cd509849:"5018",d83d689a:"5068","22de4147":"5240","6101b3fc":"5248","97615df2":"5375",eed60bcf:"5406",b9bde34b:"5468","657ac0bc":"5625",f0057c03:"5708","5d67f40a":"5723",f0e3a130:"5776",ff8f5ed0:"5803",eabf5d51:"5908",f20fb67e:"5974","51dec273":"6026",c9c860ee:"6038",f213dd13:"6049",a233b66e:"6082","88efc5aa":"6088",ccc49370:"6103",d4840880:"6120","3fed3fa8":"6134","4e8ec325":"6181",e8dc4d98:"6308","3ed6e2e9":"6536","4816649b":"6690","2ae2e7fe":"6692","03c9037b":"6738",e5638e51:"6766","9f97f9d1":"6843","9061acb9":"6855",dd8511d3:"6870","8593ff01":"7007","3e03f778":"7034","0b40a488":"7134","38a042e4":"7138",b5abacaa:"7141","822c343e":"7149","76cfb1f4":"7155","7591d420":"7220",ba5b9f11:"7251","8bedf5f0":"7350","583db3ef":"7363","708d858d":"7377","9c021584":"7438",eb17771c:"7480","8894e90f":"7505",f6e0e63c:"7536",dbbb982f:"7622","499ddca7":"7673","83245ae6":"7679",cd23aec9:"7698",ea2f3e28:"7705","7bdcd7a7":"7714","3ede2625":"7739","7d88b63f":"7741","933a69d3":"7813","43b416ef":"7847","1a4e3797":"7920","5ac0e5f4":"8065","006e489c":"8145","1cfced13":"8215","6af14956":"8221","059d1c6a":"8262","3fe48f60":"8290","7856861d":"8492",b4657d81:"8502",d651e2ee:"8514","9dce5486":"8566","6875c492":"8610","59c97daa":"8698",e6fb1369:"8800","3289a752":"8811","0d040286":"8860",ba1dc56d:"8893",b6cf724b:"8940","68b843fc":"8970",d4bf7e47:"8989","771d7520":"9019","473de3ed":"9043","72dd8f7e":"9106","02e265ea":"9133",b443212b:"9184",a2e79257:"9214","07f59c2a":"9372",b0f1c099:"9387","1be78505":"9514","0e384e19":"9671","4f561e31":"9817",df203c0f:"9924","08570680":"9944"}[e]||e,r.p+r.u(e)},(()=>{var e={1303:0,532:0};r.f.j=(a,c)=>{var f=r.o(e,a)?e[a]:void 0;if(0!==f)if(f)c.push(f[2]);else if(/^(1303|532)$/.test(a))e[a]=0;else{var d=new Promise(((c,d)=>f=e[a]=[c,d]));c.push(f[2]=d);var b=r.p+r.u(a),t=new Error;r.l(b,(c=>{if(r.o(e,a)&&(0!==(f=e[a])&&(e[a]=void 0),f)){var d=c&&("load"===c.type?"missing":c.type),b=c&&c.target&&c.target.src;t.message="Loading chunk "+a+" failed.\n("+d+": "+b+")",t.name="ChunkLoadError",t.type=d,t.request=b,f[1](t)}}),"chunk-"+a,a)}},r.O.j=a=>0===e[a];var a=(a,c)=>{var f,d,b=c[0],t=c[1],o=c[2],n=0;if(b.some((a=>0!==e[a]))){for(f in t)r.o(t,f)&&(r.m[f]=t[f]);if(o)var i=o(r)}for(a&&a(c);n - + @@ -29,7 +29,7 @@ of Podman Desktop: not just local container engines, but Kubernetes too. More im providing tools that allow you to manage both environments and seamlessly move between them.

Some of these features were available in development mode over the last few releases, but since they are now in the release build, we will do a full roundup and talk about all the Kind features.

  • Kind Installation: Install Kind from the status bar
  • Manage Kind Clusters: Create and manage Kind clusters from Settings > Resources
  • Using Kind: Deploying YAML and sharing images to a cluster
  • Kind Ingress: Install a Contour ingress controller
  • UX and UI Improvements: Updated preferences and telemetry prompt

Podman Desktop 0.14 is now available. Click here to download it!

Podman-desktop-0-14-hero

· 4 min read
Tim deBoer

This release note covers Podman Desktop 0.13 release changes.

  • Podman Version: Podman 4.4.4 now included in Windows and Mac installers.
  • Compose: Support for installing Docker Compose.
  • Extensions: Improved extension support for Podman Desktop with additional capabilities.
  • UX and UI Improvements: Welcome page, task manager, resources, and update alerts.

Podman Desktop 0.13 is now available. Click here to download it!

Podman-desktop-0-13-hero

· 5 min read
Florent Benoit

The 5 things to know being a Docker user by using Podman Desktop:

  • Use a single UI: Podman Desktop works with several container engines, including Docker.
  • The compatibility mode: How to ensure tools are working with Podman instead of Docker.
  • Compose support: How to work with Compose files and Podman.
  • Kubernetes support: How to use Kubernetes with Podman.
  • Security: Use rootless mode or containers without root privileges.

5-things-to-know-for-a-docker-user-hero

· 5 min read
Stevan Le Meur

This release note covers Podman Desktop 0.12 release changes.

  • Podman Version: Podman 4.4.1 now included in Windows and Mac installers.
  • Containers Configuration: Configure port mappings for an image without exported ports.
  • Windows Home Support: Podman Desktop now supports Windows Home Edition.
  • Start minimized: Option to start Podman Desktop minimized to system tray.
  • UX and UI Improvements: Consistent actions, placeholder for logs, unified icons and others.

Podman Desktop 0.12 is now available. Click here to download it!

podman-desktop-0-12-hero

· 10 min read
Stevan Le Meur

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!

· 5 min read
Dev Kumar

This release note covers Podman Desktop 0.10 release changes.

  • Containers Configuration: Container creation wizzard allowing to define environment variables, networking and more configuration options.
  • Kubernetes Improvements: Play Kubernetes YAML, custom Kubeconfig path support, reload of kube context.
  • Registries Configuration: Revamped registries configuration UI.
  • Podman Version: Podman 4.3.1 now included in Windows and Mac installers.
  • UX/UI Improvements: Improved lists, better contrast, and more.

Podman Desktop 0.10 is now available. Click here to download it!

· 7 min read
Florent Benoit

GitHub announced last week that Codespaces is available for everyone and it includes free minutes.

Let see how we can use a Development Container having all the tools to build and run Podman Desktop. The Development Container works locally using Visual Studio Code but in this blog post we will see how it works directly with a simple click from GitHub.

The challenges are to run a desktop tool (Podman Desktop) and running a container engine (Podman) inside this Development Container without using too many memory !

- + \ No newline at end of file diff --git a/blog/5-things-to-know-for-a-docker-user.html b/blog/5-things-to-know-for-a-docker-user.html index 023d0099b0c..a8660749f3d 100644 --- a/blog/5-things-to-know-for-a-docker-user.html +++ b/blog/5-things-to-know-for-a-docker-user.html @@ -13,13 +13,13 @@ - +

5 things to know about Podman Desktop for a Docker user

· 5 min read
Florent Benoit

The 5 things to know being a Docker user by using Podman Desktop:

  • Use a single UI: Podman Desktop works with several container engines, including Docker.
  • The compatibility mode: How to ensure tools are working with Podman instead of Docker.
  • Compose support: How to work with Compose files and Podman.
  • Kubernetes support: How to use Kubernetes with Podman.
  • Security: Use rootless mode or containers without root privileges.

5-things-to-know-for-a-docker-user-hero

Use Podman Desktop to interact with containers running in Docker​

Docker Desktop provides a UI to interact with containers and images. But the UI depends on Docker API and it is not possible to use the UI with Docker and Podman at the same time.

Podman Desktop is a multi-engine UI tool. The UI is compatible with the API of Docker and Podman. It means all containers and images from all the engines at the same time are visible in the UI.

When migrating from Docker to Podman, you can use Podman Desktop to interact with containers running in Docker. Explore all commands and features of Podman Desktop and see all the resources from Docker.

Many container engines at the same time

Docker compatibility mode​

Using Podman with Podman Desktop or with the Podman CLI is straightforward. But some tools expect to find docker CLI or docker.sock socket. In this case, you have to use the compatibility mode of Podman.

Socket file compatibility​

The socket compatibility mode is a feature of Podman that allows to bind the Podman socket under the Docker socket path.

On Windows the socket compatibility mode is always enabled by default. On macOS, by using the .pkg installer it is active by default. But when installing with brew, it will not be there because it requires some admin permissions.

That is not an issue because you can enable it by invoking a CLI tool that will setup the compatibility mode.

For example if you use TestContainers in your Java project, you can use the compatibility mode to ensure that the tool will use Podman instead of Docker.

CLI compatibility​

If you have scripts relying on docker CLI, you can use the compatibility mode to ensure that the tool is working with Podman instead of Docker.

If you have the docker CLI installed on your computer, you can use the socket file compatibility of docker to ensure that the tool is working with Podman engine instead of Docker.

If you do not have the docker CLI installed on your computer, you can Create a script called docker that will call the podman CLI

NOTE: creating a shell prompt alias, for example alias docker=podman, will not work inside scripts that you call.

Compose​

As a user of Docker, you might use docker compose (or docker-compose) to run some of your applications.

For now Podman does not include a Compose support directly in the CLI with a command podman compose.

Compose can work with the Podman socket.

Based on the compatibility mode (see section about Docker compatibility mode):

You can now use the compose binary to run your applications and it will use Podman engine.

Podman Desktop has a compose extension that can fetch compose binary if not already available on the filesystem.

Podman Desktop UI displays the containers created by Compose are in the same group.

Compose support in the UI

Kubernetes​

It is possible to start a Kubernetes cluster with Docker.

Podman supports directly a subset of Kubernetes resources that you can use with .yaml files.

For example if you only want to create a Pod resource, you can use the Play Kubernetes YAML button from the Containers list screen with your .yaml file. No need to install or start a Kubernetes cluster.

Play Kubernetes YAML

It is possible to do the counter-part. Export the definition of a container or pod to a Kubernetes resource. You can use the Generate kube button from the kebab menu of a given container or pod.

Kubernetes generate

Podman handles pods and in the Podman Desktop UI, you can see all the pods inside a Pod section. All containers inside the pod are in the same group.

Pods in the UI

Containers from pod

An experimental kind extension is bringing the creation of full-blown Kubernetes cluster with Podman.

Rootless mode​

One of the difference of Docker and Podman is the way they handle containers. Docker requires root privileges to run containers by default. Podman can run containers without root privileges by default.

It means that for example, starting a container with a port < 1024 will not work. You need to use a port > 1024.

If you still need to create containers with a port < 1024, you can change the Podman machine configuration of the Podman Machine if you are on Windows or macOS.

The command is podman machine --rootful to enable the execution with root privileges or podman machine --rootful=false to switch back to rootless mode.

- + \ No newline at end of file diff --git a/blog/archive.html b/blog/archive.html index 631f5f25262..7f58e0d97cc 100644 --- a/blog/archive.html +++ b/blog/archive.html @@ -13,13 +13,13 @@ - +

Archive

Archive

2022

2023

- + \ No newline at end of file diff --git a/blog/atom.xml b/blog/atom.xml index 8a2b31139e6..118df18c632 100644 --- a/blog/atom.xml +++ b/blog/atom.xml @@ -201,9 +201,9 @@ We can now embed links and other formatting in preferences, and extensions can u 2023-04-19T00:00:00.000Z In this blog post you will learn to use Podman Desktop to run the Kubernetes documentation example: Deploying PHP Guestbook application with Redis.

On the agenda:

  1. Installing Podman Desktop.
  2. Installing and initializing your container engine: Podman.
  3. Installing and starting your local Kubernetes provider: Kind.
  4. Starting the Redis leader.
  5. Starting and scaling the Redis followers.
  6. Starting and exposing the Guestbook frontend.

Installing Podman Desktop​

You need Podman Desktop.

  1. Go to Podman Desktop installation documentation.
  2. Click on your platform name: Windows, macOS, or Linux.
  3. Follow the instructions. Stick to the default installation method.
  4. Start Podman Desktop.

At this point, you have a graphical user interface to:

  • Install Podman and Kind.
  • Control and work with your container engines and Kubernetes clusters.
  • Run your application on your container engine and migrate it to Kubernetes.

Installing and initializing your container engine: Podman​

Podman Desktop can control various container engines, such as:

  • Docker
  • Lima
  • Podman

Consider installing the Podman container engine for:

  • Added security
  • No daemon
  • Open source

Containers are a Linux technology.

  • On Linux, you can install Podman natively. -See: Installing Podman on Linux.
  • On macOS and Windows, Podman requires to run in a Linux virtual machine: the Podman machine. -Use Podman Desktop to install Podman and initialize your Podman machine:

Procedure​

  1. Open Podman Desktop Dashboard
  2. The Dashboard displays Podman Desktop was not able to find an installation of Podman.
  3. Click on Install.
  4. Podman Desktop checks the prerequisites to install Podman Engine. When necessary, follow the instructions to install prerequisites.
  5. Podman displays the dialog: Podman is not installed on this system, would you like to install Podman?. Click on Yes to install Podman.
  6. Click on Initialize and start.

Verification​

  • The Dashboard displays Podman is running.

    Podman is running

At this point, you can start working with containers.

Installing and starting your local Kubernetes provider: Kind​

You want to deploy your application to a local Kubernetes cluster.

Podman Desktop can help you run Kind-powered local Kubernetes clusters on a container engine, such as Podman.

Podman Desktop helps you installing the kind CLI:

  1. In the status bar, click on Kind, and follow the prompts.

  2. When the kind CLI is available, the status bar does not display Kind.

  3. On Windows, configure Podman in rootful mode

    $ podman system connection default podman-machine-default-root

  4. Go to Settings > Resources

  5. In the Podman icon Podman tile, click on the icon to restart the Podman container engine.

  6. In the Kind icon Kind tile, click on the Create new button.

    1. Name: enter kind-cluster.
    2. Provider Type: select podman.
    3. HTTP Port: select 9090.
    4. HTTPS Port: select 9443.
    5. Setup an ingress controller: Enabled
    6. Click the Create button. -Create a Kind cluster screen

  7. After successful creation, click on the Go back to resources button

Verification​

  1. In Settings > Resources your Kind cluster is running/

    Kind cluster is running

  2. In the Podman Desktop tray, open the Kubernetes menu: you can set the context to your Kind cluster: kind-kind-cluster.

    Kind cluster Kubernetes context in the tray

    At this point, you can start working with containers, and your local Kubernetes cluster.

Additional resources​

Starting the Redis leader​

The Guestbook application uses Redis to store its data.

With Podman Desktop, you can prepare the Redis leader image and container on your local container engine, and deploy the results to a Kubernetes pod and service. +See: Installing Podman on Linux.

  • On macOS and Windows, Podman requires to run in a Linux virtual machine: the Podman machine. +Use Podman Desktop to install Podman and initialize your Podman machine:

    • Procedure​

    1. Open Podman Desktop Dashboard
    2. The Dashboard displays Podman Desktop was not able to find an installation of Podman.
    3. Click on Install.
    4. Podman Desktop checks the prerequisites to install Podman Engine. When necessary, follow the instructions to install prerequisites.
    5. Podman displays the dialog: Podman is not installed on this system, would you like to install Podman?. Click on Yes to install Podman.
    6. Click on Initialize and start.

    Verification​

    • The Dashboard displays Podman is running.

      Podman is running

    At this point, you can start working with containers.

    Installing and starting your local Kubernetes provider: Kind​

    You want to deploy your application to a local Kubernetes cluster.

    Podman Desktop can help you run Kind-powered local Kubernetes clusters on a container engine, such as Podman.

    Podman Desktop helps you installing the kind CLI:

    1. In the status bar, click on Kind, and follow the prompts.

    2. When the kind CLI is available, the status bar does not display Kind.

    3. On Windows, configure Podman in rootful mode

      $ podman system connection default podman-machine-default-root

    4. Go to Settings > Resources

    5. In the Podman icon Podman tile, click on the icon to restart the Podman container engine.

    6. In the Kind icon Kind tile, click on the Create new button.

      1. Name: enter kind-cluster.
      2. Provider Type: select podman.
      3. HTTP Port: select 9090.
      4. HTTPS Port: select 9443.
      5. Setup an ingress controller: Enabled
      6. Click the Create button. +Create a Kind cluster screen

    7. After successful creation, click on the Go back to resources button

    Verification​

    1. In Settings > Resources your Kind cluster is running/

      Kind cluster is running

    2. In the Podman Desktop tray, open the Kubernetes menu: you can set the context to your Kind cluster: kind-kind-cluster.

      Kind cluster Kubernetes context in the tray

      At this point, you can start working with containers, and your local Kubernetes cluster.

    Additional resources​

    Starting the Redis leader​

    The Guestbook application uses Redis to store its data.

    With Podman Desktop, you can prepare the Redis leader image and container on your local container engine, and deploy the results to a Kubernetes pod and service. This is functionally equal to the redis-leader deployment that the Kubernetes example propose.

    Procedure​

    1. Open Images > Pull an image.

      1. Image to Pull: enter docker.io/redis:6.0.5
      2. Click Pull image to pull the image to your container engine local image registry.
      3. Click Done to get back to the images list.

    2. Search images: enter redis:6.0.5 to find the image.

    3. Click to open the Create a container from image dialog.

      1. Container name: enter leader,
      2. Local port for 6379/tcp: 6379.
      3. Click Start Container to start the container in your container engine.

    4. Search containers: enter leader to find the running container.

    5. Click to stop the container, and leave the 6379 port available for the Redis follower container.

    6. Click > Deploy to Kubernetes to open the Deploy generated pod to Kubernetes screen.

      1. Pod Name: enter redis-leader.
      2. Use Kubernetes Services: select Replace hostPort exposure on containers by Services. It is the recommended way to expose ports, as a cluster policy might prevent to use hostPort.
      3. Expose service locally using Kubernetes Ingress: deselect Create a Kubernetes ingress to get access to the ports that this pod exposes, at the default ingress controller location. Example: on a default Kind cluster created with Podman Desktop: http://localhost:9090. Requirements: your cluster has an ingress controller`.
      4. Kubernetes namespaces: select default.
      5. Click Deploy. Deploy generated leader pod to Kubernetes screen
      6. Wait for the pod to reach the state: Phase: Running.
      7. Click Done.

    Verification​

    • The Pods screen lists the running redis-leader pod.

      leader pod is running

    Starting the Redis followers​

    Although the Redis leader is a single Pod, you can make it highly available and meet traffic demands by adding a few Redis followers, or replicas.

    With Podman Desktop, you can prepare the Redis follower image and container on your local container engine, and deploy the results to Kubernetes pods and services. This is functionally equal to the redis-follower deployment that the Kubernetes example propose.

    Procedure​

    1. Open Images > Pull an image.
      1. Image to Pull: enter gcr.io/google_samples/gb-redis-follower:v2
      2. Click Pull image to pull the image to your container engine local image registry.
      3. Click Done to get back to the images list.
    2. Search images: enter gb-redis-follower:v2 to find the image.
    3. Click to open the Create a container from image dialog.
      1. Container name: enter follower,
      2. Local port for 6379/tcp: 6379.
      3. Click Start Container to start the container in your container engine.
    4. Search containers: enter follower to find the running container.
    5. Click to stop the container: you do not need it to run in the container engine.
    6. Click > Deploy to Kubernetes to open the Deploy generated pod to Kubernetes screen.
      1. Pod Name: enter redis-follower.
      2. Use Kubernetes Services: select Replace hostPort exposure on containers by Services. It is the recommended way to expose ports, as a cluster policy might prevent to use hostPort.
      3. Expose service locally using Kubernetes Ingress: deselect Create a Kubernetes ingress to get access to the ports that this pod exposes, at the default ingress controller location. Example: on a default Kind cluster created with Podman Desktop: http://localhost:9090. Requirements: your cluster has an ingress controller`.
      4. Kubernetes namespaces: select default.
      5. Click Deploy. diff --git a/blog/develop-using-devcontainer.html b/blog/develop-using-devcontainer.html index 2ebe420ba93..cd1a4823930 100644 --- a/blog/develop-using-devcontainer.html +++ b/blog/develop-using-devcontainer.html @@ -13,7 +13,7 @@ - + @@ -23,7 +23,7 @@ Using --privileged we don't really know what are the privilege that are required while specifying all of them, people are aware of what is granted/denied.

        "runArgs": [
            "--cap-add=sys_admin",
            "--security-opt",
            "seccomp=unconfined",
            "--device",
            "/dev/fuse",
            "--security-opt",
            "label=disable",
            "--security-opt",
            "apparmor=unconfined"
          ],

        Source code of Podman Desktop needs to be editable within the DevContainer so it needs to be mounted.

        "workspaceMount": "source=${localWorkspaceFolder},target=/workspace,type=bind",
        "workspaceFolder": "/workspace",

        Then we need a command to build Podman Desktop.

        For that, we use onCreateCommand hook with a custom command

        "onCreateCommand": "${containerWorkspaceFolder}/.devcontainer/onCreateCommand.sh",

        and in the .devcontainer folder the onCreateCommand.sh script is the following

        #!/bin/sh
        yarn

        MODE=production yarn run build && yarn run electron-builder build --linux --dir --config .electron-builder.config.cjs

        Two instructions:

        1. Fetch all Node.js dependencies.
        2. build Podman Desktop in the dist folder using Linux as target Operating System.

        After the start of the container, how to launch Podman Desktop, the website and VNC, etc ?

        Just use postStartCommand hook.

        "postStartCommand": "${containerWorkspaceFolder}/.devcontainer/postStartCommand.sh",

        and in the .devcontainer folder the postStartCommand.sh script is the following:

        #!/bin/sh

        # Start all services
        /usr/bin/supervisord -c /etc/supervisord.conf &

        # wait X server to be ready or after 2mn exit
        echo "Waiting for X server to be ready"
        timeout 120 bash -c 'until xdpyinfo -display :0 &> /dev/null; do printf "."; sleep 1; done'

        # launch podman desktop
        echo "Launching Podman Desktop"
        cd dist/linux-unpacked/&& ./podman-desktop &

        # Launch the 9000 redirect after 20 seconds
        sleep 20
        websockify --web=/usr/share/novnc localhost:9000 localhost:5900 &

        # launch the website rendering
        echo "Launching Website"
        cd website && yarn start

        It starts VNC and noVNC, start precompiled Podman Desktop and start the documentation rendering.

        It is not launching the Watch mode/development mode of Podman Desktop as it requires a container having more than 8GB of memory.

        Picking up a larger instace with for example 16GB, it's possible to use development mode.

        Of course, to make VNC happy, we need to specify the DISPLAY environment variable.

        "remoteEnv": {
          "DISPLAY": ":0"
        }

        When the DevContainer is fully available, we want to have a way to quickly open the Website rendering URL and noVNC

        Let's tweak the devcontainer.json file by adding the portsAttributes section

        "portsAttributes": {
          "9000": {
            "label": "vnc",
            "onAutoForward": "openPreview"
          },
          "3000": {
            "label": "website"
          }
        }

        After all post-creation steps, the Preview browser inside the VS Code editor will open a window to VNC. And another port (3000) is flagged for the website.

        Using the DevContainer.json on Github Codespace​

        As a user, opening a workspace with all what we configured is done using a single click.

        Go to https://github.com/containers/podman-desktop then click on the < > Code dropdown and click on Create codespace on main button.

        Open Codespace

        Once you click on the button, the codespace is setting up:

        Preparing Codepace

        After few minutes, as there is not yet prebuilt codespaces, the codespace is opening.

        The simple Browser displays the noVNC window: Opening Codespace

        Click on the connect button. Then on the terminal you can enter podman run quay.io/podman/hello and the container is detected in Podman Desktop. Testing Codespace

        It's also possible using the port widget to get on 3000 port by clicking on the world icon a preview of the website in another tab. Changing source code of the website will refresh the content of the window.

        Depending on the usecase, it's also possible to open documentation in the preview browser.

        Edit website Codespace

        Conclusion​

        The DevContainer image for Podman Desktop is recent so it'll probably evolve over time by adding new capabilities but it allows you to easily build/run/experiment and contribute to the tool or the website.

        - + \ No newline at end of file diff --git a/blog/feed.json b/blog/feed.json index 974f6754e3e..e818bd214b6 100644 --- a/blog/feed.json +++ b/blog/feed.json @@ -97,7 +97,7 @@ }, { "id": "https://podman-desktop.io/blog/running-a-local-kubernetes-cluster-with-podman-desktop", - "content_html": "

        In this blog post you will learn to use Podman Desktop to run the Kubernetes documentation example: Deploying PHP Guestbook application with Redis.

        On the agenda:

        1. Installing Podman Desktop.
        2. Installing and initializing your container engine: Podman.
        3. Installing and starting your local Kubernetes provider: Kind.
        4. Starting the Redis leader.
        5. Starting and scaling the Redis followers.
        6. Starting and exposing the Guestbook frontend.

        Installing Podman Desktop​

        You need Podman Desktop.

        1. Go to Podman Desktop installation documentation.
        2. Click on your platform name: Windows, macOS, or Linux.
        3. Follow the instructions. Stick to the default installation method.
        4. Start Podman Desktop.

        At this point, you have a graphical user interface to:

        • Install Podman and Kind.
        • Control and work with your container engines and Kubernetes clusters.
        • Run your application on your container engine and migrate it to Kubernetes.

        Installing and initializing your container engine: Podman​

        Podman Desktop can control various container engines, such as:

        • Docker
        • Lima
        • Podman

        Consider installing the Podman container engine for:

        • Added security
        • No daemon
        • Open source

        Containers are a Linux technology.

        • On Linux, you can install Podman natively.\nSee: Installing Podman on Linux.
        • On macOS and Windows, Podman requires to run in a Linux virtual machine: the Podman machine.\nUse Podman Desktop to install Podman and initialize your Podman machine:

        Procedure​

        1. Open Podman Desktop Dashboard
        2. The Dashboard displays Podman Desktop was not able to find an installation of Podman.
        3. Click on Install.
        4. Podman Desktop checks the prerequisites to install Podman Engine. When necessary, follow the instructions to install prerequisites.
        5. Podman displays the dialog: Podman is not installed on this system, would you like to install Podman?. Click on Yes to install Podman.
        6. Click on Initialize and start.

        Verification​

        • The Dashboard displays Podman is running.

          \"Podman

        At this point, you can start working with containers.

        Installing and starting your local Kubernetes provider: Kind​

        You want to deploy your application to a local Kubernetes cluster.

        Podman Desktop can help you run Kind-powered local Kubernetes clusters on a container engine, such as Podman.

        Podman Desktop helps you installing the kind CLI:

        1. In the status bar, click on Kind, and follow the prompts.

        2. When the kind CLI is available, the status bar does not display Kind.

        3. On Windows, configure Podman in rootful mode

          $ podman system connection default podman-machine-default-root

        4. Go to Settings > Resources

        5. In the \"Podman Podman tile, click on the icon to restart the Podman container engine.

        6. In the \"Kind Kind tile, click on the Create new button.

          1. Name: enter kind-cluster.
          2. Provider Type: select podman.
          3. HTTP Port: select 9090.
          4. HTTPS Port: select 9443.
          5. Setup an ingress controller: Enabled
          6. Click the Create button.\n\"Create

        7. After successful creation, click on the Go back to resources button

        Verification​

        1. In Settings > Resources your Kind cluster is running/

          \"Kind

        2. In the Podman Desktop tray, open the Kubernetes menu: you can set the context to your Kind cluster: kind-kind-cluster.

          \"Kind

          At this point, you can start working with containers, and your local Kubernetes cluster.

        Additional resources​

        Starting the Redis leader​

        The Guestbook application uses Redis to store its data.

        With Podman Desktop, you can prepare the Redis leader image and container on your local container engine, and deploy the results to a Kubernetes pod and service.\nThis is functionally equal to the redis-leader deployment that the Kubernetes example propose.

        Procedure​

        1. Open Images > Pull an image.

          1. Image to Pull: enter docker.io/redis:6.0.5
          2. Click Pull image to pull the image to your container engine local image registry.
          3. Click Done to get back to the images list.

        2. Search images: enter redis:6.0.5 to find the image.

        3. Click to open the Create a container from image dialog.

          1. Container name: enter leader,
          2. Local port for 6379/tcp: 6379.
          3. Click Start Container to start the container in your container engine.

        4. Search containers: enter leader to find the running container.

        5. Click to stop the container, and leave the 6379 port available for the Redis follower container.

        6. Click > Deploy to Kubernetes to open the Deploy generated pod to Kubernetes screen.

          1. Pod Name: enter redis-leader.
          2. Use Kubernetes Services: select Replace hostPort exposure on containers by Services. It is the recommended way to expose ports, as a cluster policy might prevent to use hostPort.
          3. Expose service locally using Kubernetes Ingress: deselect Create a Kubernetes ingress to get access to the ports that this pod exposes, at the default ingress controller location. Example: on a default Kind cluster created with Podman Desktop: http://localhost:9090. Requirements: your cluster has an ingress controller`.
          4. Kubernetes namespaces: select default.
          5. Click Deploy.\n\"Deploy
          6. Wait for the pod to reach the state: Phase: Running.
          7. Click Done.

        Verification​

        • The Pods screen lists the running redis-leader pod.

          \"leader

        Starting the Redis followers​

        Although the Redis leader is a single Pod, you can make it highly available and meet traffic demands by adding a few Redis followers, or replicas.

        With Podman Desktop, you can prepare the Redis follower image and container on your local container engine, and deploy the results to Kubernetes pods and services.\nThis is functionally equal to the redis-follower deployment that the Kubernetes example propose.

        Procedure​

        1. Open Images > Pull an image.
          1. Image to Pull: enter gcr.io/google_samples/gb-redis-follower:v2
          2. Click Pull image to pull the image to your container engine local image registry.
          3. Click Done to get back to the images list.
        2. Search images: enter gb-redis-follower:v2 to find the image.
        3. Click to open the Create a container from image dialog.
          1. Container name: enter follower,
          2. Local port for 6379/tcp: 6379.
          3. Click Start Container to start the container in your container engine.
        4. Search containers: enter follower to find the running container.
        5. Click to stop the container: you do not need it to run in the container engine.
        6. Click > Deploy to Kubernetes to open the Deploy generated pod to Kubernetes screen.
          1. Pod Name: enter redis-follower.
          2. Use Kubernetes Services: select Replace hostPort exposure on containers by Services. It is the recommended way to expose ports, as a cluster policy might prevent to use hostPort.
          3. Expose service locally using Kubernetes Ingress: deselect Create a Kubernetes ingress to get access to the ports that this pod exposes, at the default ingress controller location. Example: on a default Kind cluster created with Podman Desktop: http://localhost:9090. Requirements: your cluster has an ingress controller`.
          4. Kubernetes namespaces: select default.
          5. Click Deploy.\n\"Deploy
          6. Wait for the pod to reach the state: Phase: Running.
          7. Click Done.
        7. To add replicas, repeat the last step with another Pod Name value.

        Verification​

        • The Pods screen lists the running redis-follower pods.

          \"follower

        Starting the default frontend​

        Now that you have the Redis storage of your Guestbook up and running, start the Guestbook web servers.\nLike the Redis followers, deploy the frontend using Kubernetes pods and services.

        The Guestbook app uses a PHP frontend.\nIt is configured to communicate with either the Redis follower or leader Services, depending on whether the request is a read or a write.\nThe frontend exposes a JSON interface, and serves a jQuery-Ajax-based UX.

        With Podman Desktop, you can prepare the Guestbook frontend image and container on your local container engine, and deploy the results to Kubernetes pods and services.\nThis is functionally equal to the frontend deployment that the Kubernetes example propose.

        Procedure​

        1. Open Images > Pull an image.
          1. Image to Pull: enter gcr.io/google_samples/gb-frontend:v5
          2. Click Pull image to pull the image to your container engine local image registry.
          3. Wait for the pull to complete.
          4. Click Done to get back to the images list.
        2. Search images: enter gb-frontend:v5 to find the image.
        3. Click to open the Create a container from image dialog.
          1. Container name: enter frontend,
          2. Local port for 80/tcp: 9000.
          3. Click Start Container to start the container in your container engine.
        4. Search containers: enter frontend to find the running container.
        5. Click to stop the container: you do not need it to run in the container engine.
        6. Click > Deploy to Kubernetes to open the Deploy generated pod to Kubernetes screen.
          1. Pod Name: enter frontend.
          2. Use Kubernetes Services: select Replace hostPort exposure on containers by Services. It is the recommended way to expose ports, as a cluster policy might prevent to use hostPort.
          3. Expose service locally using Kubernetes Ingress: select Create a Kubernetes ingress to get access to the ports that this pod exposes, at the default ingress controller location. Example: on a default Kind cluster created with Podman Desktop: http://localhost:9090. Requirements: your cluster has an ingress controller`.
          4. Kubernetes namespaces: select default.
          5. Click Deploy.\n\"Deploy
          6. Wait for the pod to reach the state: Phase: Running.
          7. Click Done.

        Verification​

        1. The Pods screen lists the running frontend pod.

          \"`frontend`

        2. Go to http://localhost:9090: the Guestbook application is running.

        ", + "content_html": "

        In this blog post you will learn to use Podman Desktop to run the Kubernetes documentation example: Deploying PHP Guestbook application with Redis.

        On the agenda:

        1. Installing Podman Desktop.
        2. Installing and initializing your container engine: Podman.
        3. Installing and starting your local Kubernetes provider: Kind.
        4. Starting the Redis leader.
        5. Starting and scaling the Redis followers.
        6. Starting and exposing the Guestbook frontend.

        Installing Podman Desktop​

        You need Podman Desktop.

        1. Go to Podman Desktop installation documentation.
        2. Click on your platform name: Windows, macOS, or Linux.
        3. Follow the instructions. Stick to the default installation method.
        4. Start Podman Desktop.

        At this point, you have a graphical user interface to:

        • Install Podman and Kind.
        • Control and work with your container engines and Kubernetes clusters.
        • Run your application on your container engine and migrate it to Kubernetes.

        Installing and initializing your container engine: Podman​

        Podman Desktop can control various container engines, such as:

        • Docker
        • Lima
        • Podman

        Consider installing the Podman container engine for:

        • Added security
        • No daemon
        • Open source

        Containers are a Linux technology.

        • On Linux, you can install Podman natively.\nSee: Installing Podman on Linux.
        • On macOS and Windows, Podman requires to run in a Linux virtual machine: the Podman machine.\nUse Podman Desktop to install Podman and initialize your Podman machine:

        Procedure​

        1. Open Podman Desktop Dashboard
        2. The Dashboard displays Podman Desktop was not able to find an installation of Podman.
        3. Click on Install.
        4. Podman Desktop checks the prerequisites to install Podman Engine. When necessary, follow the instructions to install prerequisites.
        5. Podman displays the dialog: Podman is not installed on this system, would you like to install Podman?. Click on Yes to install Podman.
        6. Click on Initialize and start.

        Verification​

        • The Dashboard displays Podman is running.

          \"Podman

        At this point, you can start working with containers.

        Installing and starting your local Kubernetes provider: Kind​

        You want to deploy your application to a local Kubernetes cluster.

        Podman Desktop can help you run Kind-powered local Kubernetes clusters on a container engine, such as Podman.

        Podman Desktop helps you installing the kind CLI:

        1. In the status bar, click on Kind, and follow the prompts.

        2. When the kind CLI is available, the status bar does not display Kind.

        3. On Windows, configure Podman in rootful mode

          $ podman system connection default podman-machine-default-root

        4. Go to Settings > Resources

        5. In the \"Podman Podman tile, click on the icon to restart the Podman container engine.

        6. In the \"Kind Kind tile, click on the Create new button.

          1. Name: enter kind-cluster.
          2. Provider Type: select podman.
          3. HTTP Port: select 9090.
          4. HTTPS Port: select 9443.
          5. Setup an ingress controller: Enabled
          6. Click the Create button.\n\"Create

        7. After successful creation, click on the Go back to resources button

        Verification​

        1. In Settings > Resources your Kind cluster is running/

          \"Kind

        2. In the Podman Desktop tray, open the Kubernetes menu: you can set the context to your Kind cluster: kind-kind-cluster.

          \"Kind

          At this point, you can start working with containers, and your local Kubernetes cluster.

        Additional resources​

        Starting the Redis leader​

        The Guestbook application uses Redis to store its data.

        With Podman Desktop, you can prepare the Redis leader image and container on your local container engine, and deploy the results to a Kubernetes pod and service.\nThis is functionally equal to the redis-leader deployment that the Kubernetes example propose.

        Procedure​

        1. Open Images > Pull an image.

          1. Image to Pull: enter docker.io/redis:6.0.5
          2. Click Pull image to pull the image to your container engine local image registry.
          3. Click Done to get back to the images list.

        2. Search images: enter redis:6.0.5 to find the image.

        3. Click to open the Create a container from image dialog.

          1. Container name: enter leader,
          2. Local port for 6379/tcp: 6379.
          3. Click Start Container to start the container in your container engine.

        4. Search containers: enter leader to find the running container.

        5. Click to stop the container, and leave the 6379 port available for the Redis follower container.

        6. Click > Deploy to Kubernetes to open the Deploy generated pod to Kubernetes screen.

          1. Pod Name: enter redis-leader.
          2. Use Kubernetes Services: select Replace hostPort exposure on containers by Services. It is the recommended way to expose ports, as a cluster policy might prevent to use hostPort.
          3. Expose service locally using Kubernetes Ingress: deselect Create a Kubernetes ingress to get access to the ports that this pod exposes, at the default ingress controller location. Example: on a default Kind cluster created with Podman Desktop: http://localhost:9090. Requirements: your cluster has an ingress controller`.
          4. Kubernetes namespaces: select default.
          5. Click Deploy.\n\"Deploy
          6. Wait for the pod to reach the state: Phase: Running.
          7. Click Done.

        Verification​

        • The Pods screen lists the running redis-leader pod.

          \"leader

        Starting the Redis followers​

        Although the Redis leader is a single Pod, you can make it highly available and meet traffic demands by adding a few Redis followers, or replicas.

        With Podman Desktop, you can prepare the Redis follower image and container on your local container engine, and deploy the results to Kubernetes pods and services.\nThis is functionally equal to the redis-follower deployment that the Kubernetes example propose.

        Procedure​

        1. Open Images > Pull an image.
          1. Image to Pull: enter gcr.io/google_samples/gb-redis-follower:v2
          2. Click Pull image to pull the image to your container engine local image registry.
          3. Click Done to get back to the images list.
        2. Search images: enter gb-redis-follower:v2 to find the image.
        3. Click to open the Create a container from image dialog.
          1. Container name: enter follower,
          2. Local port for 6379/tcp: 6379.
          3. Click Start Container to start the container in your container engine.
        4. Search containers: enter follower to find the running container.
        5. Click to stop the container: you do not need it to run in the container engine.
        6. Click > Deploy to Kubernetes to open the Deploy generated pod to Kubernetes screen.
          1. Pod Name: enter redis-follower.
          2. Use Kubernetes Services: select Replace hostPort exposure on containers by Services. It is the recommended way to expose ports, as a cluster policy might prevent to use hostPort.
          3. Expose service locally using Kubernetes Ingress: deselect Create a Kubernetes ingress to get access to the ports that this pod exposes, at the default ingress controller location. Example: on a default Kind cluster created with Podman Desktop: http://localhost:9090. Requirements: your cluster has an ingress controller`.
          4. Kubernetes namespaces: select default.
          5. Click Deploy.\n\"Deploy
          6. Wait for the pod to reach the state: Phase: Running.
          7. Click Done.
        7. To add replicas, repeat the last step with another Pod Name value.

        Verification​

        • The Pods screen lists the running redis-follower pods.

          \"follower

        Starting the default frontend​

        Now that you have the Redis storage of your Guestbook up and running, start the Guestbook web servers.\nLike the Redis followers, deploy the frontend using Kubernetes pods and services.

        The Guestbook app uses a PHP frontend.\nIt is configured to communicate with either the Redis follower or leader Services, depending on whether the request is a read or a write.\nThe frontend exposes a JSON interface, and serves a jQuery-Ajax-based UX.

        With Podman Desktop, you can prepare the Guestbook frontend image and container on your local container engine, and deploy the results to Kubernetes pods and services.\nThis is functionally equal to the frontend deployment that the Kubernetes example propose.

        Procedure​

        1. Open Images > Pull an image.
          1. Image to Pull: enter gcr.io/google_samples/gb-frontend:v5
          2. Click Pull image to pull the image to your container engine local image registry.
          3. Wait for the pull to complete.
          4. Click Done to get back to the images list.
        2. Search images: enter gb-frontend:v5 to find the image.
        3. Click to open the Create a container from image dialog.
          1. Container name: enter frontend,
          2. Local port for 80/tcp: 9000.
          3. Click Start Container to start the container in your container engine.
        4. Search containers: enter frontend to find the running container.
        5. Click to stop the container: you do not need it to run in the container engine.
        6. Click > Deploy to Kubernetes to open the Deploy generated pod to Kubernetes screen.
          1. Pod Name: enter frontend.
          2. Use Kubernetes Services: select Replace hostPort exposure on containers by Services. It is the recommended way to expose ports, as a cluster policy might prevent to use hostPort.
          3. Expose service locally using Kubernetes Ingress: select Create a Kubernetes ingress to get access to the ports that this pod exposes, at the default ingress controller location. Example: on a default Kind cluster created with Podman Desktop: http://localhost:9090. Requirements: your cluster has an ingress controller`.
          4. Kubernetes namespaces: select default.
          5. Click Deploy.\n\"Deploy
          6. Wait for the pod to reach the state: Phase: Running.
          7. Click Done.

        Verification​

        1. The Pods screen lists the running frontend pod.

          \"`frontend`

        2. Go to http://localhost:9090: the Guestbook application is running.

        ", "url": "https://podman-desktop.io/blog/running-a-local-kubernetes-cluster-with-podman-desktop", "title": "Setting up and running a Kubernetes cluster locally with Podman Desktop", "summary": "Setting up and running a Kubernetes cluster locally with Podman Desktop", diff --git a/blog/podman-desktop-release-0.10.html b/blog/podman-desktop-release-0.10.html index c077e0e15e1..d726ffdc820 100644 --- a/blog/podman-desktop-release-0.10.html +++ b/blog/podman-desktop-release-0.10.html @@ -13,13 +13,13 @@ - +

        Release Notes - Podman Desktop 0.10

        · 5 min read
        Dev Kumar

        This release note covers Podman Desktop 0.10 release changes.

        • Containers Configuration: Container creation wizzard allowing to define environment variables, networking and more configuration options.
        • Kubernetes Improvements: Play Kubernetes YAML, custom Kubeconfig path support, reload of kube context.
        • Registries Configuration: Revamped registries configuration UI.
        • Podman Version: Podman 4.3.1 now included in Windows and Mac installers.
        • UX/UI Improvements: Improved lists, better contrast, and more.

        Podman Desktop 0.10 is now available. Click here to download it!

        Release Details​

        New configuration wizzard to create containers (#773)​

        Until now, we could only specify port binding when building images to start containers. The create container wizzard now includes several options enabling configuring volumes, environment variables, restart policy and settings on networking and security. It is also possible to reuse an existing (and already configured) a network when creating containers.

        new container creation wizard

        Kubernetes Capabilities Improvements​

        Custom Kubeconfig file path (#780)

        Kubeconfig path location is now configurable from Settings > Preferences > Kubernetes: Kubeconfig and can be set to a custom path. By default, Podman Desktop use the path $HOME/.kube/config for the Kubeconfig file.

        custom kubeconfig file path

        Play Kubernetes YAML from the Pods list (#739)

        Podman Desktop enables to play existing Kubernetes YAML files. This is now available from Play Kubernetes YAML button added to the Pods list, in addition to the Containers list.

        play k8s yaml

        Kube context automatically reloaded when updated (#813)

        Any change to the kube context will now be detected by Podman Desktop in its running state. The system tray, allowing to select which Kubernetes environment to work with, will now reload the kube context without restarting Podman Desktop.

        Revamped Container Registries UI (#446)​

        The registries configuration UI has been revamped. Instead of using tiles for displaying the registries, now it uses a list where each registry can be added or edited directly in the list. The kebab menu provides options to edit or remove a registry from the list.

        registries

        Update to Podman 4.3.1 (#913)​

        Podman Desktop 0.10 is now embedding Podman 4.3.1 in Windows and macOS installers.

        UI/UX Improvements​

        Improved lists UX (#877)

        To reduce the width used in the lists when displaying all the icons, main actions icons are now always displayed (before it was on hover) and the secondary actions are displayed in a kebab menu. For example Start/Stop and delete are primary actions while open the browser, inspect, generate kube yaml, etc. are secondary options.

        kebab menu

        Delay appearance of text in navbar (#767)

        When minimizing or expanding the navbar, the text was overlapping for a few second the page. Now it's displayed with a fading animation.

        Selected state: better text color contrast (#802)

        In the Images page, on hover for both the image and the name column, the text contrast has been increased for better visibility: violet indicates that you have selected it.

        text color when hover

        On Linux and Windows, the menu bar is now hidden by default (#668)

        With this change, the menu bar looks more integrated to the Operating System. The menu can appear if you hit the Alt key. Thanks to Dylan M. Taylor for contributing to fix this.

        Exit when clicking on the close icon of the dashboard on Linux (#671)

        For most users on Linux, there is no tray icon support. In this situation, when closed, Podman Desktop continues to run in background. Dylan M. Taylor added a property to exit the app by default when clicking on the close icon. For people having tray icon support or with the desire of a different behavior, it is possible to disable it from the Settings.

        Other Notable Enhancements​

        • Rename Started into Age in Containers list.(#878)
        • Added domain validation when adding a registry. (#838)
        • Provided a consistent behavior with Podman CLI, podman-machine-default is now the default name when creating a Podman machine from Podman Desktop. (#775)

        Notable bug fixes​

        • Fixed error handling when pulling images of Desktop Extensions. (#782)
        • Fixed use of the full height of the screen when displaying log in the details of a container. (#946)
        • Fixed First start of Podman Desktop on flatpak was not seeing the podman engine (#860)

        Community Thank You​

        🎉 We’d like to say a big thank you to everyone who helped to make Podman Desktop 0.10 even better:

        Final Notes​

        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.

        - + \ No newline at end of file diff --git a/blog/podman-desktop-release-0.11.html b/blog/podman-desktop-release-0.11.html index 7e88738ee7c..d62b3415565 100644 --- a/blog/podman-desktop-release-0.11.html +++ b/blog/podman-desktop-release-0.11.html @@ -13,7 +13,7 @@ - + @@ -24,7 +24,7 @@ Please note, that those binaries are available only on releases and not the pre- mac-docker-compatibility

        Allow to toggle on/off the proxy setting #983​

        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.

        Namespace selection for deploy to Kubernetes #1008​

        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.

        deploy-kubernetes-namespace

        Configure Podman binary path #941​

        Users may 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. Additional information is available in the documentation for Mac users: http://podman-desktop.io/docs/troubleshooting#unable-to-set-custom-binary-path-for-podman-on-macos

        custom-path

        Provide pre-defined registries #1201​

        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:

        • Dockerhub
        • Red Hat Quay
        • GitHub
        • IBM Container Registry
        • Google Container Registry

        UI/UX Improvements​

        View Pods logs #1122​

        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.

        pods-logs

        Improved feedback when clicking on container list action icons #1150 #1161​

        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.

        Allows to change the default font size for the editor #1160​

        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).

        Keep expanded state of pods when refreshing containers #1042​

        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.

        Click on the Pod name redirects to the Pod details page #1159​

        The list of containers also displays pods, now clicking on the pod name directly redirects to the Pod details page.

        Improved styles of buttons for actions #984​

        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 lists: list-actions

        On details pages: details-actions

        Improved alignments in pages with lists #1182​

        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.

        list-actions

        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)

        Documentation​

        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:

        Several of other improvements have been made to the documentation and the website:

        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:

        Final Notes​

        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.

        - + \ No newline at end of file diff --git a/blog/podman-desktop-release-0.12.html b/blog/podman-desktop-release-0.12.html index d0109bbef7a..ab2aa1b2cd5 100644 --- a/blog/podman-desktop-release-0.12.html +++ b/blog/podman-desktop-release-0.12.html @@ -13,14 +13,14 @@ - +

        Release Notes - Podman Desktop 0.12

        · 5 min read
        Stevan Le Meur

        This release note covers Podman Desktop 0.12 release changes.

        • Podman Version: Podman 4.4.1 now included in Windows and Mac installers.
        • Containers Configuration: Configure port mappings for an image without exported ports.
        • Windows Home Support: Podman Desktop now supports Windows Home Edition.
        • Start minimized: Option to start Podman Desktop minimized to system tray.
        • UX and UI Improvements: Consistent actions, placeholder for logs, unified icons and others.

        Podman Desktop 0.12 is now available. Click here to download it!

        podman-desktop-0-12-hero

        Release Details​

        Update to Podman v4.4.1 #1456​

        Podman Desktop 0.12 embeds Podman 4.4.1 in Windows and macOS installers. Make sure to upgrade to benefit from the latest Podman features and bug fixes.

        Configuring port mappings when an image has no exported port #1265​

        With the latest update, users can now add multiple local-to-remote port mappings when starting a container from an image that has no exported ports. This feature provides users with the flexibility to specify which ports on their local machine should map to which ports on the container, even if the container does not have any exported ports by default.

        port-mapping

        Installing Podman Dekstop on Windows Home Edition #1268​

        Podman Desktop 0.12 offers the ability to be installed on Windows Home Edition. The mechanism uses Virtual Machine Platform detection, instead of hyper-v. WSL2 is still requires but can be installed along with the installation process.

        install-windows-home-edition-2

        Option to automatically minimize Podman Desktop on login #1374​

        Podman Desktop now provides a "start minimized" option when users log in onto the laptop. This option, available from the application's settings, can be useful if users want to automatically launch Podman Desktop at log in, but prefer not to have the window visible on the screen. With this feature, you can ensure that Podman Desktop is up and running in the background without any interruption to your workflows.

        • Go to Settings > Preferences > Login: Minimize to activate the option.

        minimize-on-login

        UI and UX Improvements​

        Improved actions consistency #1225​

        Actions displayed in the list pages for Images and Containers have been reviewed and made consistent between other pages.

        action-consistency-1

        Actions displayed in the header of the container's details page have been improved so that the actions are always displayed in the same order.

        action-consistency-2

        Consistent status icons for Pods, Containers, Images and Volumes #1326, #1377, #1459 and #1245​

        The status icons for Pods, Containers, Images, and Volumes have been unified and use consistent states.

        pods-status-icon

        Icons in empty screens have been updated to use the same consistent SVG icon as the status icons.

        empty-screen-2

        Placeholder when logs for containers are being fetched #1353​

        A placeholder is now displayed when logs are being fetched. placeholder-loading-logs

        Fixed alignement in badges from the navigation sidebar #1357​

        Badges in the sidebar are now aligned with the title of the section.

        alignement-badges

        Enable/disable open browser action based on container state #1395 and #1397​

        The action to open the browser if a port is opened in a container, is now disabled when the container is stopped. It is also hidden in the kebab menu.

        enable-disable-container-actions

        Other Notable Enhancements​

        • Display extension icons #1058
        • Solid Icons #1267
        • Differentiate icons compared to status icons #1268
        • Refactors window initializing #1309
        • Change window creation background color to dark #1310
        • Use Podman machine inspect to read the address to connect to the Podman machine #1364
        • Update the editor content when the pod name changes, and disable the deploy button when empty #1403
        • Ability to manually set color of tray icon for Windows and Linux #1243
        • Better UI feedback when starting pods #1242

        Documentation​

        The documentation had many editorial reviews, and new content.

        Notable bug fixes​

        • Fixed handling path with spaces on Windows when installing Podman #1270
        • Removed padding from SVG icons #1253
        • Website: fixed download links for Windows and macOS binaries #1255
        • Fixed prettier commands on Windows #1266
        • Fixed new xterm instance spawn when clicking the logs route #1344
        • Fixed need to wait that telemetry has been initilized before proceeding #1373
        • Fixed new xterm instance spawn when clicking the logs route in pod details#1393
        • Fixed stop spinner if image cannot be retrieved #1394
        • Fixed escape command with quotes only for Windows #1462
        • Fixed random CRC status change #1420

        Community Thank You​

        🎉 We’d like to say a big thank you to everyone who helped to make Podman Desktop 0.12 even better:

        Final Notes​

        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.

        - + \ No newline at end of file diff --git a/blog/podman-desktop-release-0.13.html b/blog/podman-desktop-release-0.13.html index e7f5bfd5471..4146811fb5b 100644 --- a/blog/podman-desktop-release-0.13.html +++ b/blog/podman-desktop-release-0.13.html @@ -13,7 +13,7 @@ - + @@ -21,7 +21,7 @@

        Release Notes - Podman Desktop 0.13

        · 4 min read
        Tim deBoer

        This release note covers Podman Desktop 0.13 release changes.

        • Podman Version: Podman 4.4.4 now included in Windows and Mac installers.
        • Compose: Support for installing Docker Compose.
        • Extensions: Improved extension support for Podman Desktop with additional capabilities.
        • UX and UI Improvements: Welcome page, task manager, resources, and update alerts.

        Podman Desktop 0.13 is now available. Click here to download it!

        Podman-desktop-0-13-hero

        Release details​

        Update to Podman v4.4.4​

        Podman Desktop 0.13 embeds Podman 4.4.4 in Windows and macOS installers #1456.

        Compose support​

        You can install Docker Compose from the Podman Desktop UI #1578. This will allow you use Compose workflows using Podman.

        Extensions​

        To make it easier to extend Podman Desktop we have:

        UI and UX improvements​

        Welcome page #1726​

        The first time every user starts Podman Desktop, they will see a welcome page:

        welcome-page

        Note that the Welcome page will only appear the first time you run Podman Desktop 0.13.0, and none of your settings or assets in Podman Desktop will be affected by it. Over time, this page will be expanded to help with initial setup and configuration.

        New Task Manager #1724​

        A new Task Manager has been added to the status bar to see the progress (or return to) long running tasks. To start with, building images #1725 and Podman machine #1742 are using the task manager.

        task-manager

        Updated Resources Settings #1582​

        The Settings > Resources page has been updated with a new design, making it easier to see and control your providers from a single place.

        resources

        The other settings pages have been updated for consistency with this new design.

        Update Alerts #1827​

        A new alert button will appear in the status bar when future updates are available.

        Prune buttons #1481, #1482, #1484​

        We've added buttons to prune unused volumes #1481, images #1482 and pods #1484.

        prune-image

        Other notable enhancements​

        • Kubernetes pods are now shown in the Pods view #1312
        • Easy button to fix Docker compatibility mode on macOS #1697
        • Display extension icons #1058
        • API to cancel long running tasks #1777

        Documentation​

        The documentation has new content:

        Notable bug fixes​

        • Periodically check and refresh Podman connection on Windows and Mac #1662
        • Fix inconsistent Log view behaviour #1710
        • Don't create route for regular Kubernetes clusters #1707
        • Fix copy button on empty screen #1804
        • Register extension tray items correctly #1778 and handle updates #1800

        Community thank you​

        🎉 We’d like to say a big thank you to everyone who helped to make Podman Desktop 0.13 even better:

        Final notes​

        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.

        - + \ No newline at end of file diff --git a/blog/podman-desktop-release-0.14.html b/blog/podman-desktop-release-0.14.html index de26fe9a294..078640210df 100644 --- a/blog/podman-desktop-release-0.14.html +++ b/blog/podman-desktop-release-0.14.html @@ -13,7 +13,7 @@ - + @@ -46,7 +46,7 @@ making it easier to see and change preferences. Changes are live, no more Update 1927 This is more usable, one less prompt, and solves a window-layering issue for some users!

        telemetry prompt

        Other notable enhancements​

        • Extension support for opening an external URL 2028 and accessing the clipboard 2023

        Documentation​

        Naturally, we have a section in the documentation just for Kind.

        Notable bug fixes​

        • Avoid a dialog box if unable to check for updates 2062
        • Unable to get to the Dashboard if Kind (or Kubernetes) cluster was not running 2052

        Final notes​

        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.

        - + \ No newline at end of file diff --git a/blog/podman-desktop-release-0.15.html b/blog/podman-desktop-release-0.15.html index 48077e08a36..beba8cc7afe 100644 --- a/blog/podman-desktop-release-0.15.html +++ b/blog/podman-desktop-release-0.15.html @@ -13,7 +13,7 @@ - + @@ -41,7 +41,7 @@ provider properties/creation pages

        Other Notable Enhancements​

        • We know which Settings page is used the most often, so now it's the default: Settings > Resources #2105.

        • Extensions can now use the Tasks API to let long running tasks continue in the background #2019 and the existing withProgress API also uses the task manager now #2187.

        Task API

        • Images are now sorted by age #2311.

        • When you start/stop a container or pod, the button is now animated instead of having an separate spinner #2101.

        • The Settings > Preferences page now has a search bar #2128.

        Search preferences

        • The Help page has been updated #431.

        Updated Help

        Notable Bug Fixes​

        • There was no way to see log or outcome if you leave the Kind cluster creation page #2079.
        • Kind image load doesn't show a notification #2225.
        • Fix odd selection in Settings > Extensions #2130.
        • Menus are now cleaned up properly when extensions are stopped #2188.
        • Kind clusters are now cleaned up when Podman machine is stopped #2306.

        Final notes​

        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.

        - + \ No newline at end of file diff --git a/blog/podman-desktop-release-1.0.html b/blog/podman-desktop-release-1.0.html index d6a4e91d9aa..65ac0eb0109 100644 --- a/blog/podman-desktop-release-1.0.html +++ b/blog/podman-desktop-release-1.0.html @@ -13,7 +13,7 @@ - + @@ -94,7 +94,7 @@ to get us here:

        ucomesdag, xbabalov, zezo2019.

        Final notes​

        The complete list of issues fixed in this release is available here and 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.

        - + \ No newline at end of file diff --git a/blog/podman-desktop-release-1.1.html b/blog/podman-desktop-release-1.1.html index 90cfd48143b..7714da4fe1b 100644 --- a/blog/podman-desktop-release-1.1.html +++ b/blog/podman-desktop-release-1.1.html @@ -13,7 +13,7 @@ - + @@ -26,7 +26,7 @@ automatically check for and install extension updates.

        - + \ No newline at end of file diff --git a/blog/podman-desktop-release-1.2.html b/blog/podman-desktop-release-1.2.html index de7542141fd..a93d93f0add 100644 --- a/blog/podman-desktop-release-1.2.html +++ b/blog/podman-desktop-release-1.2.html @@ -13,13 +13,13 @@ - +

        Release Notes - Podman Desktop 1.2

        · 7 min read
        Charlie Drage

        Podman Desktop 1.2 Release! 🎉

        We're excited to announce the release of Podman Desktop version 1.2.0! This release includes many new features (Kubernetes, Compose and extension support!), bug fixes, and improvements to enhance your container management experience. Here's a summary of the key changes in this release:

        • Added start/stop/delete/restart buttons for Compose: You can now make changes to an entire Compose group of containers
        • Kubernetes context on the status bar: Choose from multiple Kubernetes contexts more easily all from the status bar
        • Rename images: Rename an image with a click of a button
        • Protocol handler support: Added support for protocol handlers such as open podman-desktop:extension/redhat.openshift-local
        • Troubleshooting page: A troubleshooting page for helping diagnose Podman Desktop related development issues

        Podman Desktop 1.2 is now available. Click here to download it!

        Podman-desktop-1-2-hero

        Release Details​

        Added start/stop/delete/restart buttons for Compose​

        In the last month we've been addind support for more Compose features. Before you were only able to control a group of containers if they were in a Pod. Now we have added the ability to control a group of Compose containers. You can now start, stop, delete and restart a group of containers launched by either docker-compose or podman-compose.

        Stay tuned as we add even more features to Compose! If you have any feedback or feature requests, feel free to open an issue or start a discussion on GitHub.

        Kubernetes context on the status bar​

        With Kubernetes context on the status bar, you can switch from one context to another in just a couple of clicks. Easily switch to a different cluster all together. If there are multiple contexts available, you can now click and pick which one to use.

        Rename images​

        Deployed an image but now you need to rename it / add a new tag? Podman Desktop allows you to edit an image now. Thanks to an awesome contributor @tuckerrc who added the new feature.

        Troubleshooting page​

        Developing an extension for Podman Desktop? Want to view the logs of Podman Desktop as well as ping your container connection? We now have a troubleshooting page!

        Click on the lightbulb button on the bottom right to access the page.

        Protocol handler support​

        Podman Desktop now supports protocol handling when using the terminal! Want to access your favourite extension directly from a script or the terminal? If you type in open podman-desktop:extension/redhat.openshift-local in the terminal, Podman Desktop will automatically load up to the correct extension.

        Other Notable Features​

        • Background colors and FormPage (PR #2977)
        • Add ability to add insecure registry / skipping cert verify (PR #2896)
        • Add support for icon contribution (PR #2984)
        • Add warning dialog message that virtual machine has low memory limit (PR #2822)
        • Propose indexed name for new pod (PR #3028)
        • Add restart button after enabling / disabling mac os compatibility (PR #2841)
        • Add environment related helper constants (PR #3079)
        • Allow entrypoint and cmd when starting container (PR #3031)
        • Add a way to debug stores in troubleshooting page (PR #3121)
        • Add custompick component (#2855) (PR #3012)
        • Dynamic breadcrumbs (PR #3119)
        • Icons on form pages (PR #3155)
        • Switch more pages to formpage (PR #3162)
        • Add rename image button (PR #2588)
        • Fixed headers, improved scrollbars (PR #2863)
        • Reports warnings on failed kube deploy, fixes error out (PR #3050)
        • Kube context on statusbar (PR #2755)
        • Install provider if not installed when clicking on create new button (#2706) (PR #2817)
        • Add tag and authenticated push capacity to the extension API (PR #2876)
        • Add navigation bar e2e tests (PR #2950)

        Documentation Updates​

        • Fix documentation for building image of extensions (PR #2873)
        • Add Minikube install docs (PR #2824)
        • Add Minikube documentation (PR #2694)
        • Updated Building an image procedure (PR #2964)
        • Starting a container (PR #2958)
        • Pulling an image (PR #2956)
        • Updated selecting containers to run in a pod (PR #2970)
        • Pushing an image to a registry (PR #2969)
        • How to add an insecure registry (PR #2953)
        • Add documentation for lima (PR #2995)
        • Replace broken link to podman.io (PR #2994)
        • Authenticating to a pre-configured registry (PR #2965)
        • Lima is not a container engine (PR #3051)
        • Using the Troubleshooting page (PR #3083)
        • View and select your current Kubernetes context in the status bar (PR #3090)

        Notable Bug Fixes​

        • Deleting a running pod generates an error (PR #2827)
        • If kubeconfig is empty, does not try to do things, cancel (PR #2874)
        • Async telemetry startup (PR #2885)
        • Do not block startup while waiting for kube resource refresh (PR #2884)
        • Images list too wide (PR #2918)
        • Compose deactivate function never called (PR #2922)
        • Auto-scrolling on form pages, layout issues (PR #2927)
        • Show current context in quick pick (PR #2920)
        • Remove sticky position of loader in dashboard UI (#2535) (PR #2959)
        • Undo change that broke the website (PR #2992)
        • Detailspage, resizing & consistency (PR #2987)
        • Quick pick click to close and over nav bar (PR #2758)
        • Only show empty screen when no pods (PR #2929)
        • Do not redirect to /pods when deleting pod in containerlist (PR #2963)
        • Bulk delete on pods should call the pod deletion (PR #2979)
        • Update nodejs version to 18 in .nvmrc to fix yarn install failure (PR #2989)
        • Website check targets (PR #2996)
        • Don't show exception to user (PR #3034)
        • Interpret arguments given to info command for example (PR #3015)
        • Change defaults for Podman machine (PR #3061)
        • Normalize development/production folders path (PR #3113)
        • Calculate machine socket path for linux (PR #3070)
        • Replace backslash with slash so to support rendering on Windows (#3120) (PR #3122)
        • Keep stdout and stderr in the error object for Docker Desktop extensions (PR #3014)
        • Mark task completed if there's a failure (PR #3016)
        • Handle invalid kubeconfig file (PR #3129)
        • Do not remove registries when podman extension is stopping (PR #3136)
        • Warning should be amber (PR #3153)
        • Load user extensions from plugins as removable (PR #3152)
        • Images with spaces in entrypoints or commands fail to start (PR #3161)
        • Scrolling offscreen when clicking checkbox (PR #3178)
        • Avoid messagebox expanding offscreen (PR #2778)
        • Release-notes-generator run failure (PR #2752)
        • Unable to do a new build if the previous one failed (PR #2721)

        Community Thank You​

        🎉 We’d like to say a big thank you to everyone who helped to make Podman Desktop even better.

        A big shoutout to @afbjorklund, @tuckerrc and @evanshortiss who contributed to this release!

        Final notes​

        The complete list of issues fixed in this release is available here and 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.

        - + \ No newline at end of file diff --git a/blog/podman-desktop-release-1.3.html b/blog/podman-desktop-release-1.3.html index 54225182ee3..ec38d345ca5 100644 --- a/blog/podman-desktop-release-1.3.html +++ b/blog/podman-desktop-release-1.3.html @@ -13,14 +13,14 @@ - +

        Release Notes - Podman Desktop 1.3

        · 6 min read
        Denis Golovin

        Podman Desktop 1.3 Release! 🎉

        This is essentially a bug-fix release to fix various issues in UI, extension engine and featured extensions, but as usual we also added a few new features.

        • Podman 4.6.1: Podman 4.6.1 included in Windows and Mac installers
        • Podman user-mode networking support to Windows/WSL: A new switch `User mode networking' is available when creating Podman machine on Windows for Podman 4.6.0+ to configure podman to work in certain VPN setups and other specialized networking configurations
        • Compose group new UI elements: You can now see summary, inspect, deploy to kubernetes, generate kube yaml and view logs
        • Extension packs and extension dependencies: Install group of extensions in one click
        • Resource details page update: See summary and log for resource
        • Create Kind cluster form update: A new Node's container image field can be used to specify the Kubernetes version used for the control-planed
        • Support Docker Desktop extensions using a backend: When loading Docker Desktop extension the containers are created in the backend as described in the vm section of extension's descriptor
        • Podman Initial Onboarding (preview): Install and configure podman using included installer

        Podman Desktop 1.3 is now available. Click here to download it!

        Podman-desktop-1-3-bug-swatting

        Release Details​

        Compose group Logs tab #3176​

        When clicking on the group of containers, you can now view the logs of the entire group of compose containers and don't need to open log for every component individually.

        Screenshot 2023-07-11 at 12 48 47 PM

        Podman user-mode networking support to Windows/WSL #3251​

        Certain VPN setups or other specialized networking configs will block traffic from the virtual WSL networking device, resulting in the podman WSL backend from being unable to contact systems on the VPN, and potentially losing internet access altogether. The new switch allows you to create a podman VM machine configured to work correctly in mentioned above networking environments.

        user

        Compose group Summary tab #3317,​

        Compose group Summary tab shows all containers in the group and let you navigate to Details page for specific container.

        Compose group Inspect tab #3316​

        Compose group Inspect tab shows an array of "container inspect" from docker / podman.

        Deploy to kubernetes in compose actions #3299​

        A button to deploy to kubernetes added to Compose group.

        Generate Kube in Compose actions and Kube tab in compose details #3253​

        Generate Kube item added to Compose actions and "Kube" tab is now available in Compose details view.

        Install multiple extensions using extension pack #3150​

        An Extension pack introduced in Extension engine is a way to declare set of extensions to install them all at once.

        Customize icons from extension #3131​

        Extensions now can customize icons for list elements using when clause.

        image

        Resource details page update #1923​

        If you click on the arrow icon next to a resource name it will open up a details page (similarly to how clicking on a container in the container list opens up a details page).

        image

        Node's container image field added to Create a Kind cluster form #3508​

        The new Node's container image field can be used to specify the Kubernetes version used for the control-planed.

        image

        Support Docker Desktop extensions using a backend #3435​

        Podman Desktop now loads the containers in the backend as described in the vm section of extension descriptor the same way as Docker Desktop does.

        Initial onboarding implementation for podman (experimental) #3308​

        This is the initial implementation for the onboarding feature. It only covers a simple onboarding for podman. Check system requirements -> install podman -> yay! Done!

        Notable Bug Fixes​

        • Updating videos to be adaptive for mobile by @mairin #3229
        • Consistent max width and padding in settings by @deboer-tim #3232
        • Settings navigation bar resizing by @deboer-tim in #3231
        • Move new registry button to header by @deboer-tim #3245
        • Bigger lima logo by @afbjorklund #3248
        • Horizontal docker logo by @afbjorklund #3236
        • Respect LIMA_HOME environment variable by @afbjorklund #3254
        • Add check before writing to terminal by @lstocchi #3263
        • Wait until remote side has fully initialized the extensions by @benoitf #3257
        • Fix loader not centered horizontally by @benoitf #3270
        • Troubleshooting still waiting after failure by @deboer-tim #3354
        • Store error for build by @cdrage #3365
        • Missing checkbox tooltips by @deboer-tim #3380
        • Load compose logs async not await by @cdrage #3377
        • Set rootful connection when starting rootful machine by @lstocchi #3364
        • Default last page by @deboer-tim #3388
        • Avoid dashboard displaying providers starting while they don't by @benoitf #3451
        • Do not use extensionInfo until it is defined by @benoitf #V
        • Allow BASIC authentication (all caps) by @cdrage #3471
        • Allow single domain registry such as localhost:5000 by @cdrage #3468
        • Create /usr/local/bin directory if it does not exist on binary install by @cdrage #3425
        • Only delete selected pods by @deboer-tim #
        • Add back 'Done' text on the button by @benoitf #3487
        • Do not wait for more than 5s when checking for podman ping by @benoitf #3497
        • Add proxy support for extension using patching get and request approach by @dgolovin #2825
        • Refresh component when field is updated by @benoitf #3525
        • Higher-res icons for featured extensions list by @mairin #3511
        • Main nav selection by @deboer-tim #3510
        • kube event error when switching context by @jeffmaury #3494
        • Reset error message each time we pull image by @benoitf #3550

        Community Thank You​

        🎉 We’d like to say a big thank you to everyone who helped to make Podman Desktop even better.

        A warm welcome to @rostalan and @axel7083 who made their first contribution to the project in this release.

        Final Notes​

        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.

        - + \ No newline at end of file diff --git a/blog/rss.xml b/blog/rss.xml index c8c7ef7d9ca..55070bdc4aa 100644 --- a/blog/rss.xml +++ b/blog/rss.xml @@ -182,9 +182,9 @@ We can now embed links and other formatting in preferences, and extensions can u Wed, 19 Apr 2023 00:00:00 GMT In this blog post you will learn to use Podman Desktop to run the Kubernetes documentation example: Deploying PHP Guestbook application with Redis.

        On the agenda:

        1. Installing Podman Desktop.
        2. Installing and initializing your container engine: Podman.
        3. Installing and starting your local Kubernetes provider: Kind.
        4. Starting the Redis leader.
        5. Starting and scaling the Redis followers.
        6. Starting and exposing the Guestbook frontend.

        Installing Podman Desktop​

        You need Podman Desktop.

        1. Go to Podman Desktop installation documentation.
        2. Click on your platform name: Windows, macOS, or Linux.
        3. Follow the instructions. Stick to the default installation method.
        4. Start Podman Desktop.

        At this point, you have a graphical user interface to:

        • Install Podman and Kind.
        • Control and work with your container engines and Kubernetes clusters.
        • Run your application on your container engine and migrate it to Kubernetes.

        Installing and initializing your container engine: Podman​

        Podman Desktop can control various container engines, such as:

        • Docker
        • Lima
        • Podman

        Consider installing the Podman container engine for:

        • Added security
        • No daemon
        • Open source

        Containers are a Linux technology.

        • On Linux, you can install Podman natively. -See: Installing Podman on Linux.
        • On macOS and Windows, Podman requires to run in a Linux virtual machine: the Podman machine. -Use Podman Desktop to install Podman and initialize your Podman machine:

        Procedure​

        1. Open Podman Desktop Dashboard
        2. The Dashboard displays Podman Desktop was not able to find an installation of Podman.
        3. Click on Install.
        4. Podman Desktop checks the prerequisites to install Podman Engine. When necessary, follow the instructions to install prerequisites.
        5. Podman displays the dialog: Podman is not installed on this system, would you like to install Podman?. Click on Yes to install Podman.
        6. Click on Initialize and start.

        Verification​

        • The Dashboard displays Podman is running.

          Podman is running

        At this point, you can start working with containers.

        Installing and starting your local Kubernetes provider: Kind​

        You want to deploy your application to a local Kubernetes cluster.

        Podman Desktop can help you run Kind-powered local Kubernetes clusters on a container engine, such as Podman.

        Podman Desktop helps you installing the kind CLI:

        1. In the status bar, click on Kind, and follow the prompts.

        2. When the kind CLI is available, the status bar does not display Kind.

        3. On Windows, configure Podman in rootful mode

          $ podman system connection default podman-machine-default-root

        4. Go to Settings > Resources

        5. In the Podman icon Podman tile, click on the icon to restart the Podman container engine.

        6. In the Kind icon Kind tile, click on the Create new button.

          1. Name: enter kind-cluster.
          2. Provider Type: select podman.
          3. HTTP Port: select 9090.
          4. HTTPS Port: select 9443.
          5. Setup an ingress controller: Enabled
          6. Click the Create button. -Create a Kind cluster screen

        7. After successful creation, click on the Go back to resources button

        Verification​

        1. In Settings > Resources your Kind cluster is running/

          Kind cluster is running

        2. In the Podman Desktop tray, open the Kubernetes menu: you can set the context to your Kind cluster: kind-kind-cluster.

          Kind cluster Kubernetes context in the tray

          At this point, you can start working with containers, and your local Kubernetes cluster.

        Additional resources​

        Starting the Redis leader​

        The Guestbook application uses Redis to store its data.

        With Podman Desktop, you can prepare the Redis leader image and container on your local container engine, and deploy the results to a Kubernetes pod and service. +See: Installing Podman on Linux.

      6. On macOS and Windows, Podman requires to run in a Linux virtual machine: the Podman machine. +Use Podman Desktop to install Podman and initialize your Podman machine:

        7. Procedure​

        1. Open Podman Desktop Dashboard
        2. The Dashboard displays Podman Desktop was not able to find an installation of Podman.
        3. Click on Install.
        4. Podman Desktop checks the prerequisites to install Podman Engine. When necessary, follow the instructions to install prerequisites.
        5. Podman displays the dialog: Podman is not installed on this system, would you like to install Podman?. Click on Yes to install Podman.
        6. Click on Initialize and start.

        Verification​

        • The Dashboard displays Podman is running.

          Podman is running

        At this point, you can start working with containers.

        Installing and starting your local Kubernetes provider: Kind​

        You want to deploy your application to a local Kubernetes cluster.

        Podman Desktop can help you run Kind-powered local Kubernetes clusters on a container engine, such as Podman.

        Podman Desktop helps you installing the kind CLI:

        1. In the status bar, click on Kind, and follow the prompts.

        2. When the kind CLI is available, the status bar does not display Kind.

        3. On Windows, configure Podman in rootful mode

          $ podman system connection default podman-machine-default-root

        4. Go to Settings > Resources

        5. In the Podman icon Podman tile, click on the icon to restart the Podman container engine.

        6. In the Kind icon Kind tile, click on the Create new button.

          1. Name: enter kind-cluster.
          2. Provider Type: select podman.
          3. HTTP Port: select 9090.
          4. HTTPS Port: select 9443.
          5. Setup an ingress controller: Enabled
          6. Click the Create button. +Create a Kind cluster screen

        7. After successful creation, click on the Go back to resources button

        Verification​

        1. In Settings > Resources your Kind cluster is running/

          Kind cluster is running

        2. In the Podman Desktop tray, open the Kubernetes menu: you can set the context to your Kind cluster: kind-kind-cluster.

          Kind cluster Kubernetes context in the tray

          At this point, you can start working with containers, and your local Kubernetes cluster.

        Additional resources​

        Starting the Redis leader​

        The Guestbook application uses Redis to store its data.

        With Podman Desktop, you can prepare the Redis leader image and container on your local container engine, and deploy the results to a Kubernetes pod and service. This is functionally equal to the redis-leader deployment that the Kubernetes example propose.

        Procedure​

        1. Open Images > Pull an image.

          1. Image to Pull: enter docker.io/redis:6.0.5
          2. Click Pull image to pull the image to your container engine local image registry.
          3. Click Done to get back to the images list.

        2. Search images: enter redis:6.0.5 to find the image.

        3. Click to open the Create a container from image dialog.

          1. Container name: enter leader,
          2. Local port for 6379/tcp: 6379.
          3. Click Start Container to start the container in your container engine.

        4. Search containers: enter leader to find the running container.

        5. Click to stop the container, and leave the 6379 port available for the Redis follower container.

        6. Click > Deploy to Kubernetes to open the Deploy generated pod to Kubernetes screen.

          1. Pod Name: enter redis-leader.
          2. Use Kubernetes Services: select Replace hostPort exposure on containers by Services. It is the recommended way to expose ports, as a cluster policy might prevent to use hostPort.
          3. Expose service locally using Kubernetes Ingress: deselect Create a Kubernetes ingress to get access to the ports that this pod exposes, at the default ingress controller location. Example: on a default Kind cluster created with Podman Desktop: http://localhost:9090. Requirements: your cluster has an ingress controller`.
          4. Kubernetes namespaces: select default.
          5. Click Deploy. Deploy generated leader pod to Kubernetes screen
          6. Wait for the pod to reach the state: Phase: Running.
          7. Click Done.

        Verification​

        • The Pods screen lists the running redis-leader pod.

          leader pod is running

        Starting the Redis followers​

        Although the Redis leader is a single Pod, you can make it highly available and meet traffic demands by adding a few Redis followers, or replicas.

        With Podman Desktop, you can prepare the Redis follower image and container on your local container engine, and deploy the results to Kubernetes pods and services. This is functionally equal to the redis-follower deployment that the Kubernetes example propose.

        Procedure​

        1. Open Images > Pull an image.
          1. Image to Pull: enter gcr.io/google_samples/gb-redis-follower:v2
          2. Click Pull image to pull the image to your container engine local image registry.
          3. Click Done to get back to the images list.
        2. Search images: enter gb-redis-follower:v2 to find the image.
        3. Click to open the Create a container from image dialog.
          1. Container name: enter follower,
          2. Local port for 6379/tcp: 6379.
          3. Click Start Container to start the container in your container engine.
        4. Search containers: enter follower to find the running container.
        5. Click to stop the container: you do not need it to run in the container engine.
        6. Click > Deploy to Kubernetes to open the Deploy generated pod to Kubernetes screen.
          1. Pod Name: enter redis-follower.
          2. Use Kubernetes Services: select Replace hostPort exposure on containers by Services. It is the recommended way to expose ports, as a cluster policy might prevent to use hostPort.
          3. Expose service locally using Kubernetes Ingress: deselect Create a Kubernetes ingress to get access to the ports that this pod exposes, at the default ingress controller location. Example: on a default Kind cluster created with Podman Desktop: http://localhost:9090. Requirements: your cluster has an ingress controller`.
          4. Kubernetes namespaces: select default.
          5. Click Deploy. diff --git a/blog/running-a-local-kubernetes-cluster-with-podman-desktop.html b/blog/running-a-local-kubernetes-cluster-with-podman-desktop.html index a0924dea5a2..110d437f8bd 100644 --- a/blog/running-a-local-kubernetes-cluster-with-podman-desktop.html +++ b/blog/running-a-local-kubernetes-cluster-with-podman-desktop.html @@ -13,15 +13,15 @@ - +

            Setting up and running a Kubernetes cluster locally with Podman Desktop

            · 9 min read
            Fabrice Flore-Thebault

            In this blog post you will learn to use Podman Desktop to run the Kubernetes documentation example: Deploying PHP Guestbook application with Redis.

            On the agenda:

            1. Installing Podman Desktop.
            2. Installing and initializing your container engine: Podman.
            3. Installing and starting your local Kubernetes provider: Kind.
            4. Starting the Redis leader.
            5. Starting and scaling the Redis followers.
            6. Starting and exposing the Guestbook frontend.

            Installing Podman Desktop​

            You need Podman Desktop.

            1. Go to Podman Desktop installation documentation.
            2. Click on your platform name: Windows, macOS, or Linux.
            3. Follow the instructions. Stick to the default installation method.
            4. Start Podman Desktop.

            At this point, you have a graphical user interface to:

            • Install Podman and Kind.
            • Control and work with your container engines and Kubernetes clusters.
            • Run your application on your container engine and migrate it to Kubernetes.

            Installing and initializing your container engine: Podman​

            Podman Desktop can control various container engines, such as:

            • Docker
            • Lima
            • Podman

            Consider installing the Podman container engine for:

            • Added security
            • No daemon
            • Open source

            Containers are a Linux technology.

            • On Linux, you can install Podman natively. -See: Installing Podman on Linux.
            • On macOS and Windows, Podman requires to run in a Linux virtual machine: the Podman machine. -Use Podman Desktop to install Podman and initialize your Podman machine:

            Procedure​

            1. Open Podman Desktop Dashboard
            2. The Dashboard displays Podman Desktop was not able to find an installation of Podman.
            3. Click on Install.
            4. Podman Desktop checks the prerequisites to install Podman Engine. When necessary, follow the instructions to install prerequisites.
            5. Podman displays the dialog: Podman is not installed on this system, would you like to install Podman?. Click on Yes to install Podman.
            6. Click on Initialize and start.

            Verification​

            • The Dashboard displays Podman is running.

              Podman is running

            At this point, you can start working with containers.

            Installing and starting your local Kubernetes provider: Kind​

            You want to deploy your application to a local Kubernetes cluster.

            Podman Desktop can help you run Kind-powered local Kubernetes clusters on a container engine, such as Podman.

            Podman Desktop helps you installing the kind CLI:

            1. In the status bar, click on Kind, and follow the prompts.

            2. When the kind CLI is available, the status bar does not display Kind.

            3. On Windows, configure Podman in rootful mode

              $ podman system connection default podman-machine-default-root

            4. Go to Settings > Resources

            5. In the Podman icon Podman tile, click on the icon to restart the Podman container engine.

            6. In the Kind icon Kind tile, click on the Create new button.

              1. Name: enter kind-cluster.
              2. Provider Type: select podman.
              3. HTTP Port: select 9090.
              4. HTTPS Port: select 9443.
              5. Setup an ingress controller: Enabled
              6. Click the Create button. -Create a Kind cluster screen

            7. After successful creation, click on the Go back to resources button

            Verification​

            1. In Settings > Resources your Kind cluster is running/

              Kind cluster is running

            2. In the Podman Desktop tray, open the Kubernetes menu: you can set the context to your Kind cluster: kind-kind-cluster.

              Kind cluster Kubernetes context in the tray

              At this point, you can start working with containers, and your local Kubernetes cluster.

            Additional resources​

            Starting the Redis leader​

            The Guestbook application uses Redis to store its data.

            With Podman Desktop, you can prepare the Redis leader image and container on your local container engine, and deploy the results to a Kubernetes pod and service. +See: Installing Podman on Linux.

          6. On macOS and Windows, Podman requires to run in a Linux virtual machine: the Podman machine. +Use Podman Desktop to install Podman and initialize your Podman machine:

            7. Procedure​

            1. Open Podman Desktop Dashboard
            2. The Dashboard displays Podman Desktop was not able to find an installation of Podman.
            3. Click on Install.
            4. Podman Desktop checks the prerequisites to install Podman Engine. When necessary, follow the instructions to install prerequisites.
            5. Podman displays the dialog: Podman is not installed on this system, would you like to install Podman?. Click on Yes to install Podman.
            6. Click on Initialize and start.

            Verification​

            • The Dashboard displays Podman is running.

              Podman is running

            At this point, you can start working with containers.

            Installing and starting your local Kubernetes provider: Kind​

            You want to deploy your application to a local Kubernetes cluster.

            Podman Desktop can help you run Kind-powered local Kubernetes clusters on a container engine, such as Podman.

            Podman Desktop helps you installing the kind CLI:

            1. In the status bar, click on Kind, and follow the prompts.

            2. When the kind CLI is available, the status bar does not display Kind.

            3. On Windows, configure Podman in rootful mode

              $ podman system connection default podman-machine-default-root

            4. Go to Settings > Resources

            5. In the Podman icon Podman tile, click on the icon to restart the Podman container engine.

            6. In the Kind icon Kind tile, click on the Create new button.

              1. Name: enter kind-cluster.
              2. Provider Type: select podman.
              3. HTTP Port: select 9090.
              4. HTTPS Port: select 9443.
              5. Setup an ingress controller: Enabled
              6. Click the Create button. +Create a Kind cluster screen

            7. After successful creation, click on the Go back to resources button

            Verification​

            1. In Settings > Resources your Kind cluster is running/

              Kind cluster is running

            2. In the Podman Desktop tray, open the Kubernetes menu: you can set the context to your Kind cluster: kind-kind-cluster.

              Kind cluster Kubernetes context in the tray

              At this point, you can start working with containers, and your local Kubernetes cluster.

            Additional resources​

            Starting the Redis leader​

            The Guestbook application uses Redis to store its data.

            With Podman Desktop, you can prepare the Redis leader image and container on your local container engine, and deploy the results to a Kubernetes pod and service. This is functionally equal to the redis-leader deployment that the Kubernetes example propose.

            Procedure​

            1. Open Images > Pull an image.

              1. Image to Pull: enter docker.io/redis:6.0.5
              2. Click Pull image to pull the image to your container engine local image registry.
              3. Click Done to get back to the images list.

            2. Search images: enter redis:6.0.5 to find the image.

            3. Click to open the Create a container from image dialog.

              1. Container name: enter leader,
              2. Local port for 6379/tcp: 6379.
              3. Click Start Container to start the container in your container engine.

            4. Search containers: enter leader to find the running container.

            5. Click to stop the container, and leave the 6379 port available for the Redis follower container.

            6. Click > Deploy to Kubernetes to open the Deploy generated pod to Kubernetes screen.

              1. Pod Name: enter redis-leader.
              2. Use Kubernetes Services: select Replace hostPort exposure on containers by Services. It is the recommended way to expose ports, as a cluster policy might prevent to use hostPort.
              3. Expose service locally using Kubernetes Ingress: deselect Create a Kubernetes ingress to get access to the ports that this pod exposes, at the default ingress controller location. Example: on a default Kind cluster created with Podman Desktop: http://localhost:9090. Requirements: your cluster has an ingress controller`.
              4. Kubernetes namespaces: select default.
              5. Click Deploy. Deploy generated leader pod to Kubernetes screen
              6. Wait for the pod to reach the state: Phase: Running.
              7. Click Done.

            Verification​

            • The Pods screen lists the running redis-leader pod.

              leader pod is running

            Starting the Redis followers​

            Although the Redis leader is a single Pod, you can make it highly available and meet traffic demands by adding a few Redis followers, or replicas.

            With Podman Desktop, you can prepare the Redis follower image and container on your local container engine, and deploy the results to Kubernetes pods and services. This is functionally equal to the redis-follower deployment that the Kubernetes example propose.

            Procedure​

            1. Open Images > Pull an image.
              1. Image to Pull: enter gcr.io/google_samples/gb-redis-follower:v2
              2. Click Pull image to pull the image to your container engine local image registry.
              3. Click Done to get back to the images list.
            2. Search images: enter gb-redis-follower:v2 to find the image.
            3. Click to open the Create a container from image dialog.
              1. Container name: enter follower,
              2. Local port for 6379/tcp: 6379.
              3. Click Start Container to start the container in your container engine.
            4. Search containers: enter follower to find the running container.
            5. Click to stop the container: you do not need it to run in the container engine.
            6. Click > Deploy to Kubernetes to open the Deploy generated pod to Kubernetes screen.
              1. Pod Name: enter redis-follower.
              2. Use Kubernetes Services: select Replace hostPort exposure on containers by Services. It is the recommended way to expose ports, as a cluster policy might prevent to use hostPort.
              3. Expose service locally using Kubernetes Ingress: deselect Create a Kubernetes ingress to get access to the ports that this pod exposes, at the default ingress controller location. Example: on a default Kind cluster created with Podman Desktop: http://localhost:9090. Requirements: your cluster has an ingress controller`.
              4. Kubernetes namespaces: select default.
              5. Click Deploy. @@ -31,7 +31,7 @@ It is configured to communicate with either the Redis follower or leader Service The frontend exposes a JSON interface, and serves a jQuery-Ajax-based UX.

                With Podman Desktop, you can prepare the Guestbook frontend image and container on your local container engine, and deploy the results to Kubernetes pods and services. This is functionally equal to the frontend deployment that the Kubernetes example propose.

                Procedure​

                1. Open Images > Pull an image.
                  1. Image to Pull: enter gcr.io/google_samples/gb-frontend:v5
                  2. Click Pull image to pull the image to your container engine local image registry.
                  3. Wait for the pull to complete.
                  4. Click Done to get back to the images list.
                2. Search images: enter gb-frontend:v5 to find the image.
                3. Click to open the Create a container from image dialog.
                  1. Container name: enter frontend,
                  2. Local port for 80/tcp: 9000.
                  3. Click Start Container to start the container in your container engine.
                4. Search containers: enter frontend to find the running container.
                5. Click to stop the container: you do not need it to run in the container engine.
                6. Click > Deploy to Kubernetes to open the Deploy generated pod to Kubernetes screen.
                  1. Pod Name: enter frontend.
                  2. Use Kubernetes Services: select Replace hostPort exposure on containers by Services. It is the recommended way to expose ports, as a cluster policy might prevent to use hostPort.
                  3. Expose service locally using Kubernetes Ingress: select Create a Kubernetes ingress to get access to the ports that this pod exposes, at the default ingress controller location. Example: on a default Kind cluster created with Podman Desktop: http://localhost:9090. Requirements: your cluster has an ingress controller`.
                  4. Kubernetes namespaces: select default.
                  5. Click Deploy. Deploy generated frontend pod to Kubernetes screen
                  6. Wait for the pod to reach the state: Phase: Running.
                  7. Click Done.

                Verification​

                1. The Pods screen lists the running frontend pod.

                  `frontend` pod is running

                2. Go to http://localhost:9090: the Guestbook application is running.

                - + \ No newline at end of file diff --git a/blog/tags.html b/blog/tags.html index b10d418303e..6b535350f71 100644 --- a/blog/tags.html +++ b/blog/tags.html @@ -13,13 +13,13 @@ - +

                Tags

                - + \ No newline at end of file diff --git a/blog/tags/codespaces.html b/blog/tags/codespaces.html index 8fa4a5592d9..d53cee683dc 100644 --- a/blog/tags/codespaces.html +++ b/blog/tags/codespaces.html @@ -13,13 +13,13 @@ - +

                One post tagged with "codespaces"

                View All Tags

                · 7 min read
                Florent Benoit

                GitHub announced last week that Codespaces is available for everyone and it includes free minutes.

                Let see how we can use a Development Container having all the tools to build and run Podman Desktop. The Development Container works locally using Visual Studio Code but in this blog post we will see how it works directly with a simple click from GitHub.

                The challenges are to run a desktop tool (Podman Desktop) and running a container engine (Podman) inside this Development Container without using too many memory !

                - + \ No newline at end of file diff --git a/blog/tags/compose.html b/blog/tags/compose.html index f38d293c50c..010c4275c62 100644 --- a/blog/tags/compose.html +++ b/blog/tags/compose.html @@ -13,13 +13,13 @@ - +

                One post tagged with "compose"

                View All Tags

                · 4 min read
                Tim deBoer

                This release note covers Podman Desktop 0.13 release changes.

                • Podman Version: Podman 4.4.4 now included in Windows and Mac installers.
                • Compose: Support for installing Docker Compose.
                • Extensions: Improved extension support for Podman Desktop with additional capabilities.
                • UX and UI Improvements: Welcome page, task manager, resources, and update alerts.

                Podman Desktop 0.13 is now available. Click here to download it!

                Podman-desktop-0-13-hero

                - + \ No newline at end of file diff --git a/blog/tags/devcontainer.html b/blog/tags/devcontainer.html index 594490e4058..1f97cfd677c 100644 --- a/blog/tags/devcontainer.html +++ b/blog/tags/devcontainer.html @@ -13,13 +13,13 @@ - +

                One post tagged with "devcontainer"

                View All Tags

                · 7 min read
                Florent Benoit

                GitHub announced last week that Codespaces is available for everyone and it includes free minutes.

                Let see how we can use a Development Container having all the tools to build and run Podman Desktop. The Development Container works locally using Visual Studio Code but in this blog post we will see how it works directly with a simple click from GitHub.

                The challenges are to run a desktop tool (Podman Desktop) and running a container engine (Podman) inside this Development Container without using too many memory !

                - + \ No newline at end of file diff --git a/blog/tags/docker.html b/blog/tags/docker.html index 4662dc45273..181f82225f0 100644 --- a/blog/tags/docker.html +++ b/blog/tags/docker.html @@ -13,13 +13,13 @@ - +

                One post tagged with "docker"

                View All Tags

                · 5 min read
                Florent Benoit

                The 5 things to know being a Docker user by using Podman Desktop:

                • Use a single UI: Podman Desktop works with several container engines, including Docker.
                • The compatibility mode: How to ensure tools are working with Podman instead of Docker.
                • Compose support: How to work with Compose files and Podman.
                • Kubernetes support: How to use Kubernetes with Podman.
                • Security: Use rootless mode or containers without root privileges.

                5-things-to-know-for-a-docker-user-hero

                - + \ No newline at end of file diff --git a/blog/tags/kind.html b/blog/tags/kind.html index a80800d7ffd..8f852dc44c6 100644 --- a/blog/tags/kind.html +++ b/blog/tags/kind.html @@ -13,7 +13,7 @@ - + @@ -27,7 +27,7 @@ of Podman Desktop: not just local container engines, but Kubernetes too. More im providing tools that allow you to manage both environments and seamlessly move between them.

                Some of these features were available in development mode over the last few releases, but since they are now in the release build, we will do a full roundup and talk about all the Kind features.

                • Kind Installation: Install Kind from the status bar
                • Manage Kind Clusters: Create and manage Kind clusters from Settings > Resources
                • Using Kind: Deploying YAML and sharing images to a cluster
                • Kind Ingress: Install a Contour ingress controller
                • UX and UI Improvements: Updated preferences and telemetry prompt

                Podman Desktop 0.14 is now available. Click here to download it!

                Podman-desktop-0-14-hero

                - + \ No newline at end of file diff --git a/blog/tags/kubernetes.html b/blog/tags/kubernetes.html index 4d5eb9c93a4..30ae72b3d12 100644 --- a/blog/tags/kubernetes.html +++ b/blog/tags/kubernetes.html @@ -13,7 +13,7 @@ - + @@ -29,7 +29,7 @@ of Podman Desktop: not just local container engines, but Kubernetes too. More im providing tools that allow you to manage both environments and seamlessly move between them.

                Some of these features were available in development mode over the last few releases, but since they are now in the release build, we will do a full roundup and talk about all the Kind features.

                • Kind Installation: Install Kind from the status bar
                • Manage Kind Clusters: Create and manage Kind clusters from Settings > Resources
                • Using Kind: Deploying YAML and sharing images to a cluster
                • Kind Ingress: Install a Contour ingress controller
                • UX and UI Improvements: Updated preferences and telemetry prompt

                Podman Desktop 0.14 is now available. Click here to download it!

                Podman-desktop-0-14-hero

                · 4 min read
                Tim deBoer

                This release note covers Podman Desktop 0.13 release changes.

                • Podman Version: Podman 4.4.4 now included in Windows and Mac installers.
                • Compose: Support for installing Docker Compose.
                • Extensions: Improved extension support for Podman Desktop with additional capabilities.
                • UX and UI Improvements: Welcome page, task manager, resources, and update alerts.

                Podman Desktop 0.13 is now available. Click here to download it!

                Podman-desktop-0-13-hero

                · 5 min read
                Stevan Le Meur

                This release note covers Podman Desktop 0.12 release changes.

                • Podman Version: Podman 4.4.1 now included in Windows and Mac installers.
                • Containers Configuration: Configure port mappings for an image without exported ports.
                • Windows Home Support: Podman Desktop now supports Windows Home Edition.
                • Start minimized: Option to start Podman Desktop minimized to system tray.
                • UX and UI Improvements: Consistent actions, placeholder for logs, unified icons and others.

                Podman Desktop 0.12 is now available. Click here to download it!

                podman-desktop-0-12-hero

                · 10 min read
                Stevan Le Meur

                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!

                · 5 min read
                Dev Kumar

                This release note covers Podman Desktop 0.10 release changes.

                • Containers Configuration: Container creation wizzard allowing to define environment variables, networking and more configuration options.
                • Kubernetes Improvements: Play Kubernetes YAML, custom Kubeconfig path support, reload of kube context.
                • Registries Configuration: Revamped registries configuration UI.
                • Podman Version: Podman 4.3.1 now included in Windows and Mac installers.
                • UX/UI Improvements: Improved lists, better contrast, and more.

                Podman Desktop 0.10 is now available. Click here to download it!

                - + \ No newline at end of file diff --git a/blog/tags/migrating.html b/blog/tags/migrating.html index 415f1474873..24ec6806ce4 100644 --- a/blog/tags/migrating.html +++ b/blog/tags/migrating.html @@ -13,13 +13,13 @@ - +

                One post tagged with "migrating"

                View All Tags

                · 5 min read
                Florent Benoit

                The 5 things to know being a Docker user by using Podman Desktop:

                • Use a single UI: Podman Desktop works with several container engines, including Docker.
                • The compatibility mode: How to ensure tools are working with Podman instead of Docker.
                • Compose support: How to work with Compose files and Podman.
                • Kubernetes support: How to use Kubernetes with Podman.
                • Security: Use rootless mode or containers without root privileges.

                5-things-to-know-for-a-docker-user-hero

                - + \ No newline at end of file diff --git a/blog/tags/openshift.html b/blog/tags/openshift.html index f32171b4eea..d8acbb0f375 100644 --- a/blog/tags/openshift.html +++ b/blog/tags/openshift.html @@ -13,7 +13,7 @@ - + @@ -23,7 +23,7 @@ log for every component individually.

                Click here to download it!

                Podman-desktop-1-1-hero

                · 5 min read
                Tim deBoer

                Podman Desktop 1.0 Release! 🎉

                We still have many things planned, but with a little polish and a few more bug fixes we felt we've reached a level of maturity and it is now time to declare our 1.0 release.

                Thank you to everyone who has been with us on this journey so far! Please keep the feedback coming!

                • Highlighting Featured Extensions: Easily find and install new extensions.
                • Featured Extensions: Two new extensions supporting OpenShift.
                • Podman Machine as Root: Ability to run a Podman machine as root.
                • UX and UI Improvements: Opening external websites, editing numbers, and tooltips.

                Podman Desktop 1.0 is now available. Click here to download it!

                Podman-desktop-1-0-hero

                - + \ No newline at end of file diff --git a/blog/tags/podman-desktop.html b/blog/tags/podman-desktop.html index c3357cfc2ce..c80a5d4dca3 100644 --- a/blog/tags/podman-desktop.html +++ b/blog/tags/podman-desktop.html @@ -13,7 +13,7 @@ - + @@ -29,7 +29,7 @@ of Podman Desktop: not just local container engines, but Kubernetes too. More im providing tools that allow you to manage both environments and seamlessly move between them.

                Some of these features were available in development mode over the last few releases, but since they are now in the release build, we will do a full roundup and talk about all the Kind features.

                • Kind Installation: Install Kind from the status bar
                • Manage Kind Clusters: Create and manage Kind clusters from Settings > Resources
                • Using Kind: Deploying YAML and sharing images to a cluster
                • Kind Ingress: Install a Contour ingress controller
                • UX and UI Improvements: Updated preferences and telemetry prompt

                Podman Desktop 0.14 is now available. Click here to download it!

                Podman-desktop-0-14-hero

                · 4 min read
                Tim deBoer

                This release note covers Podman Desktop 0.13 release changes.

                • Podman Version: Podman 4.4.4 now included in Windows and Mac installers.
                • Compose: Support for installing Docker Compose.
                • Extensions: Improved extension support for Podman Desktop with additional capabilities.
                • UX and UI Improvements: Welcome page, task manager, resources, and update alerts.

                Podman Desktop 0.13 is now available. Click here to download it!

                Podman-desktop-0-13-hero

                · 5 min read
                Florent Benoit

                The 5 things to know being a Docker user by using Podman Desktop:

                • Use a single UI: Podman Desktop works with several container engines, including Docker.
                • The compatibility mode: How to ensure tools are working with Podman instead of Docker.
                • Compose support: How to work with Compose files and Podman.
                • Kubernetes support: How to use Kubernetes with Podman.
                • Security: Use rootless mode or containers without root privileges.

                5-things-to-know-for-a-docker-user-hero

                · 5 min read
                Stevan Le Meur

                This release note covers Podman Desktop 0.12 release changes.

                • Podman Version: Podman 4.4.1 now included in Windows and Mac installers.
                • Containers Configuration: Configure port mappings for an image without exported ports.
                • Windows Home Support: Podman Desktop now supports Windows Home Edition.
                • Start minimized: Option to start Podman Desktop minimized to system tray.
                • UX and UI Improvements: Consistent actions, placeholder for logs, unified icons and others.

                Podman Desktop 0.12 is now available. Click here to download it!

                podman-desktop-0-12-hero

                · 10 min read
                Stevan Le Meur

                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!

                · 5 min read
                Dev Kumar

                This release note covers Podman Desktop 0.10 release changes.

                • Containers Configuration: Container creation wizzard allowing to define environment variables, networking and more configuration options.
                • Kubernetes Improvements: Play Kubernetes YAML, custom Kubeconfig path support, reload of kube context.
                • Registries Configuration: Revamped registries configuration UI.
                • Podman Version: Podman 4.3.1 now included in Windows and Mac installers.
                • UX/UI Improvements: Improved lists, better contrast, and more.

                Podman Desktop 0.10 is now available. Click here to download it!

                · 7 min read
                Florent Benoit

                GitHub announced last week that Codespaces is available for everyone and it includes free minutes.

                Let see how we can use a Development Container having all the tools to build and run Podman Desktop. The Development Container works locally using Visual Studio Code but in this blog post we will see how it works directly with a simple click from GitHub.

                The challenges are to run a desktop tool (Podman Desktop) and running a container engine (Podman) inside this Development Container without using too many memory !

                - + \ No newline at end of file diff --git a/blog/tags/release.html b/blog/tags/release.html index 2360b557fe1..afdb1a6f6db 100644 --- a/blog/tags/release.html +++ b/blog/tags/release.html @@ -13,7 +13,7 @@ - + @@ -29,7 +29,7 @@ of Podman Desktop: not just local container engines, but Kubernetes too. More im providing tools that allow you to manage both environments and seamlessly move between them.

                Some of these features were available in development mode over the last few releases, but since they are now in the release build, we will do a full roundup and talk about all the Kind features.

                • Kind Installation: Install Kind from the status bar
                • Manage Kind Clusters: Create and manage Kind clusters from Settings > Resources
                • Using Kind: Deploying YAML and sharing images to a cluster
                • Kind Ingress: Install a Contour ingress controller
                • UX and UI Improvements: Updated preferences and telemetry prompt

                Podman Desktop 0.14 is now available. Click here to download it!

                Podman-desktop-0-14-hero

                · 4 min read
                Tim deBoer

                This release note covers Podman Desktop 0.13 release changes.

                • Podman Version: Podman 4.4.4 now included in Windows and Mac installers.
                • Compose: Support for installing Docker Compose.
                • Extensions: Improved extension support for Podman Desktop with additional capabilities.
                • UX and UI Improvements: Welcome page, task manager, resources, and update alerts.

                Podman Desktop 0.13 is now available. Click here to download it!

                Podman-desktop-0-13-hero

                · 5 min read
                Stevan Le Meur

                This release note covers Podman Desktop 0.12 release changes.

                • Podman Version: Podman 4.4.1 now included in Windows and Mac installers.
                • Containers Configuration: Configure port mappings for an image without exported ports.
                • Windows Home Support: Podman Desktop now supports Windows Home Edition.
                • Start minimized: Option to start Podman Desktop minimized to system tray.
                • UX and UI Improvements: Consistent actions, placeholder for logs, unified icons and others.

                Podman Desktop 0.12 is now available. Click here to download it!

                podman-desktop-0-12-hero

                · 10 min read
                Stevan Le Meur

                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!

                · 5 min read
                Dev Kumar

                This release note covers Podman Desktop 0.10 release changes.

                • Containers Configuration: Container creation wizzard allowing to define environment variables, networking and more configuration options.
                • Kubernetes Improvements: Play Kubernetes YAML, custom Kubeconfig path support, reload of kube context.
                • Registries Configuration: Revamped registries configuration UI.
                • Podman Version: Podman 4.3.1 now included in Windows and Mac installers.
                • UX/UI Improvements: Improved lists, better contrast, and more.

                Podman Desktop 0.10 is now available. Click here to download it!

                - + \ No newline at end of file diff --git a/blog/tags/story.html b/blog/tags/story.html index dbfd1a7e35a..c060ffcd74b 100644 --- a/blog/tags/story.html +++ b/blog/tags/story.html @@ -13,13 +13,13 @@ - +

                One post tagged with "story"

                View All Tags

                · 9 min read
                Fabrice Flore-Thebault

                In this blog post you will learn to use Podman Desktop to run the Kubernetes documentation example: Deploying PHP Guestbook application with Redis.

                On the agenda:

                1. Installing Podman Desktop.
                2. Installing and initializing your container engine: Podman.
                3. Installing and starting your local Kubernetes provider: Kind.
                4. Starting the Redis leader.
                5. Starting and scaling the Redis followers.
                6. Starting and exposing the Guestbook frontend.
                - + \ No newline at end of file diff --git a/core-values.html b/core-values.html index 98a234e04ba..ad8fc46833c 100644 --- a/core-values.html +++ b/core-values.html @@ -13,13 +13,13 @@ - +

                Podman Desktop: Core Values

                Podman Desktop is designed and built with the following core values in mind.

                Fast and Light

                Daemon-less and using the fastest technologies to make Podman Desktop fast to use.

                Reactive and light on resources utilized from your environment.

                Open

                While focusing on Podman as a container engine packaged by default, Podman Desktop also enables other container engines.

                This gives the end-user a single tool to manage all their containers independently from the engine used.

                Simple

                Managing a container engine locally can be hard.

                Running Kubernetes in a local environment requires knowledge.

                Podman Desktop takes care of this complexity and enables developers to focus on their code.

                Extensible Workflow

                Podman Desktop provides extensions points to enable the community to build more features.

                This allows more in-deep integrations with other tools and technologies to extend workflows and capabilities of the tool.

                Thus giving the developer a single tool to manage all their containers independently from the engine used.

                - + \ No newline at end of file diff --git a/docs/Installation.html b/docs/Installation.html index 038f3516bd5..7d0e2b28fba 100644 --- a/docs/Installation.html +++ b/docs/Installation.html @@ -13,13 +13,13 @@ - +

                Installing Podman Desktop

                You can install Podman Desktop on:

                Podman Desktop requires you to install at least one container engine.

                Podman Desktop does not install any container engine automatically.

                Podman Desktop can use different virtual machines, such as:

                • Lima
                • Podman Machine

                Podman Desktop can control various container engines, such as:

                • Docker
                • Podman

                Consider installing the Podman container engine for:

                • Added security
                • No daemon
                • Open source
                • Rootless
                - + \ No newline at end of file diff --git a/docs/Installation/creating-a-lima-instance-with-podman-desktop.html b/docs/Installation/creating-a-lima-instance-with-podman-desktop.html index 1965f30529f..2db6780f332 100644 --- a/docs/Installation/creating-a-lima-instance-with-podman-desktop.html +++ b/docs/Installation/creating-a-lima-instance-with-podman-desktop.html @@ -13,13 +13,13 @@ - +

                Creating a Lima instance with Podman Desktop

                To use the Lima provider you need a Lima instance running a Linux virtual machine.

                In the future, Podman Desktop might be able to create Lima instances.

                Consider creating a custom Lima instance to:

                • Control the assigned resources: CPUs, memory, and disk size.
                • Use the rootful connection by default, for example to run Kind.

                Prerequisites​

                • The limactl executable is installed.
                brew install lima

                See https://lima-vm.io

                Procedure​

                Currently you need to use the console, to create a new Lima instance.

                After the instance is started, you need to restart the Lima extension.

                Examples:

                To create an instance "podman" from a template "podman":

                $ limactl start --name=podman template://podman

                To create an instance "docker" from a template "docker":

                $ limactl start --name=docker template://docker

                To select the number of CPUs and the memory or disk size:

                $ limactl start --set='.cpus = 2 | .memory = "2GiB" | .disk = "50GiB"' ...

                To create a rootful instance, use the rootful template:

                $ limactl start --name=podman template://podman-rootful

                Verification​

                To verify the connection to a running "podman" instance:

                $ podman.lima version

                To verify the connection to a running "docker" instance:

                $ docker.lima version

                Kubernetes​

                To create a single-node Kubernetes cluster running k3s:

                $ limactl start template://k3s

                To create a single-node Kubernetes cluster running k8s:

                $ limactl start template://k8s

                When the installation is done, the location of the KUBECONFIG file is printed:

                You can also use the kubectl.lima wrapper script, to connect to the cluster:

                $ kubectl.lima version
                - + \ No newline at end of file diff --git a/docs/Installation/creating-a-podman-machine-with-podman-desktop.html b/docs/Installation/creating-a-podman-machine-with-podman-desktop.html index 7df92620725..53961423766 100644 --- a/docs/Installation/creating-a-podman-machine-with-podman-desktop.html +++ b/docs/Installation/creating-a-podman-machine-with-podman-desktop.html @@ -13,7 +13,7 @@ - + @@ -26,7 +26,7 @@ Select the disk size.
              6. Image path (Optional): Select a bootable image containing a virtual machine with Podman.
              7. Machine with root privileges: Enable to use the rootful connection by default. Required to use Kind on Windows.
              8. Click Create

              Create a Podman machine

            - + \ No newline at end of file diff --git a/docs/Installation/linux-install.html b/docs/Installation/linux-install.html index 4d7dc58ecfa..2a0d823a155 100644 --- a/docs/Installation/linux-install.html +++ b/docs/Installation/linux-install.html @@ -13,13 +13,13 @@ - +

            Installing Podman Desktop on Linux

            Consider installing the Podman Desktop from Flathub to have:

            • One command installation
            • Package updates

            Alternatively, you can install Podman Desktop from:

            Prerequisites​

            Procedure​

            1. Verify the Flathub repository is enabled, and add it if required:

              $ flatpak remote-add --if-not-exists --user flathub https://flathub.org/repo/flathub.flatpakrepo

            2. Install Podman Desktop from Flathub:

              $ flatpak install --user flathub io.podman_desktop.PodmanDesktop

            Verification​

            • Open Podman Desktop from a terminal:

              $ flatpak run io.podman_desktop.PodmanDesktop

            Update​

            • Update Podman Desktop from Flathub:

              $ flatpak update --user io.podman_desktop.PodmanDesktop

            Additional resources​

            Next steps​

            - + \ No newline at end of file diff --git a/docs/Installation/linux-install/installing-podman-desktop-from-a-compressed-tar-file.html b/docs/Installation/linux-install/installing-podman-desktop-from-a-compressed-tar-file.html index e0e67759968..b8eb22705a6 100644 --- a/docs/Installation/linux-install/installing-podman-desktop-from-a-compressed-tar-file.html +++ b/docs/Installation/linux-install/installing-podman-desktop-from-a-compressed-tar-file.html @@ -13,14 +13,14 @@ - +

            Installing Podman Desktop from a compressed tar file

            Consider installing from an archive rather than from Flathub, or from a Flatpak bundle when:

            • You cannot use Flatpak.
            • You install in a restricted environment.

            Prerequisites​

            Procedure​

            1. Download the podman-desktop-<version>.tar.gz archive from the Git repository release assets.
            2. Extract the content.
            3. Go to the extracted directory.
            4. Double-click on the podman-desktop executable file.

            Next steps​

            - + \ No newline at end of file diff --git a/docs/Installation/linux-install/installing-podman-desktop-from-a-flatpak-bundle.html b/docs/Installation/linux-install/installing-podman-desktop-from-a-flatpak-bundle.html index aacaf1e2718..6101bcdcd1a 100644 --- a/docs/Installation/linux-install/installing-podman-desktop-from-a-flatpak-bundle.html +++ b/docs/Installation/linux-install/installing-podman-desktop-from-a-flatpak-bundle.html @@ -13,13 +13,13 @@ - +

            Installing Podman Desktop from a Flatpak bundle

            Consider installing a Flatpak bundle rather than from Flathub when:

            • You cannot use Flathub.
            • You want to install an unreleased version.

            Prerequisites​

            Procedure​

            1. Download the Flatpak bundle to a $HOME/Downloads/podman-desktop-<version>.flatpak file from:

            2. Install Podman Desktop from the downloaded Flatpak bundle:

              $ flatpak install --user $HOME/Downloads/podman-desktop-<version>.flatpak

            Verification​

            • Open Podman Desktop from a terminal:

              $ flatpak run io.podman_desktop.PodmanDesktop

            Additional resources​

            Next steps​

            - + \ No newline at end of file diff --git a/docs/Installation/macos-install.html b/docs/Installation/macos-install.html index 8abaf705183..9a6615c438e 100644 --- a/docs/Installation/macos-install.html +++ b/docs/Installation/macos-install.html @@ -13,14 +13,14 @@ - +

            MacOS

            This page contains information regarding installation of Podman Desktop on MacOS.

            You can install Podman Desktop on Mac:

            1. Using the .dmg file
            2. Using Brew
            Prerequisite

            Podman Desktop requires Podman Engine. If you don't have Podman Engine installed, Podman Desktop will prompt you to do so at a later stage.

            Installing Podman Desktop on MacOS using .dmg file​

            1. Download the .dmg file from the Downloads section of this website.

              While we recommend getting the "universal" binary file which will work irrespective of the chip architecture your Mac possesses, you also have the option to get the applicable .dmg file depending on your Mac Hardware Architecture (that is Intel or Apple M1).

            2. Locate the downloaded file, and double-click on it. (Usually, you will find the downloaded file in the Downloads folder)

              img0

            3. Drag Podman Desktop icon to the Applications folder.

              img1

            4. Start Podman Desktop from the 'Launchpad' or Mac's Applications directory.

              img2

            5. Install Podman from Podman Desktop, if not yet installed.

              When you open Podman Desktop for the first time, click on the "View detection checks" button to scan if all the prerequisites to use Podman Desktop are met. If it says ❌ podman cli was not found in the PATH, then you need to install the Podman CLI/Engine which can be done within the application.

              img3

            6. Click on the "Install" button next to the "View detection checks" button, and follow the instructions on screen.

            7. You will be redirected to the Podman Installer. Follow the instructions on screen and enter your system password when asked.

              img4

            8. After the installation is complete, close the installation program. Podman Engine has been installed and you are now ready to use Podman Desktop.

            Installing Podman Desktop on MacOS using brew​

            Prerequisite

            Installation steps​

            1. Open a terminal on your Mac.

            2. Run the command mentioned below.

              brew install podman-desktop

              Brew will also install the Podman Engine along with the Podman Desktop application, in case you don't have it installed yet.

              After the command is executed, you can find the Podman Desktop Application within the Applications directory of the MacOS.

            Getting Started​

            Learn more on how to get started with Podman Desktop by clicking here.

            - + \ No newline at end of file diff --git a/docs/Installation/windows-install.html b/docs/Installation/windows-install.html index b99e07752a8..fe058442585 100644 --- a/docs/Installation/windows-install.html +++ b/docs/Installation/windows-install.html @@ -13,13 +13,13 @@ - +

            Installing Podman Desktop using the Windows installer

            Consider using this installation method if you don't require another method such as:

            Procedure​

            1. Download the Windows installer.

            2. Open the downloaded file to start the Podman Desktop installer.

            Next steps​

            - + \ No newline at end of file diff --git a/docs/Installation/windows-install/installing-podman-desktop-and-podman-in-a-restricted-environment.html b/docs/Installation/windows-install/installing-podman-desktop-and-podman-in-a-restricted-environment.html index b8574c6ca29..814edf0fe73 100644 --- a/docs/Installation/windows-install/installing-podman-desktop-and-podman-in-a-restricted-environment.html +++ b/docs/Installation/windows-install/installing-podman-desktop-and-podman-in-a-restricted-environment.html @@ -13,13 +13,13 @@ - +

            Installing Podman Desktop and Podman in a restricted environment

            Consider using the Windows installer for restricted environments to install the Podman Desktop and Podman in a restricted environment.

            The Windows installer for restricted environments:

            • Has all artifacts required for installation
            • Does not require Internet access to download resources during installation

            Prerequisites​

            Procedure​

            1. Download the Windows installer for restricted environments, and copy the downloaded file to the Windows host in a restricted environment.
            2. Run the Windows installer for restricted environments to install Podman Desktop.
            3. Open Podman Desktop and click on the Install button to install Podman.
            4. Click on Initialize Podman.

            Next steps​

            - + \ No newline at end of file diff --git a/docs/Installation/windows-install/installing-podman-desktop-silently-with-the-windows-installer.html b/docs/Installation/windows-install/installing-podman-desktop-silently-with-the-windows-installer.html index 57499f7fac7..467fee02349 100644 --- a/docs/Installation/windows-install/installing-podman-desktop-silently-with-the-windows-installer.html +++ b/docs/Installation/windows-install/installing-podman-desktop-silently-with-the-windows-installer.html @@ -13,13 +13,13 @@ - +

            Installing Podman Desktop silently with the Windows installer

            Consider using this method to install the Podman Desktop Windows installer without user interaction.

            Procedure​

            1. Download the Windows installer.

            2. Run the PowerShell command:

              Start-Process -FilePath '.\podman-desktop-0.10.0-setup.exe' -ArgumentList "\S" -Wait

            Next steps​

            - + \ No newline at end of file diff --git a/docs/Installation/windows-install/installing-podman-desktop-with-chocolatey.html b/docs/Installation/windows-install/installing-podman-desktop-with-chocolatey.html index 013a9203059..0b28abcbae2 100644 --- a/docs/Installation/windows-install/installing-podman-desktop-with-chocolatey.html +++ b/docs/Installation/windows-install/installing-podman-desktop-with-chocolatey.html @@ -13,13 +13,13 @@ - +
            - + \ No newline at end of file diff --git a/docs/Installation/windows-install/installing-podman-desktop-with-scoop.html b/docs/Installation/windows-install/installing-podman-desktop-with-scoop.html index b29d4825c8a..7ca65aa9a9d 100644 --- a/docs/Installation/windows-install/installing-podman-desktop-with-scoop.html +++ b/docs/Installation/windows-install/installing-podman-desktop-with-scoop.html @@ -13,13 +13,13 @@ - +

            Installing Podman Desktop with Scoop package manager for Windows

            Prerequisites​

            Procedure​

            • Run the commands from the command line or from PowerShell:

              scoop bucket add extras
              scoop install podman-desktop

            Additional resources​

            Next steps​

            - + \ No newline at end of file diff --git a/docs/Installation/windows-install/installing-podman-desktop-with-winget.html b/docs/Installation/windows-install/installing-podman-desktop-with-winget.html index f2305b12df2..b0256f82919 100644 --- a/docs/Installation/windows-install/installing-podman-desktop-with-winget.html +++ b/docs/Installation/windows-install/installing-podman-desktop-with-winget.html @@ -13,13 +13,13 @@ - +
            - + \ No newline at end of file diff --git a/docs/Installation/windows-install/installing-podman-with-openshift-local.html b/docs/Installation/windows-install/installing-podman-with-openshift-local.html index fee22b3150a..e4bba84e016 100644 --- a/docs/Installation/windows-install/installing-podman-with-openshift-local.html +++ b/docs/Installation/windows-install/installing-podman-with-openshift-local.html @@ -13,13 +13,13 @@ - +

            Installing the Podman Preset with OpenShift Local

            On Windows, running the Podman container engine requires running a Linux distribution on a virtual machine.

            Consider installing the Podman Preset in OpenShift Local rather than installing Podman with Podman Desktop when you require one of following:

            • No WSL 2
            • Full control on the HyperV virtual machine
            • User without administrator privileges
            • VPN
            • Windows 10

            Prerequisites​

            • The user is a member of the Hyper-V Administrators group. The user can add a virtual machine, start or stop this virtual machine, and access the resources related to this virtual machine.
            • Windows 10 version 1709 or later, Enterprise or Professional edition, or Windows 11, Enterprise or Professional edition

            Procedure​

            1. Install OpenShift Local

            2. Select the Podman container runtime preset:

              $ crc config set preset podman

            3. Set up your host machine for Red Hat OpenShift Local:

              $ crc setup

            4. Start the Red Hat OpenShift instance:

              $ crc start

            Additional resources​

            Next steps​

            - + \ No newline at end of file diff --git a/docs/Installation/windows-install/installing-podman-with-podman-desktop.html b/docs/Installation/windows-install/installing-podman-with-podman-desktop.html index 8237b4160a8..03ccab67a8e 100644 --- a/docs/Installation/windows-install/installing-podman-with-podman-desktop.html +++ b/docs/Installation/windows-install/installing-podman-with-podman-desktop.html @@ -13,14 +13,14 @@ - +

            Installing Podman on Windows with Podman Desktop

            On Windows, running the Podman container engine requires running a Linux distribution on a virtual machine.

            Podman Desktop can assist you to install the Podman container engine in a Fedora distribution of Linux, on the Windows Subsystem for Linux version 2 (WSL 2). Main benefits are:

            • Ease of use
            • Windows native virtualization performance

            Consider rather installing Podman with OpenShift Local if:

            • You prefer working with a RHEL distribution of Linux
            • Your environment doesn't allow you to meet the prerequisites

            Prerequisites​

            • 6 GB RAM
            • No VPN
            • WSL prerequisites
              • User with administrator privileges
              • Windows 64bit
              • Windows 10 Build 18362 or greater, or Windows 11
              • On a virtual machine: Nested Virtualization enabled
            • Podman is not installed
            • No WSL 2 Linux virtual machine is running

            Procedure​

            1. Enable the WSL feature without installing the default Ubuntu distribution of Linux. See Enabling WSL 2 and WSL basic commands:

              wsl --install --no-distribution

            2. The Home screen displays Podman Desktop was not able to find an installation of Podman. Click on Install.

              img1

            3. Podman Desktop checks the prerequites to install Podman Engine. When necessary, follow the instructions to install prerequisites.

            4. Podman displays the dialog: Podman is not installed on this system, would you like to install Podman?. Click on Yes to install Podman.

            5. Click on Initialize Podman.

            Additional resources​

            Next steps​

            - + \ No newline at end of file diff --git a/docs/compose/compose-spec.html b/docs/compose/compose-spec.html index db5fdd53548..8a877734219 100644 --- a/docs/compose/compose-spec.html +++ b/docs/compose/compose-spec.html @@ -13,14 +13,14 @@ - +

            Compose spec with Podman Desktop

            Introduction​

            Podman Desktop supports the Compose spec. With Podman Desktop, users can easily create and manage multi-container applications by using Compose files.

            How does it work​

            Each time you run a Compose file by using Podman Compose or Docker Compose a label is assigned to each container. Podman Desktop detects that label and shows it appropriately within the management console.

            img2

            What do you need to enable​

            Containers deployed by the Compose specification are automatically detected by Podman Desktop.

            What if you already have Docker Compose or Podman Compose installed​

            Any containers already deployed by Docker Compose / Podman Compose will be automatically shown within Podman Desktop. You do not need to do anything!

            - + \ No newline at end of file diff --git a/docs/compose/podman-compose.html b/docs/compose/podman-compose.html index e74aed67b91..1b49dc7e509 100644 --- a/docs/compose/podman-compose.html +++ b/docs/compose/podman-compose.html @@ -13,13 +13,13 @@ - +

            Podman Compose with Podman Desktop

            Introduction​

            Podman Compose is a community-driven tool that allows developers to use the Compose spec to run many containers at the same time. Podman Compose requires a Compose YAML file with definitions about the containers that need to communicate.

            If you have not used a Compose file or the Compose spec, visit this guide for more information.

            Requirements​

            Getting started​

            Spin up your compose.yaml with the podman-compose binary and Podman Desktop will automatically detect it!

            Use the Flask Redis project from the awesome-compose repository as an example project.

            1. Git clone the project and cd into the directory:

              $ git clone https://github.com/docker/awesome-compose
              $ cd awesome-compose/redis-flask

            2. Run the podman-compose command:

              $ podman-compose -f compose.yaml up -d

              img1

            3. Manage Compose with Podman Desktop

              To confirm if the containers are running, open Podman Desktop and click on the ‘Containers’ option on the left side of the application. You will have the containers bundled together under a Pod named flask-redis (compose) in this case. Here, the compose within the bracket indicates it has been generated from a Compose YAML file.

              img2

            4. You can further configure or work with these containers within the Podman Desktop application now that they are visible. Here, clicking on the ‘Open Browser’ button allows us to confirm if the application is running expectedly.

              img3

            5. You can do much more such as checking logs, opening the terminal or inspecting the files for more details.

              img4

            - + \ No newline at end of file diff --git a/docs/extensions.html b/docs/extensions.html index 8f1ba893bfc..abc438fd04a 100644 --- a/docs/extensions.html +++ b/docs/extensions.html @@ -13,13 +13,13 @@ - +

            Podman Desktop extensions

            Podman Desktop extensions contribute to:

            • Container engine support, such as Podman, Docker.
            • Virtual machine support, such as Lima.
            • Podman Desktop extension points such as tray icon menu, status bar items, icons, menus, and commands.
            • Integration with third parties tools, such as Kind or Compose.

            Next steps​

            - + \ No newline at end of file diff --git a/docs/extensions/install.html b/docs/extensions/install.html index bbb7f7e773d..26a24bd401c 100644 --- a/docs/extensions/install.html +++ b/docs/extensions/install.html @@ -13,13 +13,13 @@ - +

            Installing a Podman Desktop extension

            Consider installing Podman Desktop extensions to enrich the default capabilities of Podman Desktop.

            Prerequisites​

            Procedure​

            1. Go to the Settings > Extensions.

            2. In the Name of the Image field, write the extension OCI image name.

            3. Click the Install extension from the OCI image button.

            Verification​

            • If Podman Desktop satisfies the minimum required version of the extension, the extension activates.

            • Depending on the extension, items can appear in the status bar, tray menu, or other contributions.

            - + \ No newline at end of file diff --git a/docs/extensions/publish.html b/docs/extensions/publish.html index f9888f9a532..7b4ac6aaf2f 100644 --- a/docs/extensions/publish.html +++ b/docs/extensions/publish.html @@ -13,7 +13,7 @@ - + @@ -21,7 +21,7 @@

            Packaging and publishing a Podman Desktop extension

            To enable users to install your extension, consider publishing your extension to an Open Container Initiative (OCI) image registry.

            Prerequisites​

            • The extension builds successfully. See Writing a Podman Desktop extension.

            • All runtime dependencies are inside the final binary.

            • An OCI image registry to publish to, such as quay.io/fbenoit/my-first-extension.

            • (Optional) The OCI image registry is public to enable anybody to fetch the image.

            Procedure​

            1. Create and edit a Containerfile file.

            2. Use a scratch image. The extension requires no runtime:

              FROM scratch

            3. Apply mandatory Podman Desktop metadata on the OCI image:

              LABEL org.opencontainers.image.title="My first extension" \
                    org.opencontainers.image.description="Example of extension" \
                    org.opencontainers.image.vendor="podman-desktop" \
                    io.podman-desktop.api.version=">= 0.12.0"

              io.podman-desktop.api.version=">= 0.12.0" sets the minimal Podman Desktop version that the extension requires to run.

            4. Copy the extension assembly, including the metadata, icon, and production binary, to the /extension folder inside the image:

              COPY package.json /extension/
              COPY icon.png /extension/
              COPY dist /extension/dist

            5. Build an image:

              $ podman build -t quay.io/fbenoit/my-first-extension .

            6. Push the image and manifest to the OCI image registry:

              $ podman push quay.io/fbenoit/my-first-extension

            Next steps​

            - + \ No newline at end of file diff --git a/docs/extensions/write.html b/docs/extensions/write.html index 83b52b2e2c4..8580d26de0c 100644 --- a/docs/extensions/write.html +++ b/docs/extensions/write.html @@ -13,13 +13,13 @@ - +

            Writing a Podman Desktop extension

            To write a Podman Desktop extension, start a Node.js or TypeScript project calling the Podman Desktop API, and ensure all runtime dependencies are inside the final binary.

            Initializing a Podman Desktop extension​

            Write the Podman Desktop extension Node.js package metadata.

            Prerequisites​

            • JavaScript or TypeScript

            Procedure​

            1. Create and edit a package.json file.

              {}

            2. Add TypeScript and Podman Desktop API to the development dependencies:

               "devDependencies": {
                 "@podman-desktop/api": "latest",
                 "typescript": "latest"
               },

            3. Add the required metadata:

                "name": "my-extension",
                "displayName": "My Hello World extension",
                "description": "How to write my first extension",
                "version": "0.0.1",
                "icon": "icon.png",
                "publisher": "benoitf",

            4. Add the Podman Desktop version that might run this extension:

                "engines": {
                  "podman-desktop": "latest"
                },

            5. Add the main entry point:

               "main": "./dist/extension.js"

            6. Add a Hello World command contribution

                "contributes": {
                  "commands": [
                   {
                     "command": "my.first.command",
                     "title": "My First Extension: Hello World"
                   }
                 ]
                }

            7. Add an icon.png file to the project.

            Verification​

            • Full package.json example:

              {
                "devDependencies": {
                  "@podman-desktop/api": "latest",
                  "typescript": "latest"
                },
                "name": "my-extension",
                "displayName": "My Hello World extension",
                "description": "How to write my first extension",
                "version": "0.0.1",
                "icon": "icon.png",
                "publisher": "benoitf",
                "engines": {
                  "podman-desktop": "latest"
                },
                "main": "./dist/extension.js",
                "contributes": {
                  "commands": [
                    {
                      "command": "my.first.command",
                      "title": "My First Extension: Hello World"
                    }
                  ]
                }
              }

            Writing a Podman Desktop extension entry point​

            Write the extension features.

            Prerequisites​

            • JavaScript or TypeScript

            Procedure​

            1. Create and edit a dist/extension.js file.

            2. Import the Podman Desktop API

              import * as podmanDesktopAPI from '@podman-desktop/api';

            3. Expose the activate function to call on activation.

              The signature of the function can be:

              • Synchronous

                export function activate(): void;

              • Asynchronous

                export async function activate(): Promise<void>;

            4. (Optional) Add an extension context to the activate function enabling the extension to register disposable resources:

              export async function activate(extensionContext: podmanDesktopAPI.ExtensionContext): Promise<void> {}

            5. Register the command and the callback

              import * as podmanDesktopAPI from '@podman-desktop/api';
              export async function activate(extensionContext: podmanDesktopAPI.ExtensionContext): Promise<void> {
                // register the command referenced in package.json file
                const myFirstCommand = podmanDesktopAPI.commands.registerCommand('my.first.command', async () => {
                  // display a choice to the user for selecting some values
                  const result = await podmanDesktopAPI.window.showQuickPick(['un', 'deux', 'trois'], {
                    canPickMany: true, // user can select more than one choice
                  });

                  // display an information message with the user choice
                  await podmanDesktopAPI.window.showInformationMessage(`The choice was: ${result}`);
                });

                // create an item in the status bar to run our command
                // it will stick on the left of the status bar
                const item = podmanDesktopAPI.window.createStatusBarItem(podmanDesktopAPI.StatusBarAlignLeft, 100);
                item.text = 'My first command';
                item.command = 'my.first.command';
                item.show();

                // register disposable resources to it's removed when we deactivte the extension
                extensionContext.subscriptions.push(myFirstCommand);
                extensionContext.subscriptions.push(item);
              }

            6. (Optional) Expose the deactivate function to call on deactivation.

              The signature of the function can be:

              • Synchronous

                export function deactivate(): void;

              • Asynchronous

                export async function deactivate(): Promise<void>;

            Verification​

            • The extension compiles and produces the output in the dist folder.

            • All runtime dependencies are inside the final binary.

            Additional resources​

            • Consider a packer such as Rollup or Webpack to shrink the size of the artifact.

            Next steps​

            - + \ No newline at end of file diff --git a/docs/extensions/write/when-clause-context.html b/docs/extensions/write/when-clause-context.html index 5a38e4395c7..fb61492cead 100644 --- a/docs/extensions/write/when-clause-context.html +++ b/docs/extensions/write/when-clause-context.html @@ -13,13 +13,13 @@ - +

            When clause contexts

            Podman Desktop uses when clauses to enable or disable extensions command and UI customizations, such as views.

            For example, the Kind extension adds a custom icon to a container that has a label equals to io.x-k8s.kind.cluster by using the following instruction.

            "views": {
               "icons/containersList": [
                 {
                   "when": "io.x-k8s.kind.cluster in containerLabelKeys",
                   "icon": "${kind-icon}"
                 }
               ]
             }

            A when clause can consist of a context key (such as isLinux) or complex expressions to define a specific state.

            Available context keys​

            Podman Desktop has a set of context keys that are evaluated to Boolean true/false.

            Context keyTrue when
            Operating system contexts
            isLinuxTrue when the OS is Linux.
            isWindowsTrue when the OS is Windows.
            isMacTrue when the OS is macOS.

            Podman Desktop also provides context keys that return values that can be used to create meaningful expressions

            Context keyValue in it
            containerLabelKeysA list of all labels belonging to the current container. Example: "value in containerLabelKeys"

            Add a custom when clause context​

            If you are creating your own extension and none of the existing keys suit your needs, you can set your own context key by calling the function setValue(key: string, value: any, scope?: 'onboarding') provided by the context namespace in the Podman Desktop API.

            The scope, if specified, triggers a custom behavior to avoid any type of collisions between different extensions for that specific scope. Podman Desktop is responsible for handling its state and cleans it accordingly when necessary.

            If omitted, the key/value is set globally. For this reason it is recommended to use the extension id as part of the key to avoid unexpected collisions with other extensions.

            The first example below sets the key "podmanIsInstalled" to true globally while the second example sets the key "toolInstalled" to oc.exe using the onboarding scope.

               extensionsAPI.context.setValue('podmanIsInstalled', true);

               extensionsAPI.context.setValue('toolInstalled', 'oc.exe', 'onboarding');

            After setting the toolInstalled to oc.exe, you could use this information in the when clause to enable something

            {
              "when": "onboardingContext:toolInstalled == oc.exe"
            }

            Conditional operators​

            To create when clauses a bit more complex Podman Desktop offers a set of operators that can be combined with each other.

            Logical operators​

            Logical operators allow combining simple context keys or when-clause expressions that include other operators

            OperatorSymbolExample
            Not!!podmanIsInstalled or !(podmanIsInstalled && isWindows)
            And&&podmanIsInstalled && isWindows
            Or\|\|isLinux \|\| isWindows

            Equality operators​

            Equality operators allow checking for equality of a context key's value againt a specified value.

            Note: the right side is a value and not considered as a context key, so no value is searched in the context. If it contains whitespaces, it must be wrapped in single-quotes (for example 'my tool.exe')

            OperatorSymbolExample
            Equality==onboardingContext:toolInstalled == oc.exe
            Inequality!=onboardingContext:toolInstalled != oc.exe

            Comparison operators​

            Comparison operator allow comparing a context key's value against a number.

            Note: the left and right side of the operator must be separated by whitespace - bar < 2, but not bar<2

            OperatorSymbolExample
            Greater than>, >=onboardingContext:toolInstalled > 2
            Less than<, <=onboardingContext:toolInstalled <= 3

            In and not in​

            The in/not in operators allow checking if a value exists/not exists within the other. The right should be a context key, which value is retrieved in the context. The left can be a value or a context key.

            OperatorSymbolExample
            Ininlabel in containerLabelKeys
            Notnot inlabel not in containerLabelKeys

            Match operator​

            The match operator allow treating the right side item as a regular expression literal to match against the left side.

            OperatorSymbolExample
            Matches=~label =~ /podman$/
            - + \ No newline at end of file diff --git a/docs/getting-started/authenticating-to-a-preconfigured-registry.html b/docs/getting-started/authenticating-to-a-preconfigured-registry.html index 5a04e77b5b2..3b3718dbfbd 100644 --- a/docs/getting-started/authenticating-to-a-preconfigured-registry.html +++ b/docs/getting-started/authenticating-to-a-preconfigured-registry.html @@ -13,13 +13,13 @@ - +

            Authenticating to a pre-configured registry

            With Podman Desktop, you can authenticate to a set of pre-configured registries:

            • Red Hat Quay
            • Docker Hub
            • GitHub
            • Google Container registry

            Prerequisites​

            • You have credentials on a pre-configured image registry.

            Procedure​

            1. Go to Settings > Registries.

            2. On your registry line, click Configure.

              1. User name: Enter your user name.
              2. Password: Enter your password or OAuth secret.

            Verification​

            1. Go to Images.
            2. You can pull a private image from the registry.
            3. You can push an image to the registry:
              1. Build an image the fully qualified name required for your registry, such as quay.io/my-repository/my-image, ghcr.io/my-repository/my-image, or docker.io/my-repository/my-image.
              2. On your image line, click .
              3. The contextual menu has a Push Image entry.
            - + \ No newline at end of file diff --git a/docs/getting-started/building-an-image.html b/docs/getting-started/building-an-image.html index c971baef27f..953ec08bb45 100644 --- a/docs/getting-started/building-an-image.html +++ b/docs/getting-started/building-an-image.html @@ -13,13 +13,13 @@ - +

            Building an image on your container engine

            With Podman Desktop, you can build an image from a Containerfile on your container engine.

            Prerequisites​

            • Your Containerfile: Containerfile or Dockerfile.

            Procedure​

            1. Go to Images.
            2. Click Build an image.
            3. On the Build Image from Containerfile screen
              1. Containerfile path: select the Containerfile or Dockerfile to build.
              2. Image Name: enter your image name, such as my-image. If you want to push the image to a registry, use the fully qualified image name that your registry requires, such as quay.io/my-repository/my-image, ghcr.io/my-repository/my-image, or docker.io/my-repository/my-image.
              3. Click Build.
              4. Click Done.

            Verification​

            1. Go to Images.
            2. : Enter your image name, such as quay.io/my-repository/my-image, ghcr.io/my-repository/my-image, or docker.io/my-repository/my-image.
            3. Click the line with your image name.
            4. Go to History.
              1. Click the content area to activate it.
              2. Enter Ctrl + F on Windows and Linux, or ⌘ + F on macOS to start searching in the content.
            5. Go to Inspect.
              1. Click the content area to activate it.
              2. Enter Ctrl + F on Windows and Linux, or ⌘ + F on macOS to start searching in the content.
            6. Click ..
              1. You see the Create a container screen.
            - + \ No newline at end of file diff --git a/docs/getting-started/creating-a-pod.html b/docs/getting-started/creating-a-pod.html index 4baadab9b75..77a69533070 100644 --- a/docs/getting-started/creating-a-pod.html +++ b/docs/getting-started/creating-a-pod.html @@ -13,13 +13,13 @@ - +

            Creating a pod from selected containers

            With Podman Desktop, you can create a pod from your selected containers, and run the pod on the Podman container engine.

            Consider running containers in a pod to:

            1. Expose your frontend application to the public network.
            2. Protect your database container in a private network.

            Prerequisites​

            • You are using the Podman container engine.
            • Your containers, such as database and frontend, running or stopped, are available on the Containers page.
            • The frontend container is configured to access the service exposed by the database container on localhost, such as localhost:6379.

            Procedure​

            1. Go to Containers.
            2. Click the checkbox in the container line for your containers, such as database and frontend.
            3. Click .
            4. In the Copy containers to a pod screen:
              1. Name of the pod: enter your pod name, such as my-pod.
              2. All selected ports will be exposed:
                1. Select frontend.
                2. Clear database.
            5. Click Create Pod.

            Verification​

            1. Go to Pods.
            2. Click your pod, such as my-pod.
            3. Go to Logs: see the combined logs from the two containers.
            4. Go to Summary: see the containers.
            5. Click frontend-podified.
            6. Click .
            7. Your browser opens the service exposed by your frontend-podified container.
            8. Go to Containers: see the running containers.
            - + \ No newline at end of file diff --git a/docs/getting-started/getting-started.html b/docs/getting-started/getting-started.html index 9e7313a4b91..eddf2889ced 100644 --- a/docs/getting-started/getting-started.html +++ b/docs/getting-started/getting-started.html @@ -13,13 +13,13 @@ - +

            Getting Started with Podman Desktop

            Introduction​

            Podman Desktop leverages Podman Engine to provide a lightweight and daemon-less container management tool. It enables you to easily work with containers from your local environment without running container management commands.

            Podman Desktop brings all the capabilities of Podman with the added advantage of a GUI which is becoming increasingly powerful and user-friendly. It is super easy to adapt to. With this tutorial, you will be ready to roll and work with your containerized applications in no time.

            In this tutorial, I am working with Podman Desktop v0.0.5.

            Requirements​

            To work with Podman Desktop, you firstly require the latest version of Podman Desktop. Depending on your operating system, you can download it from this page.

            Next, you need the latest version of Podman Engine installed on your computer. When started, Podman Desktop looks for the Podman Engine in the system and will prompt you to install the same if it is not present. You can read more about how to set up the Podman Desktop and Podman Engine in the Installation guide here.

            Once everything is set up, you are ready to go!

            Get Started​

            When you open the Podman Desktop application, you will be greeted with the home screen. It will show you a toggle button that says ‘Initialize Podman’. And as mentioned, it initializes the Podman Engine and creates a Podman Machine for you. Click on it to create a Podman Machine. Within no time, your Podman Machine will be created. This is equivalent to running the command podman machine init. You can read more about it here.

            Next, you need to start the Podman Machine by toggling the button that says ‘Run Podman’. This is equivalent to running podman machine start. You can read more about it here.

            Once it says “Podman is running”, you are ready to build images and run containers!

            Our first step will be to build an image for our application followed by running the image to create the container.

            1. Build Image​

            For this section of the tutorial, I have created my Containerfile using the Red Hat Universal Base Image. You can also write your own Containerfiles and build images from it using the Red Hat Universal Base Image (UBI). Read more about it in this blog. Once you have your Containerfile ready, follow the steps below to build your own image.

            1. To load the Containerfile to Podman Desktop and build the Image, we browse to the “Images” section and click on the “Build Image” button. This opens a tab within which you can select the path where your Containerfile is present.

              img1.1

            2. Click on the placeholder “Select Containerfile to build”, browse to the folder where the Containerfile is present and select the file.

              img1.2

            3. Go ahead and type in any name for your image below but Podman Desktop will have something generated by default in case you want to skip it.

              img1.3

            4. Click on ‘Build’ and that’s it. You will see each instruction from your Containerfile being executed to build the image.

              img1.4

            5. Once completed, Click on “Done” above to continue. You will see that your image has been added to the Images section of Podman Desktop.

              img1.5

            2. Create and Run the Container​

            Following are the steps to create and start a container from the image.

            1. Once the image is built, you can see its name (in our case, ‘my-custom-image’) and other details in the Images section.

              img2.1

            2. Simply hover over the name of the image and you will see a list of buttons to the right. In case you are confused about the action of each button, just take the cursor over each button and wait for it to tell the action it does.

              img2.2

            3. Upon clicking the ‘Run Image’ button, a window will appear and it will ask you to Create the container by giving it a name and mapping the desired port number.

              img2.3

            4. Once you click on “Start Container”, you will see some changes in the Containers section. Upon hovering your cursor over the newly created container, you will see a set of buttons allowing you to work with it.

              img2.4

            5. To check if it is running our application as desired, open the URL in the browser (in this case, localhost:8080 because that’s where we mapped our port). This can be done by clicking on the ‘Open Browser’ button.

              img2.5

            6. As we can see, it returns {“Hello”:”World”} as intended.

              img2.6

            Conclusion​

            So that’s it! It is that simple to get started with Podman Desktop for building and running your first container image!

            - + \ No newline at end of file diff --git a/docs/getting-started/insecure-registry.html b/docs/getting-started/insecure-registry.html index 84728c7445c..860edd074d2 100644 --- a/docs/getting-started/insecure-registry.html +++ b/docs/getting-started/insecure-registry.html @@ -13,13 +13,13 @@ - +

            Adding an Insecure Registry to Podman Desktop

            In this guide, you will learn how to add an insecure registry to Podman Desktop. An insecure registry allows you to pull and push container images either over an unencrypted HTTP connection, or a HTTPS connection with a self-signed unverified certificate. Please note that using an insecure registry can expose your data to security risks, so it's recommended to use secure connections with a verifiable certificate whenever possible.

            Prerequisites​

            • Podman installed and running (VM if on macOS or Windows).

            Procedure​

            1. Add your insecure registry within Settings > Registries.

            2. Click "Yes" to the insecure registry warning.

            Podman Desktop Registry Warning

            1. SSH into the Podman Machine to edit registries.conf.
            $ podman machine ssh [optional-machine-name]
            1. Open registries.conf.
            $ sudo vi /etc/containers/registries.conf
            1. Add the insecure registry: Add a new [[registry]] section for the URL of the insecure registry you want to use. For example, if your insecure registry is located at http://registry.example.com, add the following lines:
            [[registry]]
            location = registry.example.com
            insecure = true

            If you have multiple registries, you can add one [[registry]] block per registry.

            1. Save and exit the file.

            2. Restart Podman by the CLI or through Podman Desktop.

            $ podman machine stop
            $ podman machine start
            1. Pull or push container images: You can now use Podman Desktop to pull or push container images from/to the insecure registry you added.
            - + \ No newline at end of file diff --git a/docs/getting-started/pulling-an-image.html b/docs/getting-started/pulling-an-image.html index f10586fd232..32f6316aba6 100644 --- a/docs/getting-started/pulling-an-image.html +++ b/docs/getting-started/pulling-an-image.html @@ -13,13 +13,13 @@ - +

            Pulling an image to your container engine

            With Podman Desktop, you can pull an image from a registry, to your container engine.

            Prerequisites​

            • The image is available in a registry.
            • If the registry or the image are not publicly available, you configured access to the registry on Podman Desktop in Settings > Registries.

            Procedure​

            1. Go to Images.
            2. Click Pull an image.
            3. On the Image to Pull screen:
              1. Image to pull: enter the image name, such as quay.io/podman/hello. Prefer the fully qualified image name that specifies the registry, to the short name that might lead to registry resolution mistakes.
              2. Click Pull image.
            4. Click Done.

            Verification​

            1. Go to Images.
            2. Click the image name you pulled, such as quay.io/podman/hello. Podman Desktop always displays the fully qualified image name.
            3. Go to Summary.
            4. Go to History.
              1. Click the output area.
              2. Enter Ctrl + F on Windows and Linux, or ⌘ + F on macOS to start searching in the content.
            5. Go to Inspect.
              1. Click the output area.
              2. Enter Ctrl + F on Windows and Linux, or ⌘ + F on macOS to start searching in the content.
            - + \ No newline at end of file diff --git a/docs/getting-started/pushing-an-image-to-a-registry.html b/docs/getting-started/pushing-an-image-to-a-registry.html index 736d83ff506..72642391698 100644 --- a/docs/getting-started/pushing-an-image-to-a-registry.html +++ b/docs/getting-started/pushing-an-image-to-a-registry.html @@ -13,14 +13,14 @@ - +

            Pushing an image to a registry

            With Podman Desktop, you can push an image to registries.

            Prerequisites​

            • You have configured your registry Settings > Registries.
            • You have built an image, which name is the fully qualified name required for your registry, such as quay.io/my-repository/my-image, ghcr.io/my-repository/my-image, or docker.io/my-repository/my-image. Ensure that the image name includes the registry where to publish the image. To publish on quay.io/repository the image my-image, the FQN image name should be quay.io/repository/my-image.

            Procedure​

            1. Go to Images.
            2. On your image line, click > Push Image.
            3. Select the Image tag for your registry.
            4. Click Push Image.
            5. Click Done.

            Verification​

            1. Go to your container registry.
            2. Find your image.
            - + \ No newline at end of file diff --git a/docs/getting-started/starting-a-container.html b/docs/getting-started/starting-a-container.html index 7e9a1a472ee..9e9b9c5fc2f 100644 --- a/docs/getting-started/starting-a-container.html +++ b/docs/getting-started/starting-a-container.html @@ -13,14 +13,14 @@ - +

            Starting a container on your container engine

            With Podman Desktop, you can start a container from an image on your container engine. You can interact with the running container by using the terminal in Podman Desktop, or by opening your browser to the exposed ports.

            Prerequisites​

            • The Images list has your image, such as quay.io/podman/hello.

            Procedure​

            1. Go to Images.
            2. On the line with your image name, such as quay.io/podman/hello, click .
            3. On the Create a container screen, review the configuration.
            4. Click Start Container.

            Verification​

            1. Go to Containers.
            2. : Enter your image name, such as quay.io/podman/hello, to find your running container.
            3. Click your running container name.
            4. To view logs:
              1. Go to Logs.
              2. Browse the content.
            5. To inspect the container:
              1. Go to Inspect.
              2. Click the content area to activate it.
              3. Enter Ctrl + F on Windows and Linux, or ⌘ + F on macOS to start searching in the content.
            6. To generate Kubernetes YAML, when your container engine is Podman:
              1. Go to Kube.
              2. Click the content area to activate it.
              3. Enter Ctrl + F on Windows and Linux, or ⌘ + F on macOS to start searching in the content.
              4. Copy the content to a YAML file.
              5. Later, you can reuse this file to start a container in Podman from Kubernetes YAML, or to start a pod in Kubernetes.
            7. To interact with the container terminal:
              1. Go to Terminal.
              2. Click the content area to activate the terminal.
              3. Enter your commands.
            8. To interact with the exposed ports:
              1. Click .
              2. Your browser opens a page to the first exposed port on localhost.
            9. To deploy to your current Kubernetes context, when you container engine is Podman:
              1. Click .
              2. Review the Deploy generated pod to Kubernetes screen.
              3. Click .
            10. To stop the container:
            11. Click .
            12. To delete the container:
            13. Click .
            - + \ No newline at end of file diff --git a/docs/getting-started/switching-podman-machine-default-connection.html b/docs/getting-started/switching-podman-machine-default-connection.html index 129763382e8..4de897cb076 100644 --- a/docs/getting-started/switching-podman-machine-default-connection.html +++ b/docs/getting-started/switching-podman-machine-default-connection.html @@ -13,13 +13,13 @@ - +

            Setting Podman machine default connection

            Each Podman machine exposes two connections:

            • rootless
            • rootful

            Podman has one default connection.

            Podman Desktop, and other tools, such as Kind, connect to the default connection.

            After an event that might have changed the default Podman machine connection, such as creating another Podman machine, consider verifying and setting the default connection.

            Procedure​

            1. List Podman machine connections, in a terminal:

              $ podman system connection ls

            2. Set the Podman machine default connection to your desired connection, such as podman-machine-default-root, in a terminal:

              $ podman system connection default podman-machine-default-root

            3. List Podman machine connections, to verify which is the default, in a terminal:

              $ podman system connection ls

            4. Restart the Podman machine that has the default connection:

              $ podman mahine stop
              $ podman machine start

            5. Refresh Podman Desktop connection to Podman: click the icon to open the Troubleshooting page, and click the Reconnect providers button.

            Verification​

            • Podman Desktop lists images, containers, and pods that are accessible via the desired Podman machine connection.
            - + \ No newline at end of file diff --git a/docs/intro.html b/docs/intro.html index e418f4e1733..d1737ac55d1 100644 --- a/docs/intro.html +++ b/docs/intro.html @@ -13,13 +13,13 @@ - +

            Introduction

            Let's discover Podman Desktop in less than 5 minutes.

            Getting Started​

            Get started by Downloading the product for your operating system.

            What you'll need​

            • Podman 4.x
              • Check there is a Podman machine running

            Check Podman CLI is working​

            Run the development server:

            $ podman run quay.io/podman/hello
            !... Hello Podman World ...!

                     .--"--.
                   / -     - \
                  / (O)   (O) \
               ~~~| -=(,Y,)=- |
                .---. /`  \   |~~
             ~/  o  o \~~~~.----. ~~
              | =(X)= |~  / (O (O) \
               ~~~~~~~  ~| =(Y_)=-  |
              ~~~~    ~~~|   U      |~~

            Project:   https://github.com/containers/podman
            Website:   https://podman.io
            Documents: https://docs.podman.io
            Twitter:   @Podman_io
            - + \ No newline at end of file diff --git a/docs/kubernetes.html b/docs/kubernetes.html index c29e2e695d3..6ad18e8335a 100644 --- a/docs/kubernetes.html +++ b/docs/kubernetes.html @@ -13,13 +13,13 @@ - +
            - + \ No newline at end of file diff --git a/docs/kubernetes/configuring-access-to-a-kubernetes-cluster.html b/docs/kubernetes/configuring-access-to-a-kubernetes-cluster.html index 3ea4e370eaa..5a4fbfd3da6 100644 --- a/docs/kubernetes/configuring-access-to-a-kubernetes-cluster.html +++ b/docs/kubernetes/configuring-access-to-a-kubernetes-cluster.html @@ -13,13 +13,13 @@ - +

            Configuring access to a Kubernetes cluster

            Podman Desktop configures the access to Kubernetes clusters automatically when:

            You can also use the Kubernetes CLI to configure access to your Kubernetes cluster:

            Prerequisites​

            • You have credentials for your Kubernetes cluster.

            Procedure​

            1. (Optionally) Go to Settings > Preferences > Path to the kubeconfig file to adapt your kubeconfig file location, when different from the default $HOME/.kube/config.

            2. Register your <my_kubernetes> Kubernetes cluster:

              $ kubectl config set-cluster <my_kubernetes> --server=<my_kubernetes_url>

            Verification​

            Additional resopurces​

            - + \ No newline at end of file diff --git a/docs/kubernetes/deploying-a-container-to-kubernetes.html b/docs/kubernetes/deploying-a-container-to-kubernetes.html index 79710b70e0d..3544f0f09d7 100644 --- a/docs/kubernetes/deploying-a-container-to-kubernetes.html +++ b/docs/kubernetes/deploying-a-container-to-kubernetes.html @@ -13,13 +13,13 @@ - +

            Deploying a container to Kubernetes

            With Podman Desktop, you can deploy a container to your Kubernetes cluster.

            Prerequisites​

            • Your are using the Podman container engine.
            • Your container, running or stopped, is available on the Containers page: <your_container>.
            • You registered the Kubernetes cluster in your kubeconfig file: <your_kubernetes_cluster>. For example, Creating a kind cluster.
            • The Kubernetes namespace to deploy to already exists.

            Procedure​

            1. Click Podman Desktop tray > Kubernetes > Context > <your_kubernetes_cluster> to set your Kubernetes context.
            2. Open Podman Desktop dashboard > Containers > <your_container> to see the Container Details page.
            3. Click to generate a Kubernetes pod.
            4. On the Deploy generated pod to Kubernetes screen, choose your options:
              1. Pod Name: edit the proposed name.
              2. Use Kubernetes Services: enable or disable Replace hostPort exposure on containers by Services. It is the recommended way to expose ports, as a cluster policy might prevent to use hostPort.
              3. Kubernetes namespace: select in the list the namespace to deploy the pod to.
            5. Click the Deploy button.

            Verification​

            • On the Deploy generated pod to Kubernetes screen, the created pod status is Phase: Running

              Deploying a container

            • Go to Containers: your pod is in the list.

            - + \ No newline at end of file diff --git a/docs/kubernetes/deploying-a-pod-to-kubernetes.html b/docs/kubernetes/deploying-a-pod-to-kubernetes.html index f2210c16b56..5abeb16bd4a 100644 --- a/docs/kubernetes/deploying-a-pod-to-kubernetes.html +++ b/docs/kubernetes/deploying-a-pod-to-kubernetes.html @@ -13,13 +13,13 @@ - +

            Deploying a pod to Kubernetes

            With Podman Desktop, you can deploy a pod to your Kubernetes cluster.

            Prerequisites​

            • Your are using the Podman container engine.
            • Your pod, running or stopped, is available on the Pods page: <your_pod>.
            • You registered the Kubernetes cluster in your kubeconfig file: <your_kubernetes_cluster>. For example, Creating a kind cluster.
            • The Kubernetes namespace to deploy to already exists.

            Procedure​

            1. Click Podman Desktop tray > Kubernetes > Context > <your_kubernetes_cluster> to set your Kubernetes context.
            2. Open Podman Desktop dashboard > Pods > <your_pod> to see the Pod Details page.
            3. Click to generate a Kubernetes pod.
            4. On the Deploy generated pod to Kubernetes screen, choose your options:
              1. Pod Name: edit the proposed name.
              2. Use Kubernetes Services: enable or disable Replace hostPort exposure on containers by Services. It is the recommended way to expose ports, as a cluster policy might prevent to use hostPort.
              3. Kubernetes namespace: select in the list the namespace to deploy the pod to.
            5. Click the Deploy button.

            Verification​

            • On the Deploy generated pod to Kubernetes screen, the created pod status is Phase: Running

              Deplying a pod

            • Go to Pods: your pod is in the list.

            - + \ No newline at end of file diff --git a/docs/kubernetes/kind.html b/docs/kubernetes/kind.html index b053b349d0c..8639dd4cce4 100644 --- a/docs/kubernetes/kind.html +++ b/docs/kubernetes/kind.html @@ -13,13 +13,13 @@ - +
            - + \ No newline at end of file diff --git a/docs/kubernetes/kind/building-an-image-and-testing-it-in-kind.html b/docs/kubernetes/kind/building-an-image-and-testing-it-in-kind.html index 8e102c32c2a..95c975e67c9 100644 --- a/docs/kubernetes/kind/building-an-image-and-testing-it-in-kind.html +++ b/docs/kubernetes/kind/building-an-image-and-testing-it-in-kind.html @@ -13,13 +13,13 @@ - +

            Building an image and testing it in Kind

            With Podman Desktop, you can build an image with your container engine, and test it in your local Kind-powered Kubernetes cluster.

            Prerequisites​

            • Podman Desktop has access to:
              • A running container engine.
              • A running Kind cluster.
            • A container definition file: Containerfile or Dockerfile.

            Procedure​

            1. Build your image:

              1. Open Images > Build an image.
              2. Containerfile path: select your Containerfile or Dockerfile.
              3. Build context directory: optionally, select a directory different from the directory containing your Containerfile or Dockerfile.
              4. Image Name: enter your image name my-custom-image.
              5. Click Build.
              6. Wait for the image build to finish.
              7. Click Done to get back to the images list.

            2. Push your image to your Kind cluster:

              1. Search images: enter your image name my-custom-image to find the image.
              2. Click > Push image to Kind cluster.

            3. Test your image by creating a container:

              1. Click to open the Create a container from image dialog.
              2. Container name: enter my-custom-image-container.
              3. Review the parameters that Podman Desktop has detected from your image definition.
              4. Click Start Container to start the container in your container engine.

            4. Test your image and container on your Kind cluster:

              1. Search containers: enter my-custom-image-container to find the running container.
              2. Click > Deploy to Kubernetes to open the Deploy generated pod to Kubernetes screen.
              3. Pod Name: keep the proposed value my-custom-image-container-pod.
              4. Use Kubernetes Services: select Replace hostPort exposure on containers by Services. It is the recommended way to expose ports, as a cluster policy might prevent to use hostPort.
              5. Expose service locally using Kubernetes Ingress: if your container is exposing at a port, select Create a Kubernetes ingress to get access to the ports that this pod exposes, at the default ingress controller location. Example: on a default Kind cluster created with Podman Desktop: http://localhost:9090. Requirements: your cluster has an ingress controller`.
              6. Optionally, if your container is exposing more than one port, select the port to expose.
              7. Kubernetes namespaces: select default.
              8. Click Deploy.
              9. Wait for the pod to reach the state: Phase: Running.
              10. Click Done.

            Verification​

            1. The Pods screen lists the running my-image-container-pod pod.
            2. Click on the pod name to view details and logs.
            3. Optionally, if your container is exposing a port, go to http://localhost:9090: your application is running.
            - + \ No newline at end of file diff --git a/docs/kubernetes/kind/configuring-podman-for-kind-on-windows.html b/docs/kubernetes/kind/configuring-podman-for-kind-on-windows.html index 137dfc4c492..39045403d25 100644 --- a/docs/kubernetes/kind/configuring-podman-for-kind-on-windows.html +++ b/docs/kubernetes/kind/configuring-podman-for-kind-on-windows.html @@ -13,13 +13,13 @@ - +

            Configuring Podman for Kind on Windows Subsystem for Linux (WSL)

            When you create a Podman machine, Podman creates the machine in rootless mode.

            With a Podman machine running on WSL, Kind:

            • Requires the rootful machine.

            Therefore, set the Podman machine to rootful mode.

            Procedure​

            1. Stop the Podman machine:

              $ podman machine stop

            2. Set the Podman machine in rootful mode:

              $ podman machine set --rootful

            3. Start the Podman machine:

              $ podman machine start
            - + \ No newline at end of file diff --git a/docs/kubernetes/kind/creating-a-kind-cluster.html b/docs/kubernetes/kind/creating-a-kind-cluster.html index 8b184afd8eb..2041fe09fed 100644 --- a/docs/kubernetes/kind/creating-a-kind-cluster.html +++ b/docs/kubernetes/kind/creating-a-kind-cluster.html @@ -13,13 +13,13 @@ - +

            Creating a local Kind-powered Kubernetes cluster

            You can create multiple local Kind-powered Kubernetes clusters.

            Prerequisites​

            Procedure​

            1. Go to Settings > Resources

            2. In the Kind tile, click on the Create new ... button.

            3. Choose your options, and click the Create button.

              The defaults are:

              • Name: kind-cluster
              • Provider type: podman
              • HTTP port: 9090
              • HTTPS port: 9443

            4. (Optionally) Click the Show logs button to display the logs.

            5. After successful creation, click on the Go back to resources button

            Verification​

            1. In Settings > Resources, in the Kind tile, your <kind-cluster> instance is running.
            2. In the Podman Desktop tray, open the Kubernetes menu, you can set the context to your Kind cluster: kind-<kind-cluster>.
            - + \ No newline at end of file diff --git a/docs/kubernetes/kind/deleting-your-kind-cluster.html b/docs/kubernetes/kind/deleting-your-kind-cluster.html index 221e3485662..eac2f89d1ab 100644 --- a/docs/kubernetes/kind/deleting-your-kind-cluster.html +++ b/docs/kubernetes/kind/deleting-your-kind-cluster.html @@ -13,13 +13,13 @@ - +
            - + \ No newline at end of file diff --git a/docs/kubernetes/kind/installing-kind.html b/docs/kubernetes/kind/installing-kind.html index 363b999c03d..0d0aa0a8470 100644 --- a/docs/kubernetes/kind/installing-kind.html +++ b/docs/kubernetes/kind/installing-kind.html @@ -13,7 +13,7 @@ - + @@ -21,7 +21,7 @@
            - + \ No newline at end of file diff --git a/docs/kubernetes/kind/pushing-an-image-to-kind.html b/docs/kubernetes/kind/pushing-an-image-to-kind.html index c1fd14cb59c..4d2d0276fd6 100644 --- a/docs/kubernetes/kind/pushing-an-image-to-kind.html +++ b/docs/kubernetes/kind/pushing-an-image-to-kind.html @@ -13,7 +13,7 @@ - + @@ -21,7 +21,7 @@

            Pushing an image to your local Kind-powered Kubernetes cluster

            With Podman Desktop, you can push an image to your local Kind-powered Kubernetes cluster.

            Prerequisites​

            Procedure​

            1. Open Podman Desktop dashboard > Images.
            2. Search images: <your_image>:<your_tag>.
            3. Click > Push image to Kind cluster.
            4. If you created many Kind clusters, select your Kind cluster from the list.

            Verification​

            Kind does not enable you to list loaded images. Therefore, create a Pod that uses the loaded image.

            1. Create a verify_my_image.yaml Kubernetes YAML file on your workstation. Replace the placeholders:

              • Pod name and container name value must consist of lower case alphanumeric characters, '-' or '.', and must start and end with an alphanumeric character.
              • Container image value is the image you pushed.
              apiVersion: v1
              kind: Pod
              metadata:
                name: <verify-my-image>
              spec:
                containers:
                  - name: <my-image>
                    image: <my_image>:<my_tag>
                    imagePullPolicy: Never

            2. Open Pods > Play Kubernetes YAML.

              1. Kubernetes YAML file: select your verify_my_image.yaml file.
              2. Select Runtime: Using a Kubernetes cluster.
              3. Click Play.
              4. Clik Done

            3. Open Pods.

            4. Search pods: <verify-my-image>.

            5. The pod Status is Running.

            - + \ No newline at end of file diff --git a/docs/kubernetes/kind/restarting-your-kind-cluster.html b/docs/kubernetes/kind/restarting-your-kind-cluster.html index 8f7dcfdbb0c..0eda4c12658 100644 --- a/docs/kubernetes/kind/restarting-your-kind-cluster.html +++ b/docs/kubernetes/kind/restarting-your-kind-cluster.html @@ -13,7 +13,7 @@ - + @@ -22,7 +22,7 @@ Therefore, Podman Desktop stops the Kind cluster, starts it again, and hopes for the best. The Kind cluster might not restart successfully. In that case:

            - + \ No newline at end of file diff --git a/docs/kubernetes/kind/working-with-your-local-kind-cluster.html b/docs/kubernetes/kind/working-with-your-local-kind-cluster.html index a65c197eec6..82935246c42 100644 --- a/docs/kubernetes/kind/working-with-your-local-kind-cluster.html +++ b/docs/kubernetes/kind/working-with-your-local-kind-cluster.html @@ -13,13 +13,13 @@ - +

            Working with your local Kind-powered Kubernetes cluster

            Set your Kubernetes context to your local Kind-powered Kubernetes cluster.

            Procedure​

            1. Open the Podman Desktop tray.
            2. Go to Kubernetes.
            3. Click on the Kubernetes context with the kind prefix.

            Verification​

            • The Kubernetes CLI reports that the current context is your cluster with the kind suffix:

              $ kubectl config current-context
            - + \ No newline at end of file diff --git a/docs/kubernetes/lima.html b/docs/kubernetes/lima.html index 997338a65a9..3123283c841 100644 --- a/docs/kubernetes/lima.html +++ b/docs/kubernetes/lima.html @@ -13,13 +13,13 @@ - +
            - + \ No newline at end of file diff --git a/docs/kubernetes/minikube.html b/docs/kubernetes/minikube.html index 3ec09484e50..038bd34a49d 100644 --- a/docs/kubernetes/minikube.html +++ b/docs/kubernetes/minikube.html @@ -13,13 +13,13 @@ - +

            Running Kubernetes on your workstation with Minikube and Podman

            Podman Desktop can help you run Minikube-powered local Kubernetes clusters on a container engine, such as Podman.

            Procedure​

            1. Go to Settings > Extensions.
            2. Install the Minikube extension:
              1. Go to Install a new extension from OCI Image
              2. Enter the Name of the Image: ghcr.io/containers/podman-desktop-extension-minikube
              3. Click Install extension from the OCI image
            - + \ No newline at end of file diff --git a/docs/kubernetes/minikube/building-an-image-and-testing-it-in-minikube.html b/docs/kubernetes/minikube/building-an-image-and-testing-it-in-minikube.html index 3ec57107a3e..b0d9c7a4863 100644 --- a/docs/kubernetes/minikube/building-an-image-and-testing-it-in-minikube.html +++ b/docs/kubernetes/minikube/building-an-image-and-testing-it-in-minikube.html @@ -13,13 +13,13 @@ - +

            Building an image and testing it in Minikube

            With Podman Desktop, you can build an image with your container engine, and test it in your local Minikube-powered Kubernetes cluster.

            Prerequisites​

            • Podman Desktop has access to:
              • A running container engine.
              • A running Minikube cluster.
            • A container definition file: Containerfile or Dockerfile.

            Procedure​

            1. Build your image:

              1. Open Images > Build an image.
              2. Containerfile path: select your Containerfile or Dockerfile.
              3. Build context directory: optionally, select a directory different from the directory containing your Containerfile or Dockerfile.
              4. Image Name: enter your image name my-custom-image.
              5. Click Build.
              6. Wait for the image build to finish.
              7. Click Done to get back to the images list.

            2. Push your image to your Minikube cluster:

              1. Search images: enter your image name my-custom-image to find the image.
              2. Click > Push image to Minikube cluster.

            3. Test your image by creating a container:

              1. Click to open the Create a container from image dialog.
              2. Container name: enter my-custom-image-container.
              3. Review the parameters that Podman Desktop has detected from your image definition.
              4. Click Start Container to start the container in your container engine.

            4. Test your image and container on your Minikube cluster:

              1. Search containers: enter my-custom-image-container to find the running container.
              2. Click > Deploy to Kubernetes to open the Deploy generated pod to Kubernetes screen.
              3. Pod Name: keep the proposed value my-custom-image-container-pod.
              4. Use Kubernetes Services: select Replace hostPort exposure on containers by Services. It is the recommended way to expose ports, as a cluster policy might prevent to use hostPort.
              5. Expose service locally using Kubernetes LoadBalancer: if your container is exposing a service, you can use minikube service to get a web browser or an URL to use.
              6. Optionally, if your container is exposing more than one port, select the port to expose.
              7. Kubernetes namespaces: select default.
              8. Click Deploy.
              9. Wait for the pod to reach the state: Phase: Running.
              10. Click Done.

            Verification​

            1. The Pods screen lists the running my-image-container-pod pod.
            2. Click on the pod name to view details and logs.
            3. Optionally, if your container is exposing a service, go to the server URL: your application is running.
            - + \ No newline at end of file diff --git a/docs/kubernetes/minikube/configuring-podman-for-minikube-on-windows.html b/docs/kubernetes/minikube/configuring-podman-for-minikube-on-windows.html index b0fbc2edd98..a6f5fa55b6a 100644 --- a/docs/kubernetes/minikube/configuring-podman-for-minikube-on-windows.html +++ b/docs/kubernetes/minikube/configuring-podman-for-minikube-on-windows.html @@ -13,13 +13,13 @@ - +

            Configuring Podman for Minikube on Windows Subsystem for Linux (WSL)

            When you create a Podman machine, Podman creates the machine in rootless mode.

            With a Podman machine running on WSL, Minikube:

            • Requires a rootful machine.

            Therefore, set the Podman machine to rootful mode.

            Procedure​

            1. Stop the Podman machine:

              $ podman machine stop

            2. Set the Podman machine in rooful mode:

              $ podman machine set --rootful

            3. Start the Podman machine:

              $ podman machine start
            - + \ No newline at end of file diff --git a/docs/kubernetes/minikube/creating-a-minikube-cluster.html b/docs/kubernetes/minikube/creating-a-minikube-cluster.html index 4bc6aedd49c..441a69aa716 100644 --- a/docs/kubernetes/minikube/creating-a-minikube-cluster.html +++ b/docs/kubernetes/minikube/creating-a-minikube-cluster.html @@ -13,13 +13,13 @@ - +

            Creating a local Minikube-powered Kubernetes cluster

            You can create multiple local Minikube-powered Kubernetes clusters.

            Prerequisites​

            Procedure​

            1. Go to Settings > Resources

            2. In the Minikube tile, click on the Create new ... button.

            3. Choose your options, and click the Create button.

              The defaults are:

              • Name: minikube
              • Driver: podman
              • Container runtime: cri-o

            4. (Optionally) Click the Show logs button to display the logs.

            5. After successful creation, click on the Go back to resources button

            Verification​

            1. In Settings > Resources, in the Minikube tile, your <minikube> instance is running.
            2. In the Podman Desktop tray, open the Kubernetes menu, you can set the context to your Minikube cluster: minikube.
            - + \ No newline at end of file diff --git a/docs/kubernetes/minikube/deleting-your-minikube-cluster.html b/docs/kubernetes/minikube/deleting-your-minikube-cluster.html index f4f172b67e2..8ffb687da8b 100644 --- a/docs/kubernetes/minikube/deleting-your-minikube-cluster.html +++ b/docs/kubernetes/minikube/deleting-your-minikube-cluster.html @@ -13,13 +13,13 @@ - +
            - + \ No newline at end of file diff --git a/docs/kubernetes/minikube/installing-minikube.html b/docs/kubernetes/minikube/installing-minikube.html index ca304272fdb..6e8ab1c648b 100644 --- a/docs/kubernetes/minikube/installing-minikube.html +++ b/docs/kubernetes/minikube/installing-minikube.html @@ -13,7 +13,7 @@ - + @@ -21,7 +21,7 @@
            - + \ No newline at end of file diff --git a/docs/kubernetes/minikube/pushing-an-image-to-minikube.html b/docs/kubernetes/minikube/pushing-an-image-to-minikube.html index e4a716602ec..d9c18438aff 100644 --- a/docs/kubernetes/minikube/pushing-an-image-to-minikube.html +++ b/docs/kubernetes/minikube/pushing-an-image-to-minikube.html @@ -13,14 +13,14 @@ - +

            Pushing an image to your local Minikube-powered Kubernetes cluster

            With Podman Desktop, you can push an image to your local Minikube-powered Kubernetes cluster.

            Prerequisites​

            Procedure​

            1. Open Podman Desktop dashboard > Images.
            2. Search images: <your_image>:<your_tag>.
            3. Click > Push image to Minikube cluster.
            4. If you created many Minikube clusters, select your Minikube cluster from the list.

            Verification​

            Minikube enables you to list loaded images, using:

            $ minikube image list

            You can also create a Pod that uses the loaded image:

            1. Create a verify_my_image.yaml Kubernetes YAML file on your workstation. Replace the placeholders:

              • Pod name and container name value must consist of lower case alphanumeric characters, '-' or '.', and must start and end with an alphanumeric character.
              • Container image value is the image you pushed.
              apiVersion: v1
              kind: Pod
              metadata:
                name: <verify-my-image>
              spec:
                containers:
                  - name: <my-image>
                    image: <my_image>:<my_tag>
                    imagePullPolicy: Never

            2. Open Pods > Play Kubernetes YAML.

              1. Kubernetes YAML file: select your verify_my_image.yaml file.
              2. Select Runtime: Using a Kubernetes cluster.
              3. Click Play.
              4. Clik Done

            3. Open Pods.

            4. Search pods: <verify-my-image>.

            5. The pod Status is Running.

            - + \ No newline at end of file diff --git a/docs/kubernetes/minikube/restarting-your-minikube-cluster.html b/docs/kubernetes/minikube/restarting-your-minikube-cluster.html index 3d1f104f607..2be14909fb3 100644 --- a/docs/kubernetes/minikube/restarting-your-minikube-cluster.html +++ b/docs/kubernetes/minikube/restarting-your-minikube-cluster.html @@ -13,7 +13,7 @@ - + @@ -22,7 +22,7 @@ Therefore, Podman Desktop stops the Minikube cluster, and starts it again. The Minikube cluster might not restart successfully. In that case:

            - + \ No newline at end of file diff --git a/docs/kubernetes/minikube/working-with-your-local-minikube-cluster.html b/docs/kubernetes/minikube/working-with-your-local-minikube-cluster.html index c18ef19e3d1..47bb74a86ea 100644 --- a/docs/kubernetes/minikube/working-with-your-local-minikube-cluster.html +++ b/docs/kubernetes/minikube/working-with-your-local-minikube-cluster.html @@ -13,13 +13,13 @@ - +

            Working with your local Minikube-powered Kubernetes cluster

            Set your Kubernetes context to your local Minikube-powered Kubernetes cluster.

            Procedure​

            1. Open the Podman Desktop tray.
            2. Go to Kubernetes.
            3. Click on the Kubernetes context with the minikube name.

            Verification​

            • The Kubernetes CLI reports that the current context is your cluster with the minikube name:

              $ kubectl config current-context
            - + \ No newline at end of file diff --git a/docs/kubernetes/openshift.html b/docs/kubernetes/openshift.html index c4c631200fe..7c6f2358df7 100644 --- a/docs/kubernetes/openshift.html +++ b/docs/kubernetes/openshift.html @@ -13,13 +13,13 @@ - +
            - + \ No newline at end of file diff --git a/docs/kubernetes/openshift/configuring-access-to-a-developer-sandbox.html b/docs/kubernetes/openshift/configuring-access-to-a-developer-sandbox.html index 4fe5a70a345..5058afc6217 100644 --- a/docs/kubernetes/openshift/configuring-access-to-a-developer-sandbox.html +++ b/docs/kubernetes/openshift/configuring-access-to-a-developer-sandbox.html @@ -13,14 +13,14 @@ - +

            Configuring access to a Developer Sandbox

            The Developer Sandbox is a free, private OpenShift environment including one project and a resource quota of 14 GB RAM, and 40 GB storage. It lasts 30 days.

            With Podman Desktop, you can configure access to your Developer Sandbox instances.

            Prerequisites​

            Procedure​

            1. Install the Developer Sandbox extension: go to Dashboard, and click Developer Sandbox .
            2. Go to Settings > Resources.
            3. In the Developer Sandbox tile, click Create new.
            4. In the Create a Developer Sandbox screen, click Log into Developer Sandbox.
            5. In the Open external website dialog, click Yes.
            6. In the Developer Sandbox website:
              1. Click Start your sandbox for free
              2. If you never used this service, you might get through a verification workflow.
              3. In the Login with... screen, click DevSandbox.
              4. In your Developer Sandbox Console, click on your login name > Copy login command from the menu.
              5. In the Login with... screen, click DevSandbox.
              6. Click Display Token.
              7. Copy the Log in with this token full login command, similar to: oc login --token=sha256~<token> --server=https://api.sandbox-m2.<sandbox_id>.openshiftapps.com:6443.
            7. Get back to Podman Desktop Create a Developer Sandbox screen.
              1. Context name: Enter a name such as Developer Sandbox.
              2. Login command: Paste the oc login command that you copied previously.
            8. The Creation screen displays Successful operation. Click Go back to Resources.

            Verification​

            1. On the Settings > Resources screen, your Developer Sandbox is running.

              Developer Sandbox is running

            2. Select your Developer Sandbox in the Podman Desktop tray

            3. Run basic tasks such as:

            - + \ No newline at end of file diff --git a/docs/kubernetes/openshift/creating-an-openshift-local-cluster.html b/docs/kubernetes/openshift/creating-an-openshift-local-cluster.html index 30b0f58f3ae..4da626eaaa4 100644 --- a/docs/kubernetes/openshift/creating-an-openshift-local-cluster.html +++ b/docs/kubernetes/openshift/creating-an-openshift-local-cluster.html @@ -13,13 +13,13 @@ - +

            Creating an OpenShift Local instance

            Red Hat OpenShift Local manages a minimal OpenShift or MicroShift cluster on your workstation for local development and testing.

            With Podman Desktop and the OpenShift Local extension, you can manage your OpenShift Local instances.

            Prerequisites​

            Procedure​

            1. Install the OpenShift Local extension: on to Dashboard, click OpenShift Local .

            2. Install the OpenShift Local binaries, when on the Dashboard, you see Podman Desktop was not able to find an installation of OpenShift Local.

              1. In the OpenShift Local tile, click Install.
              2. When prerequisites are missing, follow the instructions.
              3. In the Red Hat OpenShift Local screen, click Yes to start the installation.
              4. Follow the installation program instructions.
              5. Reboot to finalize system changes.

            3. (Optionally) Review the extension settings in Settings > Preferences > Extension: Red Hat OpenShift Local.

            4. On the Dashboard, click Initialize and start.

              1. Select your OpenShift Local Virtual machine preset, if not set in Settings > Preferences > Extension: Red Hat OpenShift Local > Preset.

                • MicroShift (experimental): provides a lightweight and optimized environment with a limited set of services.
                • OpenShift: provides a single node OpenShift cluster with a fuller set of services, including a web console (requires more resources).

              2. Provide a pull secret, required to pull container images from the registry:

                1. Open the Red Hat OpenShift Local download page.
                2. Click Copy pull secret.
                3. Get back to Podman Desktop.
                4. Paste the pull secret, and press Enter.

            Verification​

            1. On the Dashboard screen, OpenShift Local is running.

            2. On the Settings > Resources screen, your OpenShift Local instance is running.

              Developer Sandbox is running

            3. Select your OpenShift Local instance the Podman Desktop tray.

            4. Run basic tasks such as:

            Additional resources​

            - + \ No newline at end of file diff --git a/docs/kubernetes/viewing-and-selecting-current-kubernete-context-in-the-status-bar.html b/docs/kubernetes/viewing-and-selecting-current-kubernete-context-in-the-status-bar.html index d53125ae5a2..558feb27d22 100644 --- a/docs/kubernetes/viewing-and-selecting-current-kubernete-context-in-the-status-bar.html +++ b/docs/kubernetes/viewing-and-selecting-current-kubernete-context-in-the-status-bar.html @@ -13,14 +13,14 @@ - +

            Viewing and selecting the current Kubernetes context

            With Podman Desktop, you can view and select your current Kubernetes context in the status bar.

            Prerequisites​

            • You have a Kubernetes context in your kubeconfig file: <your_kubernetes_cluster>. For example, Creating a kind cluster.

            Procedure​

            1. To view your current Kubernetes context, in the Podman Desktop main window status bar, see the name next to the icon.

            2. (Optionally) To change your Kubernetes context:

              1. Click .
              2. In the drop-down menu, click the context name to activate.
            - + \ No newline at end of file diff --git a/docs/kubernetes/viewing-and-selecting-current-kubernete-context.html b/docs/kubernetes/viewing-and-selecting-current-kubernete-context.html index 26e021f9345..d302587e7c0 100644 --- a/docs/kubernetes/viewing-and-selecting-current-kubernete-context.html +++ b/docs/kubernetes/viewing-and-selecting-current-kubernete-context.html @@ -13,14 +13,14 @@ - +

            Viewing and selecting the current Kubernetes context

            With Podman Desktop, you can view and select your current Kubernetes context.

            Prerequisites​

            • You have a Kubernetes context in your kubeconfig file: <your_kubernetes_cluster>. For example, Creating a kind cluster.

            Procedure​

            1. Open the Podman Desktop tray menu.

              In the task bar, click Show hidden icons.

              Podman Desktop tray

              Right-click the Podman Desktop tray icon to open the menu.

              Podman Desktop tray

            2. Click Kubernetes to see your current Kubernetes context.

              Podman Desktop tray

            3. (Optionally) To change your Kubernetes context, click on the context name to activate.

            - + \ No newline at end of file diff --git a/docs/migrating-from-docker.html b/docs/migrating-from-docker.html index db55f402e11..04012469592 100644 --- a/docs/migrating-from-docker.html +++ b/docs/migrating-from-docker.html @@ -13,13 +13,13 @@ - +

            Migration from Docker to Podman Desktop

            When you have used Docker in the past, you can continue using familiar workflows with Podman Desktop:

            - + \ No newline at end of file diff --git a/docs/migrating-from-docker/emulating-docker-cli-with-podman.html b/docs/migrating-from-docker/emulating-docker-cli-with-podman.html index 66ba85b151d..7076d7b63a8 100644 --- a/docs/migrating-from-docker/emulating-docker-cli-with-podman.html +++ b/docs/migrating-from-docker/emulating-docker-cli-with-podman.html @@ -13,14 +13,14 @@ - +

            Emulating Docker CLI with Podman

            Consider emulating Docker CLI with Podman to migrate transparently to Podman.

            • Continue using familiar Docker commands.
            • Take advantage of the benefits of Podman on macOS.
            • Your tools, such as Maven or Testcontainers, communicate with Podman without reconfiguration.

            Prerequisites​

            • Podman

            Procedure​

            1. Create a /usr/local/bin/docker script:

              #!/usr/bin/sh
              [ -e /etc/containers/nodocker ] || \
              echo "Emulate Docker CLI using podman. Create /etc/containers/nodocker to quiet msg." >&2
              exec podman "$@"

            2. (Optional) Create an empty /etc/containers/nodocker file to avoid the Emulate Docker CLI using podman. message when running the script.

              # touch /etc/containers/nodocker

            3. Make the script executable:

              # chmod +x /usr/local/bin/docker

            Verification​

            • Use the docker script to run commands. Example:

              $ docker run -it docker.io/hello-world
            - + \ No newline at end of file diff --git a/docs/migrating-from-docker/importing-saved-containers.html b/docs/migrating-from-docker/importing-saved-containers.html index 0a5d38a1508..50446ea21bd 100644 --- a/docs/migrating-from-docker/importing-saved-containers.html +++ b/docs/migrating-from-docker/importing-saved-containers.html @@ -13,14 +13,14 @@ - +

            Importing saved containers to Podman

            Consider importing saved containers to continue using familiar containers.

            Prerequisites​

            • Podman

            • You saved your existing containers by running the command:

              $ podman save <your_container> > <your_container_archive>.tar

            Procedure​

            • Import your existing containers into Podman. Run the command for each container archive:

              $ podman import <your_container_archive>.tar

            Verification​

            • Your imported containers appear in the Podman Desktop Images section.

            Additional resources​

            - + \ No newline at end of file diff --git a/docs/migrating-from-docker/using-podman-mac-helper.html b/docs/migrating-from-docker/using-podman-mac-helper.html index a801327ac1b..7b304ad4b5a 100644 --- a/docs/migrating-from-docker/using-podman-mac-helper.html +++ b/docs/migrating-from-docker/using-podman-mac-helper.html @@ -13,14 +13,14 @@ - +

            Using the podman-mac-helper tool to migrate from Docker to Podman on macOS

            Consider using podman-mac-help to migrate transparently to Podman on macOS.

            • Continue using familiar Docker commands.
            • Take advantage of the benefits of Podman on macOS.
            • Your tools, such as Maven or Testcontainers, communicate with Podman without reconfiguration.

            The podman-mac-helper tool provides a compatibility layer that allows you to use most Docker commands with Podman on macOS. The service redirects /var/run/docker to the fixed user-assigned UNIX socket location.

            Prerequisites​

            Procedure​

            1. Set up the podman-mac-helper service: run the command in a terminal:

              sudo podman-mac-helper install

            2. Restart your Podman machine: go to Settings > Resources, and in the Podman tile, click .

            Verification​

            1. The Docker socket is a symbolic link for the Podman socket:

              $ ls -la /var/run/docker.sock

              The output points to a podman.sock file such as:

              /var/run/docker.sock -> /Users/username/.local/share/containers/podman/machine/podman.sock

            2. When you query the Docker socket, you receive replies from Podman rather than Docker.

              For instance, this command outputs Podman version rather that Docker version:

              $ curl -s --unix-socket /var/run/docker.sock "http://v1.41/info"  | jq -r .ServerVersion

            3. Your tools communicating to the Docker socket, such as Maven or Testcontainers, communicate with Podman without reconfiguration.

            4. (Optionally, if the docker CLI is installed) The docker CLI context is set to the default value unix:///var/run/docker.sock:

              $ docker context list
              NAME       TYPE  DESCRIPTION                              DOCKER ENDPOINT             KUBERNETES ENDPOINT  ORCHESTRATOR
              default *  moby  Current DOCKER_HOST based configuration  unix:///var/run/docker.sock

            5. (Optionally, if the docker CLI is installed) The docker CLI communicates with the Podman socket.

              Therefore this command outputs Podman version rather that Docker version:

              $ docker info --format=json | jq -r .ServerVersion

            Additional resources​

            - + \ No newline at end of file diff --git a/docs/migrating-from-docker/using-the-docker_host-environment-variable.html b/docs/migrating-from-docker/using-the-docker_host-environment-variable.html index b5b0d4228a1..b061dafb113 100644 --- a/docs/migrating-from-docker/using-the-docker_host-environment-variable.html +++ b/docs/migrating-from-docker/using-the-docker_host-environment-variable.html @@ -13,13 +13,13 @@ - +

            Using the DOCKER_HOST environment variable

            Consider using the DOCKER_HOST environment variable to migrate transparently from Docker to Podman Desktop on all platforms.

            • Continue using familiar Docker commands.
            • Take advantage of the benefits of Podman.
            • Your tools, such as Gradle or Testcontainers, communicate with Podman without reconfiguration.

            Prerequisites​

            • Podman

            Procedure​

            1. Identify the location of your Podman socket

              $ podman machine inspect --format '{{.ConnectionInfo.PodmanSocket.Path}}'

            2. Set the DOCKER_HOST environment variable to your Podman socket location. Be sure to add the unix:// scheme to the path retrieved previously:

              $ export DOCKER_HOST=unix://<your_podman_socket_location>

            Verification​

            • Your tools using the DOCKER_HOST environment variable, such as Gradle or Testcontainers, communicate with Podman without reconfiguration.
            - + \ No newline at end of file diff --git a/docs/migrating-from-docker/verifying-your-tools-are-using-podman.html b/docs/migrating-from-docker/verifying-your-tools-are-using-podman.html index d7d74e5d1dd..6482b8ac06b 100644 --- a/docs/migrating-from-docker/verifying-your-tools-are-using-podman.html +++ b/docs/migrating-from-docker/verifying-your-tools-are-using-podman.html @@ -13,13 +13,13 @@ - +

            Verifying that your tools are using Podman

            When you have configured your host to use Podman rather then Docker, consider verifying your setup works as intended.

            Prerequisites​

            Procedure​

            1. The Docker socket replies successfully for listing all containers:

              $ curl --unix-socket npipe:////./pipe/docker_engine "http:/v1.41/containers/json?all=true"

            2. Podman commands run successfully when redirected to the Docker socket:

              $ CONTAINER_HOST=npipe:////./pipe/docker_engine podman ps
            - + \ No newline at end of file diff --git a/docs/proxy.html b/docs/proxy.html index 488ccd85e41..038feb01772 100644 --- a/docs/proxy.html +++ b/docs/proxy.html @@ -13,13 +13,13 @@ - +
            - + \ No newline at end of file diff --git a/docs/proxy/using-a-proxy-in-your-containers.html b/docs/proxy/using-a-proxy-in-your-containers.html index 257a29c16a6..25aa6156201 100644 --- a/docs/proxy/using-a-proxy-in-your-containers.html +++ b/docs/proxy/using-a-proxy-in-your-containers.html @@ -13,13 +13,13 @@ - +

            Using a proxy in your containers on macOS and Windows

            You can configure your Podman machine to use a proxy for your containers.

            Prerequisites​

            • <your.proxy.tld:port>: Your proxy URL.

            Procedure​

            1. Open a shell prompt on the Podman machine:

              $ podman machine ssh

            2. Edit the containers.conf file to pass the proxy environment variables to Podman CLI.

              The file location depends on your connection mode:

              • rootless: $HOME/.config/containers/containers.conf

              • rootful: /etc/containers/containers.conf

            3. Set the proxy environment variables to pass into the containers:

              [containers]
              http_proxy = true
              env = ["http_proxy=<your.proxy.tld:port>", "https_proxy=<your.proxy.tld:port>"]

            4. Go to Settings > Resources and restart the Podman machine.

            - + \ No newline at end of file diff --git a/docs/proxy/using-a-proxy-on-linux.html b/docs/proxy/using-a-proxy-on-linux.html index c7b202e03e3..3e4780780c7 100644 --- a/docs/proxy/using-a-proxy-on-linux.html +++ b/docs/proxy/using-a-proxy-on-linux.html @@ -13,13 +13,13 @@ - +

            Using Podman Desktop behind a proxy on Linux

            You can configure Podman to run behind a proxy.

            Prerequisites​

            • <proxy_ca.pem>: Your proxy Certificate Authorities (CA), in Privacy-Enhanced Mail (PEM) format.
            • <your.proxy.tld:port>: Your proxy URL.

            Procedure​

            1. Edit the containers.conf file to pass the proxy environment variables to Podman CLI.

              The file location depends on your connection mode:

              • rootless: $HOME/.config/containers/containers.conf

              • rootful: /etc/containers/containers.conf

            2. Set the proxy environment variables to pass into the containers:

              [containers]
              http_proxy = true
              env = ["http_proxy=<your.proxy.tld:port>", "https_proxy=<your.proxy.tld:port>"]

            3. Set the proxy environment variables to pass into the Podman engine:

              [engine]
              env = ["http_proxy=<your.proxy.tld:port>", "https_proxy=<your.proxy.tld:port>"]

            4. Add the custom Certificate Authorities (CA) for your proxy:

              $ sudo cp <proxy_ca.pem> /etc/pki/ca-trust/source/anchors/
              $ sudo update-ca-trust

            5. Restart all podman processes.

              $ pkill podman

            6. Restart Podman Desktop: Ctrl + q.

            Verification​

            1. Go to Images.
            2. Click Pull an image.
            3. Image to Pull: bash
            4. Click Pull image.
            5. Podman Desktop reports Download complete.
            - + \ No newline at end of file diff --git a/docs/proxy/using-a-proxy-requiring-a-custom-ca.html b/docs/proxy/using-a-proxy-requiring-a-custom-ca.html index 6902a24b968..632920b6b83 100644 --- a/docs/proxy/using-a-proxy-requiring-a-custom-ca.html +++ b/docs/proxy/using-a-proxy-requiring-a-custom-ca.html @@ -13,14 +13,14 @@ - +

            Using Podman Desktop behind a proxy requiring custom Certificate Authorities (CA) on macOS and Windows

            You can configure Podman Desktop to run behind a proxy requiring custom Certificate Authorities (CA), such as self-signed certificates. The configuration applies to the Podman engine, but not to your containers.

            Prerequisites​

            • Your proxy URL: <your.proxy.tld:port>
            • Your proxy Certificate Authorities (CA) is stored in your home directory, in the proxy_ca.pem file, in Privacy-Enhanced Mail (PEM) format.

            Procedure​

            1. Go to Settings > Proxy, and set your proxy URL:

              1. Proxy configuration enabled: yes
              2. Web Proxy (HTTP): <your.proxy.tld:port>
              3. Secure Web Proxy (HTTPS): <your.proxy.tld:port>
              4. Click the Update button

            2. Copy the certificate to the Podman machine:

              $ cat proxy_ca.pem | podman machine ssh podman-machine-default "cat > proxy_ca.pem"

            3. Open a shell prompt on the Podman machine:

              $ podman machine ssh podman-machine-default

            4. Add the custom Certificate Authorities (CA) for your proxy:

              $ sudo cp proxy_ca.pem /etc/pki/ca-trust/source/anchors/
              $ sudo update-ca-trust

            5. Go to Settings > Resources and restart the Podman machine.

            Verification​

            1. Go to Images.
            2. Click Pull an image.
            3. Image to Pull: bash
            4. Click Pull image.
            5. Podman Desktop reports Download complete.
            - + \ No newline at end of file diff --git a/docs/proxy/using-a-proxy.html b/docs/proxy/using-a-proxy.html index 1cad9d648a4..28a57e452b6 100644 --- a/docs/proxy/using-a-proxy.html +++ b/docs/proxy/using-a-proxy.html @@ -13,14 +13,14 @@ - +

            Using Podman Desktop behind a proxy on macOS and Windows

            You can configure Podman Desktop to run behind a proxy. The configuration applies to the Podman engine, but not to your containers.

            Prerequisites​

            Procedure​

            1. Go to Settings > Proxy, and set your proxy URL:

              1. Proxy configuration enabled: yes
              2. Web Proxy (HTTP): <your.proxy.tld:port>
              3. Secure Web Proxy (HTTPS): <your.proxy.tld:port>
              4. Click the Update button

            2. Go to Settings > Resources and restart the Podman machine.

            Verification​

            1. Go to Images.
            2. Click Pull an image.
            3. Image to Pull: bash
            4. Click Pull image.
            5. Podman Desktop reports Download complete.
            - + \ No newline at end of file diff --git a/docs/proxy/using-a-vpn-on-windows.html b/docs/proxy/using-a-vpn-on-windows.html index 631fbcf9c82..03c9c06d7c8 100644 --- a/docs/proxy/using-a-vpn-on-windows.html +++ b/docs/proxy/using-a-vpn-on-windows.html @@ -13,13 +13,13 @@ - +

            Accessing resources behind a VPN with Podman on Windows

            On Windows, if Podman needs to access resources behind a user-controlled VPN, enable user mode networking in your Podman machine.

            Prerequisites​

            • Windows host with updated WSL2.
            • Podman 4.6.0 or greater.

            Procedure​

            • When creating the Podman machine, select the User mode networking (traffic relayed by a user process) option to enable user mode networking.

            Verification​

            • You can now access resources that are behind the VPN.
            - + \ No newline at end of file diff --git a/docs/tags.html b/docs/tags.html index dd93ccb354c..bf10331ab6b 100644 --- a/docs/tags.html +++ b/docs/tags.html @@ -13,13 +13,13 @@ - +

            Tags

            - + \ No newline at end of file diff --git a/docs/tags/chocolatey.html b/docs/tags/chocolatey.html index aa27b954267..e037ca5bd93 100644 --- a/docs/tags/chocolatey.html +++ b/docs/tags/chocolatey.html @@ -13,13 +13,13 @@ - +

            One doc tagged with "chocolatey"

            View All Tags
            - + \ No newline at end of file diff --git a/docs/tags/extension.html b/docs/tags/extension.html index 20c83f4c2bb..039c86f4432 100644 --- a/docs/tags/extension.html +++ b/docs/tags/extension.html @@ -13,13 +13,13 @@ - +

            4 docs tagged with "extension"

            View All Tags

            Writing

            Writing a Podman Desktop extension

            - + \ No newline at end of file diff --git a/docs/tags/flathub.html b/docs/tags/flathub.html index b4dcd71d391..838bc1923cd 100644 --- a/docs/tags/flathub.html +++ b/docs/tags/flathub.html @@ -13,13 +13,13 @@ - +

            2 docs tagged with "flathub"

            View All Tags

            Linux

            You can install Podman Desktop on Linux from Flathub, a Flatpak bundle, or a ZIP archive.

            - + \ No newline at end of file diff --git a/docs/tags/flatpak.html b/docs/tags/flatpak.html index 002e9addc9c..88519ff7df2 100644 --- a/docs/tags/flatpak.html +++ b/docs/tags/flatpak.html @@ -13,13 +13,13 @@ - +

            2 docs tagged with "flatpak"

            View All Tags

            Linux

            You can install Podman Desktop on Linux from Flathub, a Flatpak bundle, or a ZIP archive.

            - + \ No newline at end of file diff --git a/docs/tags/getting-started.html b/docs/tags/getting-started.html index d0f34edd685..4faba43b03d 100644 --- a/docs/tags/getting-started.html +++ b/docs/tags/getting-started.html @@ -13,13 +13,13 @@ - +

            One doc tagged with "getting-started"

            View All Tags
            - + \ No newline at end of file diff --git a/docs/tags/images.html b/docs/tags/images.html index 53945bab126..d978fa33621 100644 --- a/docs/tags/images.html +++ b/docs/tags/images.html @@ -13,13 +13,13 @@ - +

            7 docs tagged with "images"

            View All Tags
            - + \ No newline at end of file diff --git a/docs/tags/installing.html b/docs/tags/installing.html index e6a9c175c78..39a825d3940 100644 --- a/docs/tags/installing.html +++ b/docs/tags/installing.html @@ -13,13 +13,13 @@ - +

            17 docs tagged with "installing"

            View All Tags

            Custom Lima instance

            Podman Desktop can assist you to create custom Lima instance on Linux and macOS.

            In your containers

            Using Podman Desktop behind a proxy requiring custom Certificate Authorities (CA).

            Linux

            You can install Podman Desktop on Linux from Flathub, a Flatpak bundle, or a ZIP archive.

            Using behind a proxy

            Using Podman Desktop behind a proxy requiring custom Certificate Authorities (CA).

            - + \ No newline at end of file diff --git a/docs/tags/kind.html b/docs/tags/kind.html index 11f197654ab..d5c6904c25d 100644 --- a/docs/tags/kind.html +++ b/docs/tags/kind.html @@ -13,13 +13,13 @@ - +

            7 docs tagged with "kind"

            View All Tags
            - + \ No newline at end of file diff --git a/docs/tags/lima.html b/docs/tags/lima.html index 0b94c7cbc8f..c5ba038ce87 100644 --- a/docs/tags/lima.html +++ b/docs/tags/lima.html @@ -13,13 +13,13 @@ - +

            One doc tagged with "lima"

            View All Tags
            - + \ No newline at end of file diff --git a/docs/tags/linux.html b/docs/tags/linux.html index bcc333610f4..abc53f5ffa1 100644 --- a/docs/tags/linux.html +++ b/docs/tags/linux.html @@ -13,13 +13,13 @@ - +

            9 docs tagged with "linux"

            View All Tags

            Custom Lima instance

            Podman Desktop can assist you to create custom Lima instance on Linux and macOS.

            In your containers

            Using Podman Desktop behind a proxy requiring custom Certificate Authorities (CA).

            Linux

            You can install Podman Desktop on Linux from Flathub, a Flatpak bundle, or a ZIP archive.

            Linux

            Using Podman Desktop behind a proxy on Linux.

            Using behind a proxy

            Using Podman Desktop behind a proxy requiring custom Certificate Authorities (CA).

            - + \ No newline at end of file diff --git a/docs/tags/mac-0-s.html b/docs/tags/mac-0-s.html index 6a6a8052301..2cf27205c53 100644 --- a/docs/tags/mac-0-s.html +++ b/docs/tags/mac-0-s.html @@ -13,13 +13,13 @@ - +

            One doc tagged with "mac0S"

            View All Tags

            Using `podman-mac-helper` on macOS

            Using the `podman-mac-helper` tool can make it easier to migrate from Docker to Podman on macOS, as it allows you to continue using familiar Docker commands while taking advantage of the benefits of Podman.

            - + \ No newline at end of file diff --git a/docs/tags/mac-os.html b/docs/tags/mac-os.html index 0e9b49aa055..71f3cdaccb6 100644 --- a/docs/tags/mac-os.html +++ b/docs/tags/mac-os.html @@ -13,13 +13,13 @@ - +

            2 docs tagged with "macOS"

            View All Tags

            Custom Lima instance

            Podman Desktop can assist you to create custom Lima instance on Linux and macOS.

            - + \ No newline at end of file diff --git a/docs/tags/macos.html b/docs/tags/macos.html index 29b4e6f1765..5a8cf39e3d5 100644 --- a/docs/tags/macos.html +++ b/docs/tags/macos.html @@ -13,13 +13,13 @@ - +

            5 docs tagged with "macos"

            View All Tags

            In your containers

            Using Podman Desktop behind a proxy requiring custom Certificate Authorities (CA).

            Using behind a proxy

            Using Podman Desktop behind a proxy requiring custom Certificate Authorities (CA).

            - + \ No newline at end of file diff --git a/docs/tags/migrating-from-docker.html b/docs/tags/migrating-from-docker.html index 782f85802ea..c1e1418a45a 100644 --- a/docs/tags/migrating-from-docker.html +++ b/docs/tags/migrating-from-docker.html @@ -13,13 +13,13 @@ - +

            6 docs tagged with "migrating-from-docker"

            View All Tags

            Emulating Docker CLI with Podman

            Emulation Docker CLI with Podman can make it easier to migrate from Docker to Podman, as it allows you to continue using familiar Docker commands while taking advantage of the benefits of Podman.

            Using `podman-mac-helper` on macOS

            Using the `podman-mac-helper` tool can make it easier to migrate from Docker to Podman on macOS, as it allows you to continue using familiar Docker commands while taking advantage of the benefits of Podman.

            Using the `DOCKER_HOST` environment variable

            Using the `DOCKER_HOST` environment variable can make it easier to migrate from Docker to Podman Desktop, as it allows you to continue using familiar Docker commands while taking advantage of the benefits of Podman.

            - + \ No newline at end of file diff --git a/docs/tags/migrating-to-kubernetes.html b/docs/tags/migrating-to-kubernetes.html index de77d632cd7..c724f8650cd 100644 --- a/docs/tags/migrating-to-kubernetes.html +++ b/docs/tags/migrating-to-kubernetes.html @@ -13,13 +13,13 @@ - +

            29 docs tagged with "migrating-to-kubernetes"

            View All Tags

            Kubernetes

            Migrate transparently from Podman to Kubernetes, and continue using familiar workflows.

            - + \ No newline at end of file diff --git a/docs/tags/minikube.html b/docs/tags/minikube.html index 3596d164bde..444928a905a 100644 --- a/docs/tags/minikube.html +++ b/docs/tags/minikube.html @@ -13,13 +13,13 @@ - +

            7 docs tagged with "minikube"

            View All Tags
            - + \ No newline at end of file diff --git a/docs/tags/openshift-local.html b/docs/tags/openshift-local.html index b126318e405..e1cc08d069e 100644 --- a/docs/tags/openshift-local.html +++ b/docs/tags/openshift-local.html @@ -13,13 +13,13 @@ - +

            One doc tagged with "openshift-local"

            View All Tags
            - + \ No newline at end of file diff --git a/docs/tags/openshift.html b/docs/tags/openshift.html index 3210167677d..b08b25dfdf9 100644 --- a/docs/tags/openshift.html +++ b/docs/tags/openshift.html @@ -13,13 +13,13 @@ - +

            3 docs tagged with "openshift"

            View All Tags
            - + \ No newline at end of file diff --git a/docs/tags/podman-desktop.html b/docs/tags/podman-desktop.html index 0c31737aaee..d91dadc6163 100644 --- a/docs/tags/podman-desktop.html +++ b/docs/tags/podman-desktop.html @@ -13,13 +13,13 @@ - +

            23 docs tagged with "podman-desktop"

            View All Tags

            Custom Lima instance

            Podman Desktop can assist you to create custom Lima instance on Linux and macOS.

            In your containers

            Using Podman Desktop behind a proxy requiring custom Certificate Authorities (CA).

            Linux

            You can install Podman Desktop on Linux from Flathub, a Flatpak bundle, or a ZIP archive.

            Linux

            Using Podman Desktop behind a proxy on Linux.

            Using behind a proxy

            Using Podman Desktop behind a proxy requiring custom Certificate Authorities (CA).

            Writing

            Writing a Podman Desktop extension

            - + \ No newline at end of file diff --git a/docs/tags/podman.html b/docs/tags/podman.html index b6155296caa..498c8e65835 100644 --- a/docs/tags/podman.html +++ b/docs/tags/podman.html @@ -13,13 +13,13 @@ - +

            5 docs tagged with "podman"

            View All Tags

            Custom Lima instance

            Podman Desktop can assist you to create custom Lima instance on Linux and macOS.

            - + \ No newline at end of file diff --git a/docs/tags/pods.html b/docs/tags/pods.html index 4925ad57f55..2a2bc89482e 100644 --- a/docs/tags/pods.html +++ b/docs/tags/pods.html @@ -13,13 +13,13 @@ - +

            2 docs tagged with "pods"

            View All Tags
            - + \ No newline at end of file diff --git a/docs/tags/proxy.html b/docs/tags/proxy.html index 9553422067c..59f51a0a1c8 100644 --- a/docs/tags/proxy.html +++ b/docs/tags/proxy.html @@ -13,13 +13,13 @@ - +

            2 docs tagged with "proxy"

            View All Tags

            Linux

            Using Podman Desktop behind a proxy on Linux.

            - + \ No newline at end of file diff --git a/docs/tags/publishing.html b/docs/tags/publishing.html index d3a89c35759..36169594d42 100644 --- a/docs/tags/publishing.html +++ b/docs/tags/publishing.html @@ -13,13 +13,13 @@ - +

            2 docs tagged with "publishing"

            View All Tags
            - + \ No newline at end of file diff --git a/docs/tags/restricted-environment.html b/docs/tags/restricted-environment.html index e1ec5daf6d0..f1a2ce0ab95 100644 --- a/docs/tags/restricted-environment.html +++ b/docs/tags/restricted-environment.html @@ -13,13 +13,13 @@ - +

            2 docs tagged with "restricted-environment"

            View All Tags
            - + \ No newline at end of file diff --git a/docs/tags/scoop.html b/docs/tags/scoop.html index fd773cf5336..bf6b054bfb6 100644 --- a/docs/tags/scoop.html +++ b/docs/tags/scoop.html @@ -13,13 +13,13 @@ - +

            One doc tagged with "scoop"

            View All Tags
            - + \ No newline at end of file diff --git a/docs/tags/vpn.html b/docs/tags/vpn.html index 5497351bda3..b0e18a59755 100644 --- a/docs/tags/vpn.html +++ b/docs/tags/vpn.html @@ -13,13 +13,13 @@ - +

            One doc tagged with "vpn"

            View All Tags
            - + \ No newline at end of file diff --git a/docs/tags/when-clause.html b/docs/tags/when-clause.html index a6f45c0e85f..d0c2409343e 100644 --- a/docs/tags/when-clause.html +++ b/docs/tags/when-clause.html @@ -13,13 +13,13 @@ - +

            One doc tagged with "when clause"

            View All Tags
            - + \ No newline at end of file diff --git a/docs/tags/windows.html b/docs/tags/windows.html index 4be3ad49428..53211dc6cdd 100644 --- a/docs/tags/windows.html +++ b/docs/tags/windows.html @@ -13,13 +13,13 @@ - +

            15 docs tagged with "windows"

            View All Tags

            In your containers

            Using Podman Desktop behind a proxy requiring custom Certificate Authorities (CA).

            Using behind a proxy

            Using Podman Desktop behind a proxy requiring custom Certificate Authorities (CA).

            - + \ No newline at end of file diff --git a/docs/tags/winget.html b/docs/tags/winget.html index 3339f8ad367..c57a9d5dc5e 100644 --- a/docs/tags/winget.html +++ b/docs/tags/winget.html @@ -13,13 +13,13 @@ - +

            One doc tagged with "winget"

            View All Tags
            - + \ No newline at end of file diff --git a/docs/tags/writing.html b/docs/tags/writing.html index 9b38aef258f..2b79eb56238 100644 --- a/docs/tags/writing.html +++ b/docs/tags/writing.html @@ -13,13 +13,13 @@ - +

            2 docs tagged with "writing"

            View All Tags

            Writing

            Writing a Podman Desktop extension

            - + \ No newline at end of file diff --git a/docs/troubleshooting.html b/docs/troubleshooting.html index e60a35ff894..782ab2f732c 100644 --- a/docs/troubleshooting.html +++ b/docs/troubleshooting.html @@ -13,13 +13,13 @@ - +

            Troubleshooting

            If you cannot find your issue here or in the documentation, please fill an issue on our repository. You can also explore the discussions and do a search on similar issues on the repository.

            Using the Troubleshooting page​

            Podman Desktop has a Troubleshooting page to help identify and fix most common errors.

            Procedure​

            1. To open the Troubleshooting page, click the icon.

            2. To test the connection to the container engine, click the Ping button.

              Expect a reply such as: Responded: 79,75 (9.10ms).

            3. To test Click the Check containers button.

              Expect a reply such as: Responded: 16 containers (108.70ms).

            4. When connection to the container engine failed, to recreate connections to the sockets, click the Reconnect providers button.

              Expect a reply such as: Done in (5.00ms).

            5. Search for errors in the Logs section.

            Additional resources​

            - + \ No newline at end of file diff --git a/docs/troubleshooting/troubleshooting-openshift-local.html b/docs/troubleshooting/troubleshooting-openshift-local.html index 3904ecc6246..2b25d69fcab 100644 --- a/docs/troubleshooting/troubleshooting-openshift-local.html +++ b/docs/troubleshooting/troubleshooting-openshift-local.html @@ -13,13 +13,13 @@ - +

            Troubleshooting OpenShift Local

            You can find here troubleshooting help for issues specific to OpenShift Local.

            1. To verify that your user can run crc, verify that the crc binary is available in the user PATH (/usr/local/bin/crc on macOS and Linux).

            2. To verify that the host is ready to run OpenShift Local, in a terminal, run this command and verify the output has no errors:

              $ crc setup --check-only

              Sample output:

              INFO Using bundle path <bundle_path>
              INFO Checking if running as non-root
              INFO Checking if running inside WSL2
              INFO Checking if crc-admin-helper executable is cached
              crc-admin-helper executable is not cached

            3. To verify the configured preset, in a terminal, run:

              $ crc config get preset
            - + \ No newline at end of file diff --git a/docs/troubleshooting/troubleshooting-podman-on-linux.html b/docs/troubleshooting/troubleshooting-podman-on-linux.html index 53df915d2a6..b4fa16d4ed5 100644 --- a/docs/troubleshooting/troubleshooting-podman-on-linux.html +++ b/docs/troubleshooting/troubleshooting-podman-on-linux.html @@ -13,14 +13,14 @@ - +

            Troubleshooting Podman on Linux

            Podman Desktop does not manage native Podman​

            On Linux, Podman usually runs natively on the host. Podman might also run in a virtual machine.

            Podman Desktop does only connect to the native rootless podman connection.

            Podman Desktop does not manage podman native configuration or podman machine (create, configure, start, stop, delete).

            Podman Desktop might manage configuration relative to connections to registries and proxies.

            - + \ No newline at end of file diff --git a/docs/troubleshooting/troubleshooting-podman-on-macos.html b/docs/troubleshooting/troubleshooting-podman-on-macos.html index 7bd1a04f505..a955356de8b 100644 --- a/docs/troubleshooting/troubleshooting-podman-on-macos.html +++ b/docs/troubleshooting/troubleshooting-podman-on-macos.html @@ -13,7 +13,7 @@ - + @@ -23,7 +23,7 @@ or any similar error denoting that Podman Engine does not exist.

            Explanation​

            The Podman Installer and Homebrew use different locations to store the Podman Engine files in the file system. For example, Podman Installer installs Podman Engine in the path /opt/podman whereas Homebrew uses the path /usr/local for macOS Intel, /opt/homebrew for Apple Silicon and /home/linuxbrew/.linuxbrew for Linux.

            Solution​

            To check where exactly is your Podman Engine installed, run the command-

            which podman

            This returns the path where the Podman Engine would be installed. This would help determine further action.

            For example, if you’re looking to completely uninstall Podman Engine from your system for a fresh installation, running which podman returns the exact path where Podman still exists. This could be the path where Podman Installer stores Podman Engine, such as /opt/podman. Once you know the path, run:

            sudo rm -rf /opt/podman

            Or

            sudo rm -rf path-where-podman-exists

            Here, you would replace path-where-podman-exists with the output of which podman.

            You can now proceed for a fresh installation of Podman Desktop

            Podman machine on Apple Silicon​

            Issue​

            If you are using an Apple Silicon and brew, you might encounter the following error when starting Podman from Podman Desktop

            Error: qemu exited unexpectedly with exit code 1, stderr: qemu-system-x86_64: invalid accelerator hvf
            qemu-system-x86_64: falling back to tcg
            qemu-system-x86_64: unable to find CPU model 'host'

            Explanation​

            Podman machine is running as a x86_64 process and it could be due to a dual install of homebrew: one for x86_64 and one for arm64.

            Solution​

            You can

            1. Uninstall Podman machine on your x86_64 brew install (for example from a terminal running under rosetta) brew uninstall podman
            2. or uninstall brew x86_64 as most brew receipe have now arm64 support: follow these instructions from a terminal running under rosetta

            Then run a terminal in native mode (default) and install Podman machine brew install podman

            Finally clean the Podman machine VMs that had been previously created, and create new ones.

            $ podman machine rm podman-machine-default
            $ podman machine init

            You should be a happy camper from here.

            Recovering from a failed start​

            After a failed start, the Podman machine might be unable to start because a QEMU process is still running and the PID file is in use.

            Workaround​

            1. Kill the remaining QEMU process and stop the Podman machine:

              $ ps -edf | grep qemu-system | grep -v grep | awk '{print $2}' | xargs -I{} kill -9 {}; podman machine stop

            2. Start the Podman machine.

            Solution​

            Use Podman 4.6.1 or greater.

            Podman machine not starting with QEMU 8.1.0 from brew​

            When you installed Podman and QEMU with brew, and QEMU version is 8.1.0, Podman machine might fail to start with an error such as: Error: qemu exited unexpectedly with exit code -1, stderr: qemu-system-x86_64: Error: HV_DENIED

            Solution​

            Workaround​

            Keep your brew-based installation and apply one of these workarounds:

            • Rollback the QEMU brew package to v8.0.3.

              $ brew uninstall qemu
              $ curl -OSL https://raw.githubusercontent.com/Homebrew/homebrew-core/dc0669eca9479e9eeb495397ba3a7480aaa45c2e/Formula/qemu.rb
              $ brew install ./qemu.rb

            • Alternatively, sign the QEMU brew binary locally:

              $ cat >entitlements.xml <<EOF
              <?xml version="1.0" encoding="UTF-8"?>
              <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
              <plist version="1.0">
              <dict>
                <key>com.apple.security.hypervisor</key>
                <true/>
              </dict>
              </plist>
              EOF
              $ codesign --sign - --entitlements entitlements.xml --force /usr/local/bin/qemu-system-$(uname -m | sed -e s/arm64/aarch64/)

            Additional resources​

            - + \ No newline at end of file diff --git a/docs/troubleshooting/troubleshooting-podman-on-windows.html b/docs/troubleshooting/troubleshooting-podman-on-windows.html index bd3adab445e..d2588398fdf 100644 --- a/docs/troubleshooting/troubleshooting-podman-on-windows.html +++ b/docs/troubleshooting/troubleshooting-podman-on-windows.html @@ -13,14 +13,14 @@ - +

            Troubleshooting Podman on Windows

            You can find here troubleshooting help for issues specific to Windows.

            Deleting a corrupted Podman Machine​

            Issue​

            1. You are not able to stop your Podman Machine.

              $podman machine stop

            2. The Logs contain this error:

              Error: Error stopping sysd: exit status 1

            Workaround​

            1. To display the active Windows Subsystem for Linux (WSL) distribution list: in the terminal, run:

              $ wsl --list

            2. The command returns the list of active WSL distributions. Identify your Podman Machine in the list, such as podman-machine-default.

            3. To stop, and uninstall your Podman Machine: in the terminal, replace podman-machine-default by your Podman machine name, and run:

              $ wsl --unregister podman-machine-default

            Additional resources​

            The terminal session attaches to Podman Desktop when launching it from the command line​

            Issue​

            1. When you start Podman Desktop from the command line in Windows the terminal session attaches to it.
            2. When you quit the terminal, it kills Podman Desktop.

            Workaround​

            • Set the environment variable ELECTRON_NO_ATTACH_CONSOLE to true before launching Podman Desktop.

            When the host is behind a VPN, Podman cannot access network resources​

            When the host is behind a VPN, Podman might fail to access network resources, and display errors such as Temporary failure in name resolution.

            Solution​

            See Accessing resources behind a VPN with Podman on Windows.

            Older WSL versions might lead to networking issues​

            Older versions of WSL might cause networking issues, such as the Get-NetTCPConnection error, indicating that the WSL loopback forwarding facility is not functioning correctly. Recent versions of WSL do not have this issue Recent WSL versions do not have the issue.

            Solution​

            1. Update Windows to either the 21H1, 21H2, or 22H2 version of Windows 10, or to the 21H1 version of Windows 11, or greater.

            2. Update WSL:

              wsl --update

            3. Optionally, delete your Podman machine, and create a new one.

            - + \ No newline at end of file diff --git a/docs/troubleshooting/troubleshooting-podman.html b/docs/troubleshooting/troubleshooting-podman.html index 68e30d60fb2..352b363fdbd 100644 --- a/docs/troubleshooting/troubleshooting-podman.html +++ b/docs/troubleshooting/troubleshooting-podman.html @@ -13,7 +13,7 @@ - + @@ -23,7 +23,7 @@ After each step, quit and restart Podman Desktop to ensure that it can detect yo img

            Solution​

            1. Stop and restart Podman Desktop.

            2. In Podman Desktop, restart the Podman machine.

            3. In a terminal, restart the Podman machine:

              $ podman machine stop
              $ podman machine start

            4. If the previous step did not work for you, delete your Podman machine, and create a new one:

              $ podman machine rm
              $ podman machine init

            5. If the previous steps did not work for you, delete your Podman configuration files, and create a new Podman machine:

              $ rm -rf ~/.local/share/containers/podman
              $ rm -rf ~/.config/containers/
              $ podman machine init

            Podman Desktop is failing to display the images or containers from a rootful Podman machine​

            The rootful configuration for a Podman machine depends on the Podman machine default connection. The default connection can be modified by external events, or when creating a new Podman machine. Podman Desktop might then reconnect in rootless mode, and fail to display the images or containers.

            Workaround​

            1. Verify that the Podman default connection is the rootful connection to your Podman machine:

              $ podman system connection ls

              The default connection has true at the end of the line.

              The rootful connection has a -root name suffix, and a ssh://root@ URI prefix.

              Example default rootful connection:

              Name                        URI                                                         Identity                                      Default
              podman-machine-default      ssh://user@127.0.0.1:54826/run/user/1000/podman/podman.sock c:\Users\username\.ssh\podman-machine-default false
              podman-machine-default-root ssh://root@127.0.0.1:54826/run/podman/podman.sock           c:\Users\username\.ssh\podman-machine-default true

              Example default rootless connection:

              Name                        URI                                                         Identity                                      Default
              podman-machine-default      ssh://user@127.0.0.1:54826/run/user/1000/podman/podman.sock c:\Users\username\.ssh\podman-machine-default true
              podman-machine-default-root ssh://root@127.0.0.1:54826/run/podman/podman.sock           c:\Users\username\.ssh\podman-machine-default false

              Continue with the next steps only if the default connection is not the rootful connection to your Podman machine.

            2. Set the Podman machine in rootful mode:

              $ podman machine set --rootful

            3. Restart the Podman machine:

              $ podman machine stop
              $ podman machine start

            4. Verify that Podman default connection points to the rootful connection:

              $ podman system connection ls

              Continue with the next steps only if the default connection is not the rootful connection to your Podman machine.

            5. Set the Podman machine, such as podman-machine-default in rootful mode:

              $ podman system connection default podman-machine-default-root

            6. Restart the Podman machine:

              $ podman machine stop
              $ podman machine start

            Verification​

            1. The Podman default connection is the rootful connection to your Podman machine:

              $ podman system connection ls

            Warning about Docker compatibility mode​

            Issue​

            When running the Podman provider, a warning shows regarding Docker compatibility mode on the dashboard:

            ⚠️ Docker Socket Compatibility: Podman is not emulating the default Docker socket path: '/var/run/docker.sock'. Docker-specific tools may not work. See troubleshooting page on podman-desktop.io for more information.

            This might appear when either:

            • The Docker socket is not mounted correctly.
            • Docker Desktop is also being ran at the same time.

            Solution​

            1. Stop Docker Desktop (if installed).

            2. On macOS, Run the podman-mac-helper binary:

              $ sudo podman-mac-helper install

            3. Restart the Podman machine to recreate and activate the default Docker socket path.

            Note: If Docker Desktop is started again, it will automatically re-alias the default Docker socket location and the Podman compatibilty warning will re-appear.

            - + \ No newline at end of file diff --git a/downloads.html b/downloads.html index 306bc2467bf..227cc12add3 100644 --- a/downloads.html +++ b/downloads.html @@ -13,13 +13,13 @@ - +

            Downloads

            Windows

            Podman Desktop for Windows

            Download NowWindows installer, version
            Other downloads for Windows:
            Windows portable executableWindows installer for restricted environmentsPackage Managers Guide

            Using winget? Install in one command:

            winget install -e --id RedHat.Podman-Desktop

            macOS

            Podman Desktop for macOS

            Download NowUniversal *.dmg, version
            Other macOS downloads:
            IntelArmDisk Image for restricted environments

            Using Brew? Install in one command:

            brew install podman-desktop

            Linux

            Podman Desktop for Linux

            Download NowLinux *.flatpak, version
            Other Linux downloads:
            AMD64 binary (tar.gz)

            Using Flathub ? Install in one command:

            flatpak install flathub io.podman_desktop.PodmanDesktop
            - + \ No newline at end of file diff --git a/downloads/linux.html b/downloads/linux.html index e743bf32140..e44945b30a0 100644 --- a/downloads/linux.html +++ b/downloads/linux.html @@ -13,13 +13,13 @@ - +

            Linux Downloads

            Linux

            Podman Desktop for Linux

            Download NowLinux *.flatpak, version
            Other Linux downloads:
            AMD64 binary (tar.gz)

            Using Flathub ? Install in one command:

            flatpak install flathub io.podman_desktop.PodmanDesktop
            - + \ No newline at end of file diff --git a/downloads/macOS.html b/downloads/macOS.html index 0f513a93c66..470079cd3af 100644 --- a/downloads/macOS.html +++ b/downloads/macOS.html @@ -13,13 +13,13 @@ - +

            macOS Downloads

            macOS

            Podman Desktop for macOS

            Download NowUniversal *.dmg, version
            Other macOS downloads:
            IntelArmDisk Image for restricted environments

            Using Brew? Install in one command:

            brew install podman-desktop

            - + \ No newline at end of file diff --git a/downloads/windows.html b/downloads/windows.html index a486424ff80..682ab7a8839 100644 --- a/downloads/windows.html +++ b/downloads/windows.html @@ -13,13 +13,13 @@ - +

            Windows Downloads

            Windows

            Podman Desktop for Windows

            Download NowWindows installer, version
            Other downloads for Windows:
            Windows portable executableWindows installer for restricted environmentsPackage Managers Guide

            Using winget? Install in one command:

            winget install -e --id RedHat.Podman-Desktop
            - + \ No newline at end of file diff --git a/extend.html b/extend.html index ce536488f5b..797f45e9710 100644 --- a/extend.html +++ b/extend.html @@ -13,13 +13,13 @@ - +

            Extend capabilities with Docker Desktop extensions.

            Podman Desktop is able to use Docker Desktop UI plug-ins by adding a wrapper to intercept the API calls.

            By adding a Docker Desktop extension, you can extend the capabilities of Podman Desktop.

            Extend with Docker Desktop extensionsExtend with Docker Desktop extensionsReuse Docker Desktop extensionsReuse Docker Desktop extensions

            Extend capabilities with Podman Desktop plug-ins.

            Podman Desktop is using plug-ins under the hood to manage the different container engine.

            By adding a new plugin, you can extend the capabilities of Podman Desktop.

            For example plug a new container engine like Podman, Docker, or use Lima.

            Extensibility diagramExtensibility diagram

            Extensions are written in JavaScript/Typescript
            It consumes a TypeScript definition of the extension model.

            More extension points

            Several extension points exists in addition to adding a Provider connection.

            User interaction, dialogs, launching commands are among the possible ways to extend Podman Desktop

            - + \ No newline at end of file diff --git a/features.html b/features.html index 19aa4d1e1c8..f9233bdda5a 100644 --- a/features.html +++ b/features.html @@ -13,13 +13,13 @@ - +

            Manage containers

            List, Search, Inspect, Connect, Run and Stop containers.

            Manage containersManage containers
            Pull image and manage registriesPull image and manage registries

            Build, Pull and Push images

            Build images from the tool.

            Pull and push images by managing registries.

            Run containers from these images

            Management from the tray icon

            Check status and start/stop container engines.

            Create new machine if needed as well as start or stop Podman machines directly from the tray icon.

            Quickly check activity status and stay updated without losing focus from other tasks.

            Manage Podman MachineManage Podman Machine
            Manage Podman MachineManage Podman Machine

            Manage Podman resources

            View allocated memory, CPU and storage.

            Create new machine if needed

            Create and start Pods with Podman

            Select containers to run as a Pod.

            Play Kubernetes YAML locally without Kubernetes.

            Generate Kubernetes YAML from Pods.

            Manage PodsManage Pods
            Pull image and manage registriesPull image and manage registries

            Import Docker Desktop extensions

            Specify OCI image of a Docker Desktop extension to import it.

            For example: security scanner or deploy to OpenShift extensions.

            - + \ No newline at end of file diff --git a/index.html b/index.html index 8a2eb843a99..cf11f0b7822 100644 --- a/index.html +++ b/index.html @@ -13,13 +13,13 @@ - +

            Containers and Kubernetes for application developers

            Podman Desktop is an open source graphical tool enabling you to seamlessly work with containers and Kubernetes from your local environment.

            Download Page
            Podman Desktop home page

            Available on Windows, Mac and Linux

            Use the same UI across different operating systems

            Windows

            exe or setup.exe

            macOS

            arm64, x64 or unified dmg

            Linux

            Flatpak or AMD64 binary (tar.gz)

            features

            Build, run and manage containers.

            Build

            Build images from Containerfile or Dockerfile

            Run

            Pull images from remote registries

            Start / Stop / Restart containers

            Inspect

            Get a terminal in your container

            Inspect logs

            Push

            Push images to OCI registries

            Deploy & Test images on Kubernetes

            Discover More

            features

            Work with Pods and Kubernetes

            Working with pods

            Create Pods from existing containers

            Create, start, inspect and manage pods

            Working with Kubernetes

            Play Kubernetes YAML directly with Podman Engine

            Generate Kubernetes YAML from pods

            Deploy to existing Kubernetes environments

            Running Kubernetes on your workstation with Kind and Podman

            Discover More

            Configure

            Multiple configuration options

            Registries

            Manage OCI registries. Add/edit/delete registries.

            Proxy

            Configure your proxy settings.

            Resources Utilization

            Configure CPU/Memory/Disk of Podman machines.

            Container Engines

            Handle multiple container engines at the same time: Podman, Docker.

            extensibility

            Bring new features with Podman Desktop plug-ins or Docker Desktop Extensions.

            • Container engines are plugged through extension points
            • JavaScript extensions can contribute new behaviour
            • Reuse existing extensions such as Trivy and OpenShift directly in Podman Desktop

            Current Podman Desktop plugins: Podman, Docker, Lima, Kubernetes, and OpenShift Local with the Podman preset.

            Reuse Docker Desktop extensionsReuse Docker Desktop extensions
            Learn More

            update

            Install and keep up to date Podman

            Install Podman and other dependencies directly from Podman Desktop if not yet installed.

            Check for updates and get notified about new changes.

            Available on Windows and macOS!

            enterprise

            Enterprise ready

            Match configuration options.

            Code signing

            Signed binaries for both macOS and Windows

            Proxy

            Configure proxy within the tool. Avoid any painful files to edit.

            Registries

            Manage OCI registries. Add/edit/delete registries.

            - + \ No newline at end of file diff --git a/search.html b/search.html index cda63791608..b7426cb8d08 100644 --- a/search.html +++ b/search.html @@ -13,13 +13,13 @@ - +

            Search the documentation

            - + \ No newline at end of file