diff --git a/404.html b/404.html index 37c5729da5c..a3ed90f7e81 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/7bdcd7a7.c611acb3.js b/assets/js/7bdcd7a7.c611acb3.js new file mode 100644 index 00000000000..388963d7090 --- /dev/null +++ b/assets/js/7bdcd7a7.c611acb3.js @@ -0,0 +1 @@ +"use strict";(self.webpackChunkdocs=self.webpackChunkdocs||[]).push([[7714],{5318:(e,t,n)=>{n.d(t,{Zo:()=>m,kt:()=>u});var a=n(7378);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 r(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 o(e){for(var t=1;t=0||(i[n]=e[n]);return i}(e,t);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(e);for(a=0;a=0||Object.prototype.propertyIsEnumerable.call(e,n)&&(i[n]=e[n])}return i}var p=a.createContext({}),l=function(e){var t=a.useContext(p),n=t;return e&&(n="function"==typeof e?e(t):o(o({},t),e)),n},m=function(e){var t=l(e.components);return a.createElement(p.Provider,{value:t},e.children)},d={inlineCode:"code",wrapper:function(e){var t=e.children;return a.createElement(a.Fragment,{},t)}},c=a.forwardRef((function(e,t){var n=e.components,i=e.mdxType,r=e.originalType,p=e.parentName,m=s(e,["components","mdxType","originalType","parentName"]),c=l(n),u=i,k=c["".concat(p,".").concat(u)]||c[u]||d[u]||r;return n?a.createElement(k,o(o({ref:t},m),{},{components:n})):a.createElement(k,o({ref:t},m))}));function u(e,t){var n=arguments,i=t&&t.mdxType;if("string"==typeof e||i){var r=n.length,o=new Array(r);o[0]=c;var s={};for(var p in t)hasOwnProperty.call(t,p)&&(s[p]=t[p]);s.originalType=e,s.mdxType="string"==typeof e?e:i,o[1]=s;for(var l=2;l{n.r(t),n.d(t,{assets:()=>p,contentTitle:()=>o,default:()=>d,frontMatter:()=>r,metadata:()=>s,toc:()=>l});var a=n(5773),i=(n(7378),n(5318));const r={sidebar_position:1,title:"Writing",description:"Writing a Podman Desktop extension",tags:["podman-desktop","extension","writing"],keywords:["podman desktop","extension","writing"]},o="Writing a Podman Desktop extension",s={unversionedId:"extensions/write/index",id:"extensions/write/index",title:"Writing",description:"Writing a Podman Desktop extension",source:"@site/docs/extensions/write/index.md",sourceDirName:"extensions/write",slug:"/extensions/write/",permalink:"/docs/extensions/write/",draft:!1,editUrl:"https://github.com/containers/podman-desktop/tree/main/website/docs/extensions/write/index.md",tags:[{label:"podman-desktop",permalink:"/docs/tags/podman-desktop"},{label:"extension",permalink:"/docs/tags/extension"},{label:"writing",permalink:"/docs/tags/writing"}],version:"current",sidebarPosition:1,frontMatter:{sidebar_position:1,title:"Writing",description:"Writing a Podman Desktop extension",tags:["podman-desktop","extension","writing"],keywords:["podman desktop","extension","writing"]},sidebar:"mySidebar",previous:{title:"Extensions",permalink:"/docs/extensions/"},next:{title:"Publishing",permalink:"/docs/extensions/publish/"}},p={},l=[{value:"Initializing a Podman Desktop extension",id:"initializing-a-podman-desktop-extension",level:2},{value:"Prerequisites",id:"prerequisites",level:4},{value:"Procedure",id:"procedure",level:4},{value:"Verification",id:"verification",level:4},{value:"Writing a Podman Desktop extension entry point",id:"writing-a-podman-desktop-extension-entry-point",level:2},{value:"Prerequisites",id:"prerequisites-1",level:4},{value:"Procedure",id:"procedure-1",level:4},{value:"Verification",id:"verification-1",level:4},{value:"Additional resources",id:"additional-resources",level:4},{value:"Next steps",id:"next-steps",level:4}],m={toc:l};function d(e){let{components:t,...n}=e;return(0,i.kt)("wrapper",(0,a.Z)({},m,n,{components:t,mdxType:"MDXLayout"}),(0,i.kt)("h1",{id:"writing-a-podman-desktop-extension"},"Writing a Podman Desktop extension"),(0,i.kt)("p",null,"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."),(0,i.kt)("h2",{id:"initializing-a-podman-desktop-extension"},"Initializing a Podman Desktop extension"),(0,i.kt)("p",null,"Write the Podman Desktop extension Node.js package metadata."),(0,i.kt)("h4",{id:"prerequisites"},"Prerequisites"),(0,i.kt)("ul",null,(0,i.kt)("li",{parentName:"ul"},"JavaScript or TypeScript")),(0,i.kt)("h4",{id:"procedure"},"Procedure"),(0,i.kt)("ol",null,(0,i.kt)("li",{parentName:"ol"},(0,i.kt)("p",{parentName:"li"},"Create and edit a ",(0,i.kt)("inlineCode",{parentName:"p"},"package.json")," file."),(0,i.kt)("pre",{parentName:"li"},(0,i.kt)("code",{parentName:"pre",className:"language-json"},"{}\n"))),(0,i.kt)("li",{parentName:"ol"},(0,i.kt)("p",{parentName:"li"},"Add TypeScript and Podman Desktop API to the development dependencies:"),(0,i.kt)("pre",{parentName:"li"},(0,i.kt)("code",{parentName:"pre",className:"language-json",metastring:"lines",lines:!0},' "devDependencies": {\n "@podman-desktop/api": "latest",\n "typescript": "latest"\n },\n'))),(0,i.kt)("li",{parentName:"ol"},(0,i.kt)("p",{parentName:"li"},"Add the required metadata:"),(0,i.kt)("pre",{parentName:"li"},(0,i.kt)("code",{parentName:"pre",className:"language-json",metastring:"lines",lines:!0},' "name": "my-extension",\n "displayName": "My Hello World extension",\n "description": "How to write my first extension",\n "version": "0.0.1",\n "icon": "icon.png",\n "publisher": "benoitf",\n'))),(0,i.kt)("li",{parentName:"ol"},(0,i.kt)("p",{parentName:"li"},"Add the Podman Desktop version that might run this extension:"),(0,i.kt)("pre",{parentName:"li"},(0,i.kt)("code",{parentName:"pre",className:"language-json",metastring:"lines",lines:!0},' "engines": {\n "podman-desktop": "latest"\n },\n'))),(0,i.kt)("li",{parentName:"ol"},(0,i.kt)("p",{parentName:"li"},"Add the main entry point:"),(0,i.kt)("pre",{parentName:"li"},(0,i.kt)("code",{parentName:"pre",className:"language-json",metastring:"lines",lines:!0},' "main": "./dist/extension.js"\n'))),(0,i.kt)("li",{parentName:"ol"},(0,i.kt)("p",{parentName:"li"},"Add a Hello World command contribution"),(0,i.kt)("pre",{parentName:"li"},(0,i.kt)("code",{parentName:"pre",className:"language-json",metastring:"lines",lines:!0},' "contributes": {\n "commands": [\n {\n "command": "my.first.command",\n "title": "My First Extension: Hello World"\n }\n ]\n }\n'))),(0,i.kt)("li",{parentName:"ol"},(0,i.kt)("p",{parentName:"li"},"Add an ",(0,i.kt)("inlineCode",{parentName:"p"},"icon.png")," file to the project."))),(0,i.kt)("h4",{id:"verification"},"Verification"),(0,i.kt)("ul",null,(0,i.kt)("li",{parentName:"ul"},(0,i.kt)("p",{parentName:"li"},"Full ",(0,i.kt)("inlineCode",{parentName:"p"},"package.json")," example:"),(0,i.kt)("pre",{parentName:"li"},(0,i.kt)("code",{parentName:"pre",className:"language-json"},'{\n "devDependencies": {\n "@podman-desktop/api": "latest",\n "typescript": "latest"\n },\n "name": "my-extension",\n "displayName": "My Hello World extension",\n "description": "How to write my first extension",\n "version": "0.0.1",\n "icon": "icon.png",\n "publisher": "benoitf",\n "engines": {\n "podman-desktop": "latest"\n },\n "main": "./dist/extension.js",\n "contributes": {\n "commands": [\n {\n "command": "my.first.command",\n "title": "My First Extension: Hello World"\n }\n ]\n }\n}\n')))),(0,i.kt)("h2",{id:"writing-a-podman-desktop-extension-entry-point"},"Writing a Podman Desktop extension entry point"),(0,i.kt)("p",null,"Write the extension features."),(0,i.kt)("h4",{id:"prerequisites-1"},"Prerequisites"),(0,i.kt)("ul",null,(0,i.kt)("li",{parentName:"ul"},"JavaScript or TypeScript")),(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"},"Create and edit a ",(0,i.kt)("inlineCode",{parentName:"p"},"dist/extension.js")," file.")),(0,i.kt)("li",{parentName:"ol"},(0,i.kt)("p",{parentName:"li"},"Import the Podman Desktop API"),(0,i.kt)("pre",{parentName:"li"},(0,i.kt)("code",{parentName:"pre",className:"language-typescript"},"import * as podmanDesktopAPI from '@podman-desktop/api';\n"))),(0,i.kt)("li",{parentName:"ol"},(0,i.kt)("p",{parentName:"li"},"Expose the ",(0,i.kt)("inlineCode",{parentName:"p"},"activate")," function to call on activation."),(0,i.kt)("p",{parentName:"li"},"The signature of the function can be:"),(0,i.kt)("ul",{parentName:"li"},(0,i.kt)("li",{parentName:"ul"},(0,i.kt)("p",{parentName:"li"},"Synchronous"),(0,i.kt)("pre",{parentName:"li"},(0,i.kt)("code",{parentName:"pre",className:"language-typescript"},"export function activate(): void;\n"))),(0,i.kt)("li",{parentName:"ul"},(0,i.kt)("p",{parentName:"li"},"Asynchronous"),(0,i.kt)("pre",{parentName:"li"},(0,i.kt)("code",{parentName:"pre",className:"language-typescript"},"export async function activate(): Promise;\n"))))),(0,i.kt)("li",{parentName:"ol"},(0,i.kt)("p",{parentName:"li"},"(Optional) Add an extension context to the ",(0,i.kt)("inlineCode",{parentName:"p"},"activate")," function enabling the extension to register disposable resources:"),(0,i.kt)("pre",{parentName:"li"},(0,i.kt)("code",{parentName:"pre",className:"language-typescript"},"export async function activate(extensionContext: podmanDesktopAPI.ExtensionContext): Promise {}\n"))),(0,i.kt)("li",{parentName:"ol"},(0,i.kt)("p",{parentName:"li"},"Register the command and the callback"),(0,i.kt)("pre",{parentName:"li"},(0,i.kt)("code",{parentName:"pre",className:"language-typescript"},"import * as podmanDesktopAPI from '@podman-desktop/api';\nexport async function activate(extensionContext: podmanDesktopAPI.ExtensionContext): Promise {\n // register the command referenced in package.json file\n const myFirstCommand = podmanDesktopAPI.commands.registerCommand('my.first.command', async () => {\n // display a choice to the user for selecting some values\n const result = await podmanDesktopAPI.window.showQuickPick(['un', 'deux', 'trois'], {\n canPickMany: true, // user can select more than one choice\n });\n\n // display an information message with the user choice\n await podmanDesktopAPI.window.showInformationMessage(`The choice was: ${result}`);\n });\n\n // create an item in the status bar to run our command\n // it will stick on the left of the status bar\n const item = podmanDesktopAPI.window.createStatusBarItem(podmanDesktopAPI.StatusBarAlignLeft, 100);\n item.text = 'My first command';\n item.command = 'my.first.command';\n item.show();\n\n // register disposable resources to it's removed when we deactivte the extension\n extensionContext.subscriptions.push(myFirstCommand);\n extensionContext.subscriptions.push(item);\n}\n"))),(0,i.kt)("li",{parentName:"ol"},(0,i.kt)("p",{parentName:"li"},"(Optional) Expose the ",(0,i.kt)("inlineCode",{parentName:"p"},"deactivate")," function to call on deactivation."),(0,i.kt)("p",{parentName:"li"},"The signature of the function can be:"),(0,i.kt)("ul",{parentName:"li"},(0,i.kt)("li",{parentName:"ul"},(0,i.kt)("p",{parentName:"li"},"Synchronous"),(0,i.kt)("pre",{parentName:"li"},(0,i.kt)("code",{parentName:"pre",className:"language-typescript"},"export function deactivate(): void;\n"))),(0,i.kt)("li",{parentName:"ul"},(0,i.kt)("p",{parentName:"li"},"Asynchronous"),(0,i.kt)("pre",{parentName:"li"},(0,i.kt)("code",{parentName:"pre",className:"language-typescript"},"export async function deactivate(): Promise;\n")))))),(0,i.kt)("h4",{id:"verification-1"},"Verification"),(0,i.kt)("ul",null,(0,i.kt)("li",{parentName:"ul"},(0,i.kt)("p",{parentName:"li"},"The extension compiles and produces the output in the ",(0,i.kt)("inlineCode",{parentName:"p"},"dist")," folder.")),(0,i.kt)("li",{parentName:"ul"},(0,i.kt)("p",{parentName:"li"},"All runtime dependencies are inside the final binary."))),(0,i.kt)("h4",{id:"additional-resources"},"Additional resources"),(0,i.kt)("ul",null,(0,i.kt)("li",{parentName:"ul"},"Consider a packer such as ",(0,i.kt)("a",{parentName:"li",href:"https://rollupjs.org"},"Rollup")," or ",(0,i.kt)("a",{parentName:"li",href:"https://webpack.js.org"},"Webpack")," to shrink the size of the artifact.")),(0,i.kt)("h4",{id:"next-steps"},"Next steps"),(0,i.kt)("ul",null,(0,i.kt)("li",{parentName:"ul"},(0,i.kt)("a",{parentName:"li",href:"publish"},"Publishing a Podman Desktop extension"))))}d.isMDXComponent=!0}}]); \ No newline at end of file diff --git a/assets/js/7bdcd7a7.d34fc649.js b/assets/js/7bdcd7a7.d34fc649.js deleted file mode 100644 index 1fd788d8451..00000000000 --- a/assets/js/7bdcd7a7.d34fc649.js +++ /dev/null @@ -1 +0,0 @@ -"use strict";(self.webpackChunkdocs=self.webpackChunkdocs||[]).push([[7714],{5318:(e,t,n)=>{n.d(t,{Zo:()=>m,kt:()=>u});var i=n(7378);function a(e,t,n){return t in e?Object.defineProperty(e,t,{value:n,enumerable:!0,configurable:!0,writable:!0}):e[t]=n,e}function r(e,t){var n=Object.keys(e);if(Object.getOwnPropertySymbols){var i=Object.getOwnPropertySymbols(e);t&&(i=i.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),n.push.apply(n,i)}return n}function o(e){for(var t=1;t=0||(a[n]=e[n]);return a}(e,t);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(e);for(i=0;i=0||Object.prototype.propertyIsEnumerable.call(e,n)&&(a[n]=e[n])}return a}var p=i.createContext({}),l=function(e){var t=i.useContext(p),n=t;return e&&(n="function"==typeof e?e(t):o(o({},t),e)),n},m=function(e){var t=l(e.components);return i.createElement(p.Provider,{value:t},e.children)},d={inlineCode:"code",wrapper:function(e){var t=e.children;return i.createElement(i.Fragment,{},t)}},c=i.forwardRef((function(e,t){var n=e.components,a=e.mdxType,r=e.originalType,p=e.parentName,m=s(e,["components","mdxType","originalType","parentName"]),c=l(n),u=a,k=c["".concat(p,".").concat(u)]||c[u]||d[u]||r;return n?i.createElement(k,o(o({ref:t},m),{},{components:n})):i.createElement(k,o({ref:t},m))}));function u(e,t){var n=arguments,a=t&&t.mdxType;if("string"==typeof e||a){var r=n.length,o=new Array(r);o[0]=c;var s={};for(var p in t)hasOwnProperty.call(t,p)&&(s[p]=t[p]);s.originalType=e,s.mdxType="string"==typeof e?e:a,o[1]=s;for(var l=2;l{n.r(t),n.d(t,{assets:()=>p,contentTitle:()=>o,default:()=>d,frontMatter:()=>r,metadata:()=>s,toc:()=>l});var i=n(5773),a=(n(7378),n(5318));const r={sidebar_position:1,title:"Writing",description:"Writing a Podman Desktop extension",tags:["podman-desktop","extension","writing"],keywords:["podman desktop","extension","writing"]},o="Writing a Podman Desktop extension",s={unversionedId:"extensions/write/index",id:"extensions/write/index",title:"Writing",description:"Writing a Podman Desktop extension",source:"@site/docs/extensions/write/index.md",sourceDirName:"extensions/write",slug:"/extensions/write/",permalink:"/docs/extensions/write/",draft:!1,editUrl:"https://github.com/containers/podman-desktop/tree/main/website/docs/extensions/write/index.md",tags:[{label:"podman-desktop",permalink:"/docs/tags/podman-desktop"},{label:"extension",permalink:"/docs/tags/extension"},{label:"writing",permalink:"/docs/tags/writing"}],version:"current",sidebarPosition:1,frontMatter:{sidebar_position:1,title:"Writing",description:"Writing a Podman Desktop extension",tags:["podman-desktop","extension","writing"],keywords:["podman desktop","extension","writing"]},sidebar:"mySidebar",previous:{title:"Extensions",permalink:"/docs/extensions/"},next:{title:"Publishing",permalink:"/docs/extensions/publish/"}},p={},l=[{value:"Initializing a Podman Desktop extension",id:"initializing-a-podman-desktop-extension",level:2},{value:"Prerequisites",id:"prerequisites",level:4},{value:"Procedure",id:"procedure",level:4},{value:"Verification",id:"verification",level:4},{value:"Writing a Podman Desktop extension entry point",id:"writing-a-podman-desktop-extension-entry-point",level:2},{value:"Prerequisites",id:"prerequisites-1",level:4},{value:"Procedure",id:"procedure-1",level:4},{value:"Verification",id:"verification-1",level:4},{value:"Additional resources",id:"additional-resources",level:4},{value:"Next steps",id:"next-steps",level:4}],m={toc:l};function d(e){let{components:t,...n}=e;return(0,a.kt)("wrapper",(0,i.Z)({},m,n,{components:t,mdxType:"MDXLayout"}),(0,a.kt)("h1",{id:"writing-a-podman-desktop-extension"},"Writing a Podman Desktop extension"),(0,a.kt)("p",null,"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."),(0,a.kt)("h2",{id:"initializing-a-podman-desktop-extension"},"Initializing a Podman Desktop extension"),(0,a.kt)("p",null,"Write the Podman Desktop extension Node.js package metadata."),(0,a.kt)("h4",{id:"prerequisites"},"Prerequisites"),(0,a.kt)("ul",null,(0,a.kt)("li",{parentName:"ul"},"JavaScript or TypeScript")),(0,a.kt)("h4",{id:"procedure"},"Procedure"),(0,a.kt)("ol",null,(0,a.kt)("li",{parentName:"ol"},(0,a.kt)("p",{parentName:"li"},"Create and edit a ",(0,a.kt)("inlineCode",{parentName:"p"},"package.json")," file."),(0,a.kt)("pre",{parentName:"li"},(0,a.kt)("code",{parentName:"pre",className:"language-json"},"{}\n"))),(0,a.kt)("li",{parentName:"ol"},(0,a.kt)("p",{parentName:"li"},"Add TypeScript and Podman Desktop API to the development dependencies:"),(0,a.kt)("pre",{parentName:"li"},(0,a.kt)("code",{parentName:"pre",className:"language-json",metastring:"lines",lines:!0},' "devDependencies": {\n "@podman-desktop/api": "latest",\n "typescript": "latest"\n },\n'))),(0,a.kt)("li",{parentName:"ol"},(0,a.kt)("p",{parentName:"li"},"Add the required metadata:"),(0,a.kt)("pre",{parentName:"li"},(0,a.kt)("code",{parentName:"pre",className:"language-json",metastring:"lines",lines:!0},' "name": "my-extension",\n "displayName": "My Hello World extension",\n "description": "How to write my first extension",\n "version": "0.0.1",\n "icon": "icon.png",\n "publisher": "benoitf",\n'))),(0,a.kt)("li",{parentName:"ol"},(0,a.kt)("p",{parentName:"li"},"Add the Podman Desktop version that might run this extension:"),(0,a.kt)("pre",{parentName:"li"},(0,a.kt)("code",{parentName:"pre",className:"language-json",metastring:"lines",lines:!0},' "engines": {\n "podman-desktop": "latest"\n },\n'))),(0,a.kt)("li",{parentName:"ol"},(0,a.kt)("p",{parentName:"li"},"Add the main entry point:"),(0,a.kt)("pre",{parentName:"li"},(0,a.kt)("code",{parentName:"pre",className:"language-json",metastring:"lines",lines:!0},' "main": "./dist/extension.js"\n'))),(0,a.kt)("li",{parentName:"ol"},(0,a.kt)("p",{parentName:"li"},"Add a Hello World command contribution"),(0,a.kt)("pre",{parentName:"li"},(0,a.kt)("code",{parentName:"pre",className:"language-json",metastring:"lines",lines:!0},' "contributes": {\n "commands": [\n {\n "command": "my.first.command",\n "title": "My First Extension: Hello World"\n }\n ]\n }\n'))),(0,a.kt)("li",{parentName:"ol"},(0,a.kt)("p",{parentName:"li"},"Add an ",(0,a.kt)("inlineCode",{parentName:"p"},"icon.png")," file to the project."))),(0,a.kt)("h4",{id:"verification"},"Verification"),(0,a.kt)("ul",null,(0,a.kt)("li",{parentName:"ul"},(0,a.kt)("p",{parentName:"li"},"Full ",(0,a.kt)("inlineCode",{parentName:"p"},"package.json")," example:"),(0,a.kt)("pre",{parentName:"li"},(0,a.kt)("code",{parentName:"pre",className:"language-json"},'{\n "devDependencies": {\n "@podman-desktop/api": "latest",\n "typescript": "latest"\n },\n "name": "my-extension",\n "displayName": "My Hello World extension",\n "description": "How to write my first extension",\n "version": "0.0.1",\n "icon": "icon.png",\n "publisher": "benoitf",\n "engines": {\n "podman-desktop": "latest"\n },\n "main": "./dist/extension.js",\n "contributes": {\n "commands": [\n {\n "command": "my.first.command",\n "title": "My First Extension: Hello World"\n }\n ]\n }\n}\n')))),(0,a.kt)("h2",{id:"writing-a-podman-desktop-extension-entry-point"},"Writing a Podman Desktop extension entry point"),(0,a.kt)("p",null,"Write the extension features."),(0,a.kt)("h4",{id:"prerequisites-1"},"Prerequisites"),(0,a.kt)("ul",null,(0,a.kt)("li",{parentName:"ul"},"JavaScript or TypeScript")),(0,a.kt)("h4",{id:"procedure-1"},"Procedure"),(0,a.kt)("ol",null,(0,a.kt)("li",{parentName:"ol"},(0,a.kt)("p",{parentName:"li"},"Create and edit a ",(0,a.kt)("inlineCode",{parentName:"p"},"dist/extension.js")," file.")),(0,a.kt)("li",{parentName:"ol"},(0,a.kt)("p",{parentName:"li"},"Import the Podman Desktop API"),(0,a.kt)("pre",{parentName:"li"},(0,a.kt)("code",{parentName:"pre",className:"language-typescript"},"import * as podmanDesktopAPI from '@podman-desktop/api';\n"))),(0,a.kt)("li",{parentName:"ol"},(0,a.kt)("p",{parentName:"li"},"Expose the ",(0,a.kt)("inlineCode",{parentName:"p"},"activate")," function to call on activation."),(0,a.kt)("p",{parentName:"li"},"The signature of the function can be:"),(0,a.kt)("ul",{parentName:"li"},(0,a.kt)("li",{parentName:"ul"},(0,a.kt)("p",{parentName:"li"},"Synchronous"),(0,a.kt)("pre",{parentName:"li"},(0,a.kt)("code",{parentName:"pre",className:"language-typescript"},"export function activate(): void;\n"))),(0,a.kt)("li",{parentName:"ul"},(0,a.kt)("p",{parentName:"li"},"Asynchronous"),(0,a.kt)("pre",{parentName:"li"},(0,a.kt)("code",{parentName:"pre",className:"language-typescript"},"export async function activate(): Promise;\n"))))),(0,a.kt)("li",{parentName:"ol"},(0,a.kt)("p",{parentName:"li"},"(Optional) Add an extension context to the ",(0,a.kt)("inlineCode",{parentName:"p"},"activate")," function enabling the extension to register disposable resources:"),(0,a.kt)("pre",{parentName:"li"},(0,a.kt)("code",{parentName:"pre",className:"language-typescript"},"export async function activate(extensionContext: podmanDesktopAPI.ExtensionContext): Promise {}\n"))),(0,a.kt)("li",{parentName:"ol"},(0,a.kt)("p",{parentName:"li"},"Register the command and the callback"),(0,a.kt)("pre",{parentName:"li"},(0,a.kt)("code",{parentName:"pre",className:"language-typescript"},"import * as podmanDesktopAPI from '@podman-desktop/api';\nexport async function activate(extensionContext: podmanDesktopAPI.ExtensionContext): Promise {\n // register the command referenced in package.json file\n const myFirstCommand = extensionApi.commands.registerCommand('my.first.command', async () => {\n // display a choice to the user for selecting some values\n const result = await extensionApi.window.showQuickPick(['un', 'deux', 'trois'], {\n canPickMany: true, // user can select more than one choice\n });\n\n // display an information message with the user choice\n await extensionApi.window.showInformationMessage(`The choice was: ${result}`);\n });\n\n // create an item in the status bar to run our command\n // it will stick on the left of the status bar\n const item = extensionApi.window.createStatusBarItem(extensionApi.StatusBarAlignLeft, 100);\n item.text = 'My first command';\n item.command = 'my.first.command';\n item.show();\n\n // register disposable resources to it's removed when we deactivte the extension\n extensionContext.subscriptions.push(myFirstCommand);\n extensionContext.subscriptions.push(item);\n}\n"))),(0,a.kt)("li",{parentName:"ol"},(0,a.kt)("p",{parentName:"li"},"(Optional) Expose the ",(0,a.kt)("inlineCode",{parentName:"p"},"deactivate")," function to call on deactivation."),(0,a.kt)("p",{parentName:"li"},"The signature of the function can be:"),(0,a.kt)("ul",{parentName:"li"},(0,a.kt)("li",{parentName:"ul"},(0,a.kt)("p",{parentName:"li"},"Synchronous"),(0,a.kt)("pre",{parentName:"li"},(0,a.kt)("code",{parentName:"pre",className:"language-typescript"},"export function deactivate(): void;\n"))),(0,a.kt)("li",{parentName:"ul"},(0,a.kt)("p",{parentName:"li"},"Asynchronous"),(0,a.kt)("pre",{parentName:"li"},(0,a.kt)("code",{parentName:"pre",className:"language-typescript"},"export async function deactivate(): Promise;\n")))))),(0,a.kt)("h4",{id:"verification-1"},"Verification"),(0,a.kt)("ul",null,(0,a.kt)("li",{parentName:"ul"},(0,a.kt)("p",{parentName:"li"},"The extension compiles and produces the output in the ",(0,a.kt)("inlineCode",{parentName:"p"},"dist")," folder.")),(0,a.kt)("li",{parentName:"ul"},(0,a.kt)("p",{parentName:"li"},"All runtime dependencies are inside the final binary."))),(0,a.kt)("h4",{id:"additional-resources"},"Additional resources"),(0,a.kt)("ul",null,(0,a.kt)("li",{parentName:"ul"},"Consider a packer such as ",(0,a.kt)("a",{parentName:"li",href:"https://rollupjs.org"},"Rollup")," or ",(0,a.kt)("a",{parentName:"li",href:"https://webpack.js.org"},"Webpack")," to shrink the size of the artifact.")),(0,a.kt)("h4",{id:"next-steps"},"Next steps"),(0,a.kt)("ul",null,(0,a.kt)("li",{parentName:"ul"},(0,a.kt)("a",{parentName:"li",href:"publish"},"Publishing a Podman Desktop extension"))))}d.isMDXComponent=!0}}]); \ No newline at end of file diff --git a/assets/js/runtime~main.b7e91f62.js b/assets/js/runtime~main.8e402a50.js similarity index 99% rename from assets/js/runtime~main.b7e91f62.js rename to assets/js/runtime~main.8e402a50.js index 7feeb19b195..24d059c9bfc 100644 --- a/assets/js/runtime~main.b7e91f62.js +++ b/assets/js/runtime~main.8e402a50.js @@ -1 +1 @@ -(()=>{"use strict";var e,a,c,d,f,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,d,f)=>{if(!c){var b=1/0;for(i=0;i=f)&&Object.keys(r.O).every((e=>r.O[e](c[o])))?c.splice(o--,1):(t=!1,f0&&e[i-1][2]>f;i--)e[i]=e[i-1];e[i]=[c,d,f]},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,d){if(1&d&&(e=this(e)),8&d)return e;if("object"==typeof e&&e){if(4&d&&e.__esModule)return e;if(16&d&&"function"==typeof e.then)return e}var f=Object.create(null);r.r(f);var b={};a=a||[null,c({}),c([]),c(c)];for(var t=2&d&&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(f,b),f},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/"+({53:"935f2afb",83:"09905e74",93:"4305e853",114:"e665718d",138:"54590fd2",182:"c276ecb2",205:"83d480e9",210:"3c6cc7c6",397:"6194ac84",465:"f7b7f9b7",506:"9aa62c0e",533:"b2b675dd",563:"c685778b",592:"b39cdcf9",743:"61d4c13a",809:"840a98fb",873:"cabda5f8",902:"e5ba977d",921:"c37b4a03",945:"df322e14",1032:"a67ca768",1074:"9e8f4e9c",1089:"e561c556",1342:"a766a857",1441:"382c5d2b",1476:"53f302bb",1477:"b2f554cd",1591:"2d81b9d5",1625:"de311ed4",1676:"819ef483",1705:"94fb813f",1713:"a7023ddc",1724:"5087625a",1981:"b799648a",2082:"e85ba0e6",2178:"ba322490",2217:"d7fbbe43",2284:"4117ac4b",2472:"65a10ffa",2535:"814f3328",2557:"28726be2",2609:"6269f1c0",2667:"368cce37",2778:"608238a8",2938:"c95aa39f",3010:"56c3a9b2",3089:"a6aa9e1f",3237:"1df93b7f",3259:"03ccf92d",3317:"846a5e19",3324:"1ce91f4c",3505:"72486833",3584:"ed75cfcb",3608:"9e4087bc",3636:"8b4dd820",3751:"3720c009",3820:"a5e1f61e",3870:"5df556a2",3879:"2d629ea6",3973:"f523fb3f",4013:"01a85c17",4059:"9cb03f5d",4121:"55960ee5",4207:"beebaad6",4386:"ae79aff5",4531:"5a8fbd01",4617:"95366386",4758:"c1fad867",4770:"538510a2",4781:"12f1535e",4929:"330dfcdb",5018:"cd509849",5068:"d83d689a",5240:"22de4147",5248:"6101b3fc",5406:"eed60bcf",5468:"b9bde34b",5625:"657ac0bc",5708:"f0057c03",5723:"5d67f40a",5908:"eabf5d51",6026:"51dec273",6049:"f213dd13",6082:"a233b66e",6088:"88efc5aa",6103:"ccc49370",6120:"d4840880",6134:"3fed3fa8",6181:"4e8ec325",6536:"3ed6e2e9",6690:"4816649b",6692:"2ae2e7fe",6855:"9061acb9",7007:"8593ff01",7034:"3e03f778",7134:"0b40a488",7138:"38a042e4",7141:"b5abacaa",7149:"822c343e",7155:"76cfb1f4",7220:"7591d420",7251:"ba5b9f11",7363:"583db3ef",7366:"75281220",7377:"708d858d",7438:"9c021584",7505:"8894e90f",7536:"f6e0e63c",7622:"dbbb982f",7673:"499ddca7",7679:"83245ae6",7705:"ea2f3e28",7714:"7bdcd7a7",7739:"3ede2625",7813:"933a69d3",7847:"43b416ef",7918:"17896441",7920:"1a4e3797",8145:"006e489c",8221:"6af14956",8262:"059d1c6a",8445:"99245987",8492:"7856861d",8566:"9dce5486",8610:"6875c492",8698:"59c97daa",8800:"e6fb1369",8811:"3289a752",8860:"0d040286",8893:"ba1dc56d",8940:"b6cf724b",8970:"68b843fc",9043:"473de3ed",9106:"72dd8f7e",9133:"02e265ea",9179:"79551407",9184:"b443212b",9360:"9d9f8394",9372:"07f59c2a",9387:"b0f1c099",9514:"1be78505",9671:"0e384e19",9924:"df203c0f"}[e]||e)+"."+{53:"2af137b9",83:"d159b680",93:"fa5c0b9e",114:"99c7b2f0",138:"eda42b47",182:"90a09a09",205:"6b63b856",210:"ba14e6b5",397:"9bb266b3",465:"87b0e77c",506:"10261cc8",533:"c90a0411",563:"2661eadd",592:"1610e5a1",743:"a0769e61",809:"2d892519",873:"cb3225ff",902:"445dc0a6",921:"e50247ae",945:"728bff07",1032:"138504a9",1074:"0762c5cf",1089:"cfe07000",1342:"494d4430",1441:"9e0a3f01",1476:"1d05c108",1477:"f1e6c23e",1591:"0bc95205",1625:"ced7e14f",1676:"0cba73e6",1705:"62bf5a08",1713:"ad21704c",1724:"6b7ff57c",1947:"ff7c17e0",1981:"445e62f5",2082:"384ae0e3",2178:"13069292",2217:"61487ef6",2284:"4a5eede5",2472:"f0def9e9",2535:"c5788fac",2557:"b6b3e65e",2609:"3ea06f13",2667:"c5d57016",2778:"23c6a89c",2938:"c9d74e1e",3010:"625b7aa0",3089:"3f265d65",3237:"43ef3782",3259:"f1abd038",3317:"f0a218a9",3324:"a680ef72",3337:"82efefd4",3505:"432c507e",3584:"31de0eeb",3608:"c3805a81",3636:"0e5e6b35",3751:"c483e5b5",3820:"24b9186d",3870:"2ccbe2f9",3879:"55981757",3893:"dcd3a11c",3973:"756df355",4013:"e401bc08",4059:"2eaba62e",4121:"9dda973f",4207:"29a8c242",4386:"c96624e9",4531:"389bac49",4617:"ea23b1e4",4670:"1a86ede8",4758:"49421456",4770:"f78f11bf",4781:"04789d76",4929:"60085d37",5018:"14423442",5068:"771af886",5240:"1cc01bd9",5248:"c83f6326",5406:"6951a3ef",5468:"b0307137",5625:"727df06d",5708:"fdb3f855",5723:"c4536025",5908:"57562d84",6026:"2b35ac89",6049:"6cfe5f17",6082:"239701fe",6088:"8e2f5865",6103:"a8d429fe",6120:"3191d006",6134:"c26c79e4",6181:"9c9eb582",6536:"19b81e9a",6690:"3403b372",6692:"cdd7459f",6855:"1c8adf02",7007:"928d6401",7034:"5fa96728",7134:"a5670b1e",7138:"415295c7",7141:"a509d41c",7149:"8d1aa85a",7155:"22347d09",7220:"6fb14822",7251:"ca3ca0fa",7363:"8f8728cf",7366:"1347fb82",7377:"cb23f392",7438:"712c16e0",7505:"2b70330d",7536:"1688c2d8",7622:"07d3e0ee",7673:"e6b0543d",7679:"a34e4551",7705:"833c6f97",7714:"d34fc649",7739:"b0ed878a",7813:"8a96939a",7847:"da52cc1e",7849:"0ad6b2e7",7918:"7183501d",7920:"41536f7b",8145:"5a638566",8221:"d7c4ed01",8262:"e2b37df5",8306:"32d20a44",8445:"3c50af99",8492:"b1390de3",8566:"346f0a6f",8610:"e64867fe",8698:"51c67e2c",8777:"10f7b1e7",8800:"d48e4de7",8811:"6dfd0211",8860:"d8bd3443",8893:"952f4e80",8940:"a539e88b",8970:"e7b7dbf5",9043:"5846346c",9106:"b51c032f",9127:"24e80eea",9133:"d67cc2b3",9179:"357b7df0",9184:"46a0992b",9360:"6a129f1a",9372:"8b1fcf0d",9387:"44e5569f",9514:"d688c44c",9671:"7a5b19a3",9924:"a7bd29c2"}[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),d={},f="docs:",r.l=(e,a,c,b)=>{if(d[e])d[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 f=d[e];if(delete d[e],t.parentNode&&t.parentNode.removeChild(t),f&&f.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",72486833:"3505",75281220:"7366",79551407:"9179",95366386:"4617",99245987:"8445","935f2afb":"53","09905e74":"83","4305e853":"93",e665718d:"114","54590fd2":"138",c276ecb2:"182","83d480e9":"205","3c6cc7c6":"210","6194ac84":"397",f7b7f9b7:"465","9aa62c0e":"506",b2b675dd:"533",c685778b:"563",b39cdcf9:"592","61d4c13a":"743","840a98fb":"809",cabda5f8:"873",e5ba977d:"902",c37b4a03:"921",df322e14:"945",a67ca768:"1032","9e8f4e9c":"1074",e561c556:"1089",a766a857:"1342","382c5d2b":"1441","53f302bb":"1476",b2f554cd:"1477","2d81b9d5":"1591",de311ed4:"1625","819ef483":"1676","94fb813f":"1705",a7023ddc:"1713","5087625a":"1724",b799648a:"1981",e85ba0e6:"2082",ba322490:"2178",d7fbbe43:"2217","4117ac4b":"2284","65a10ffa":"2472","814f3328":"2535","28726be2":"2557","6269f1c0":"2609","368cce37":"2667","608238a8":"2778",c95aa39f:"2938","56c3a9b2":"3010",a6aa9e1f:"3089","1df93b7f":"3237","03ccf92d":"3259","846a5e19":"3317","1ce91f4c":"3324",ed75cfcb:"3584","9e4087bc":"3608","8b4dd820":"3636","3720c009":"3751",a5e1f61e:"3820","5df556a2":"3870","2d629ea6":"3879",f523fb3f:"3973","01a85c17":"4013","9cb03f5d":"4059","55960ee5":"4121",beebaad6:"4207",ae79aff5:"4386","5a8fbd01":"4531",c1fad867:"4758","538510a2":"4770","12f1535e":"4781","330dfcdb":"4929",cd509849:"5018",d83d689a:"5068","22de4147":"5240","6101b3fc":"5248",eed60bcf:"5406",b9bde34b:"5468","657ac0bc":"5625",f0057c03:"5708","5d67f40a":"5723",eabf5d51:"5908","51dec273":"6026",f213dd13:"6049",a233b66e:"6082","88efc5aa":"6088",ccc49370:"6103",d4840880:"6120","3fed3fa8":"6134","4e8ec325":"6181","3ed6e2e9":"6536","4816649b":"6690","2ae2e7fe":"6692","9061acb9":"6855","8593ff01":"7007","3e03f778":"7034","0b40a488":"7134","38a042e4":"7138",b5abacaa:"7141","822c343e":"7149","76cfb1f4":"7155","7591d420":"7220",ba5b9f11:"7251","583db3ef":"7363","708d858d":"7377","9c021584":"7438","8894e90f":"7505",f6e0e63c:"7536",dbbb982f:"7622","499ddca7":"7673","83245ae6":"7679",ea2f3e28:"7705","7bdcd7a7":"7714","3ede2625":"7739","933a69d3":"7813","43b416ef":"7847","1a4e3797":"7920","006e489c":"8145","6af14956":"8221","059d1c6a":"8262","7856861d":"8492","9dce5486":"8566","6875c492":"8610","59c97daa":"8698",e6fb1369:"8800","3289a752":"8811","0d040286":"8860",ba1dc56d:"8893",b6cf724b:"8940","68b843fc":"8970","473de3ed":"9043","72dd8f7e":"9106","02e265ea":"9133",b443212b:"9184","9d9f8394":"9360","07f59c2a":"9372",b0f1c099:"9387","1be78505":"9514","0e384e19":"9671",df203c0f:"9924"}[e]||e,r.p+r.u(e)},(()=>{var e={1303:0,532:0};r.f.j=(a,c)=>{var d=r.o(e,a)?e[a]:void 0;if(0!==d)if(d)c.push(d[2]);else if(/^(1303|532)$/.test(a))e[a]=0;else{var f=new Promise(((c,f)=>d=e[a]=[c,f]));c.push(d[2]=f);var b=r.p+r.u(a),t=new Error;r.l(b,(c=>{if(r.o(e,a)&&(0!==(d=e[a])&&(e[a]=void 0),d)){var f=c&&("load"===c.type?"missing":c.type),b=c&&c.target&&c.target.src;t.message="Loading chunk "+a+" failed.\n("+f+": "+b+")",t.name="ChunkLoadError",t.type=f,t.request=b,d[1](t)}}),"chunk-"+a,a)}},r.O.j=a=>0===e[a];var a=(a,c)=>{var d,f,b=c[0],t=c[1],o=c[2],n=0;if(b.some((a=>0!==e[a]))){for(d in t)r.o(t,d)&&(r.m[d]=t[d]);if(o)var i=o(r)}for(a&&a(c);n{"use strict";var e,a,c,d,f,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,d,f)=>{if(!c){var b=1/0;for(i=0;i=f)&&Object.keys(r.O).every((e=>r.O[e](c[o])))?c.splice(o--,1):(t=!1,f0&&e[i-1][2]>f;i--)e[i]=e[i-1];e[i]=[c,d,f]},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,d){if(1&d&&(e=this(e)),8&d)return e;if("object"==typeof e&&e){if(4&d&&e.__esModule)return e;if(16&d&&"function"==typeof e.then)return e}var f=Object.create(null);r.r(f);var b={};a=a||[null,c({}),c([]),c(c)];for(var t=2&d&&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(f,b),f},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/"+({53:"935f2afb",83:"09905e74",93:"4305e853",114:"e665718d",138:"54590fd2",182:"c276ecb2",205:"83d480e9",210:"3c6cc7c6",397:"6194ac84",465:"f7b7f9b7",506:"9aa62c0e",533:"b2b675dd",563:"c685778b",592:"b39cdcf9",743:"61d4c13a",809:"840a98fb",873:"cabda5f8",902:"e5ba977d",921:"c37b4a03",945:"df322e14",1032:"a67ca768",1074:"9e8f4e9c",1089:"e561c556",1342:"a766a857",1441:"382c5d2b",1476:"53f302bb",1477:"b2f554cd",1591:"2d81b9d5",1625:"de311ed4",1676:"819ef483",1705:"94fb813f",1713:"a7023ddc",1724:"5087625a",1981:"b799648a",2082:"e85ba0e6",2178:"ba322490",2217:"d7fbbe43",2284:"4117ac4b",2472:"65a10ffa",2535:"814f3328",2557:"28726be2",2609:"6269f1c0",2667:"368cce37",2778:"608238a8",2938:"c95aa39f",3010:"56c3a9b2",3089:"a6aa9e1f",3237:"1df93b7f",3259:"03ccf92d",3317:"846a5e19",3324:"1ce91f4c",3505:"72486833",3584:"ed75cfcb",3608:"9e4087bc",3636:"8b4dd820",3751:"3720c009",3820:"a5e1f61e",3870:"5df556a2",3879:"2d629ea6",3973:"f523fb3f",4013:"01a85c17",4059:"9cb03f5d",4121:"55960ee5",4207:"beebaad6",4386:"ae79aff5",4531:"5a8fbd01",4617:"95366386",4758:"c1fad867",4770:"538510a2",4781:"12f1535e",4929:"330dfcdb",5018:"cd509849",5068:"d83d689a",5240:"22de4147",5248:"6101b3fc",5406:"eed60bcf",5468:"b9bde34b",5625:"657ac0bc",5708:"f0057c03",5723:"5d67f40a",5908:"eabf5d51",6026:"51dec273",6049:"f213dd13",6082:"a233b66e",6088:"88efc5aa",6103:"ccc49370",6120:"d4840880",6134:"3fed3fa8",6181:"4e8ec325",6536:"3ed6e2e9",6690:"4816649b",6692:"2ae2e7fe",6855:"9061acb9",7007:"8593ff01",7034:"3e03f778",7134:"0b40a488",7138:"38a042e4",7141:"b5abacaa",7149:"822c343e",7155:"76cfb1f4",7220:"7591d420",7251:"ba5b9f11",7363:"583db3ef",7366:"75281220",7377:"708d858d",7438:"9c021584",7505:"8894e90f",7536:"f6e0e63c",7622:"dbbb982f",7673:"499ddca7",7679:"83245ae6",7705:"ea2f3e28",7714:"7bdcd7a7",7739:"3ede2625",7813:"933a69d3",7847:"43b416ef",7918:"17896441",7920:"1a4e3797",8145:"006e489c",8221:"6af14956",8262:"059d1c6a",8445:"99245987",8492:"7856861d",8566:"9dce5486",8610:"6875c492",8698:"59c97daa",8800:"e6fb1369",8811:"3289a752",8860:"0d040286",8893:"ba1dc56d",8940:"b6cf724b",8970:"68b843fc",9043:"473de3ed",9106:"72dd8f7e",9133:"02e265ea",9179:"79551407",9184:"b443212b",9360:"9d9f8394",9372:"07f59c2a",9387:"b0f1c099",9514:"1be78505",9671:"0e384e19",9924:"df203c0f"}[e]||e)+"."+{53:"2af137b9",83:"d159b680",93:"fa5c0b9e",114:"99c7b2f0",138:"eda42b47",182:"90a09a09",205:"6b63b856",210:"ba14e6b5",397:"9bb266b3",465:"87b0e77c",506:"10261cc8",533:"c90a0411",563:"2661eadd",592:"1610e5a1",743:"a0769e61",809:"2d892519",873:"cb3225ff",902:"445dc0a6",921:"e50247ae",945:"728bff07",1032:"138504a9",1074:"0762c5cf",1089:"cfe07000",1342:"494d4430",1441:"9e0a3f01",1476:"1d05c108",1477:"f1e6c23e",1591:"0bc95205",1625:"ced7e14f",1676:"0cba73e6",1705:"62bf5a08",1713:"ad21704c",1724:"6b7ff57c",1947:"ff7c17e0",1981:"445e62f5",2082:"384ae0e3",2178:"13069292",2217:"61487ef6",2284:"4a5eede5",2472:"f0def9e9",2535:"c5788fac",2557:"b6b3e65e",2609:"3ea06f13",2667:"c5d57016",2778:"23c6a89c",2938:"c9d74e1e",3010:"625b7aa0",3089:"3f265d65",3237:"43ef3782",3259:"f1abd038",3317:"f0a218a9",3324:"a680ef72",3337:"82efefd4",3505:"432c507e",3584:"31de0eeb",3608:"c3805a81",3636:"0e5e6b35",3751:"c483e5b5",3820:"24b9186d",3870:"2ccbe2f9",3879:"55981757",3893:"dcd3a11c",3973:"756df355",4013:"e401bc08",4059:"2eaba62e",4121:"9dda973f",4207:"29a8c242",4386:"c96624e9",4531:"389bac49",4617:"ea23b1e4",4670:"1a86ede8",4758:"49421456",4770:"f78f11bf",4781:"04789d76",4929:"60085d37",5018:"14423442",5068:"771af886",5240:"1cc01bd9",5248:"c83f6326",5406:"6951a3ef",5468:"b0307137",5625:"727df06d",5708:"fdb3f855",5723:"c4536025",5908:"57562d84",6026:"2b35ac89",6049:"6cfe5f17",6082:"239701fe",6088:"8e2f5865",6103:"a8d429fe",6120:"3191d006",6134:"c26c79e4",6181:"9c9eb582",6536:"19b81e9a",6690:"3403b372",6692:"cdd7459f",6855:"1c8adf02",7007:"928d6401",7034:"5fa96728",7134:"a5670b1e",7138:"415295c7",7141:"a509d41c",7149:"8d1aa85a",7155:"22347d09",7220:"6fb14822",7251:"ca3ca0fa",7363:"8f8728cf",7366:"1347fb82",7377:"cb23f392",7438:"712c16e0",7505:"2b70330d",7536:"1688c2d8",7622:"07d3e0ee",7673:"e6b0543d",7679:"a34e4551",7705:"833c6f97",7714:"c611acb3",7739:"b0ed878a",7813:"8a96939a",7847:"da52cc1e",7849:"0ad6b2e7",7918:"7183501d",7920:"41536f7b",8145:"5a638566",8221:"d7c4ed01",8262:"e2b37df5",8306:"32d20a44",8445:"3c50af99",8492:"b1390de3",8566:"346f0a6f",8610:"e64867fe",8698:"51c67e2c",8777:"10f7b1e7",8800:"d48e4de7",8811:"6dfd0211",8860:"d8bd3443",8893:"952f4e80",8940:"a539e88b",8970:"e7b7dbf5",9043:"5846346c",9106:"b51c032f",9127:"24e80eea",9133:"d67cc2b3",9179:"357b7df0",9184:"46a0992b",9360:"6a129f1a",9372:"8b1fcf0d",9387:"44e5569f",9514:"d688c44c",9671:"7a5b19a3",9924:"a7bd29c2"}[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),d={},f="docs:",r.l=(e,a,c,b)=>{if(d[e])d[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 f=d[e];if(delete d[e],t.parentNode&&t.parentNode.removeChild(t),f&&f.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",72486833:"3505",75281220:"7366",79551407:"9179",95366386:"4617",99245987:"8445","935f2afb":"53","09905e74":"83","4305e853":"93",e665718d:"114","54590fd2":"138",c276ecb2:"182","83d480e9":"205","3c6cc7c6":"210","6194ac84":"397",f7b7f9b7:"465","9aa62c0e":"506",b2b675dd:"533",c685778b:"563",b39cdcf9:"592","61d4c13a":"743","840a98fb":"809",cabda5f8:"873",e5ba977d:"902",c37b4a03:"921",df322e14:"945",a67ca768:"1032","9e8f4e9c":"1074",e561c556:"1089",a766a857:"1342","382c5d2b":"1441","53f302bb":"1476",b2f554cd:"1477","2d81b9d5":"1591",de311ed4:"1625","819ef483":"1676","94fb813f":"1705",a7023ddc:"1713","5087625a":"1724",b799648a:"1981",e85ba0e6:"2082",ba322490:"2178",d7fbbe43:"2217","4117ac4b":"2284","65a10ffa":"2472","814f3328":"2535","28726be2":"2557","6269f1c0":"2609","368cce37":"2667","608238a8":"2778",c95aa39f:"2938","56c3a9b2":"3010",a6aa9e1f:"3089","1df93b7f":"3237","03ccf92d":"3259","846a5e19":"3317","1ce91f4c":"3324",ed75cfcb:"3584","9e4087bc":"3608","8b4dd820":"3636","3720c009":"3751",a5e1f61e:"3820","5df556a2":"3870","2d629ea6":"3879",f523fb3f:"3973","01a85c17":"4013","9cb03f5d":"4059","55960ee5":"4121",beebaad6:"4207",ae79aff5:"4386","5a8fbd01":"4531",c1fad867:"4758","538510a2":"4770","12f1535e":"4781","330dfcdb":"4929",cd509849:"5018",d83d689a:"5068","22de4147":"5240","6101b3fc":"5248",eed60bcf:"5406",b9bde34b:"5468","657ac0bc":"5625",f0057c03:"5708","5d67f40a":"5723",eabf5d51:"5908","51dec273":"6026",f213dd13:"6049",a233b66e:"6082","88efc5aa":"6088",ccc49370:"6103",d4840880:"6120","3fed3fa8":"6134","4e8ec325":"6181","3ed6e2e9":"6536","4816649b":"6690","2ae2e7fe":"6692","9061acb9":"6855","8593ff01":"7007","3e03f778":"7034","0b40a488":"7134","38a042e4":"7138",b5abacaa:"7141","822c343e":"7149","76cfb1f4":"7155","7591d420":"7220",ba5b9f11:"7251","583db3ef":"7363","708d858d":"7377","9c021584":"7438","8894e90f":"7505",f6e0e63c:"7536",dbbb982f:"7622","499ddca7":"7673","83245ae6":"7679",ea2f3e28:"7705","7bdcd7a7":"7714","3ede2625":"7739","933a69d3":"7813","43b416ef":"7847","1a4e3797":"7920","006e489c":"8145","6af14956":"8221","059d1c6a":"8262","7856861d":"8492","9dce5486":"8566","6875c492":"8610","59c97daa":"8698",e6fb1369:"8800","3289a752":"8811","0d040286":"8860",ba1dc56d:"8893",b6cf724b:"8940","68b843fc":"8970","473de3ed":"9043","72dd8f7e":"9106","02e265ea":"9133",b443212b:"9184","9d9f8394":"9360","07f59c2a":"9372",b0f1c099:"9387","1be78505":"9514","0e384e19":"9671",df203c0f:"9924"}[e]||e,r.p+r.u(e)},(()=>{var e={1303:0,532:0};r.f.j=(a,c)=>{var d=r.o(e,a)?e[a]:void 0;if(0!==d)if(d)c.push(d[2]);else if(/^(1303|532)$/.test(a))e[a]=0;else{var f=new Promise(((c,f)=>d=e[a]=[c,f]));c.push(d[2]=f);var b=r.p+r.u(a),t=new Error;r.l(b,(c=>{if(r.o(e,a)&&(0!==(d=e[a])&&(e[a]=void 0),d)){var f=c&&("load"===c.type?"missing":c.type),b=c&&c.target&&c.target.src;t.message="Loading chunk "+a+" failed.\n("+f+": "+b+")",t.name="ChunkLoadError",t.type=f,t.request=b,d[1](t)}}),"chunk-"+a,a)}},r.O.j=a=>0===e[a];var a=(a,c)=>{var d,f,b=c[0],t=c[1],o=c[2],n=0;if(b.some((a=>0!==e[a]))){for(d in t)r.o(t,d)&&(r.m[d]=t[d]);if(o)var i=o(r)}for(a&&a(c);n - + @@ -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

· 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 1aea0c7f5de..9d07126d602 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 99aaaa28feb..0dfb98bfa13 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/develop-using-devcontainer.html b/blog/develop-using-devcontainer.html index b2342b713a2..da55e39489d 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/podman-desktop-release-0.10.html b/blog/podman-desktop-release-0.10.html index 8417638b628..bfc8720492f 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 8565cae1a60..be8d1256c56 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 0727f20ccb9..7b8b535e8d4 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 a8da9a75065..ba8fbd6f77f 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 2b1a0a5c39a..0906200e716 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 6ca7134e3a0..486e0ec9815 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 e647f6d2b1f..df378f977fb 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/running-a-local-kubernetes-cluster-with-podman-desktop.html b/blog/running-a-local-kubernetes-cluster-with-podman-desktop.html index dbeb3f7b367..3fa8245a95a 100644 --- a/blog/running-a-local-kubernetes-cluster-with-podman-desktop.html +++ b/blog/running-a-local-kubernetes-cluster-with-podman-desktop.html @@ -13,7 +13,7 @@ - + @@ -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 478ce0d56d0..4913888f410 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 09252af7bf4..ecd6edd2d32 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 09e46e1937b..b08b846c229 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 79e200e6792..b1ba592d926 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 e9d0f004c5a..7c0230852a8 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 c1f925135d7..cadeebf8bb2 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 6866634cef2..2f77f556b68 100644 --- a/blog/tags/kubernetes.html +++ b/blog/tags/kubernetes.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

· 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 a990ffbe12c..278bb710eb0 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 1e58b760ab5..b3f6aafcfda 100644 --- a/blog/tags/openshift.html +++ b/blog/tags/openshift.html @@ -13,7 +13,7 @@ - + @@ -21,7 +21,7 @@

One post tagged with "openshift"

View All Tags

· 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 197cca34f9d..46cade0c7d1 100644 --- a/blog/tags/podman-desktop.html +++ b/blog/tags/podman-desktop.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

· 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 812eefd58fa..2904a65da9e 100644 --- a/blog/tags/release.html +++ b/blog/tags/release.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

· 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 14e7a8ae5ed..aa6177a5b86 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 d5edecf5bbf..f7c4562c737 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 edf2c81063f..f7ead1f1efa 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 control various container engines, such as:

  • Docker
  • Lima
  • 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-podman-machine-with-podman-desktop.html b/docs/Installation/creating-a-podman-machine-with-podman-desktop.html index 840dfbb8b89..67ee5ec71be 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.
  • Image path (Optional): Select a bootable image containing a virtual machine with Podman.
  • Machine with root privileges: Enable to use the rootful connection by default. Required to use Kind on Windows.
  • 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 7d7b436e387..40c36610a88 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 3577173b0bd..5dd22fbb3b7 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 38bd1f075ce..54700543546 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 86679b60892..bce5e3725bf 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 4e9f90ffc5c..76fde5dca32 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 2a42066556c..b991293e34b 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 8591d063ff8..6cc726a9392 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 8636fd15578..14c94c6294b 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 @@ - +

    Installing Podman Desktop with Chocolatey

    Installing Podman Desktop on Windows with Chocolatey​

    Prerequisites​

    Procedure​

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

      choco install podman-desktop

    Additional resources​

    Next steps​

    - + \ 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 cbfc64ca4cc..c2adc05b4b0 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 e5fde37cc3c..c543832548c 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 e21692a2af0..f0570bfbf3d 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 b90b1b47f04..8917acfe02c 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 865d407f3de..dae5585dbf3 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 cb64cc2cf73..261fef36a16 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 2ae5b9cb58d..f725cd67333 100644 --- a/docs/extensions.html +++ b/docs/extensions.html @@ -13,13 +13,13 @@ - +
    - + \ No newline at end of file diff --git a/docs/extensions/install.html b/docs/extensions/install.html index febffa8994c..899dbae28a8 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 df7f3d6509d..eebff8f3c06 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 a multi-arch image that works on all supported Podman Desktop platforms:

      $ podman build --arch amd64,arm64 --manifest 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 ff8e37db7d9..b067ec3d2b8 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 = extensionApi.commands.registerCommand('my.first.command', async () => {
          // display a choice to the user for selecting some values
          const result = await extensionApi.window.showQuickPick(['un', 'deux', 'trois'], {
            canPickMany: true, // user can select more than one choice
          });

          // display an information message with the user choice
          await extensionApi.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 = extensionApi.window.createStatusBarItem(extensionApi.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​

    - +

    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/getting-started/building-an-image.html b/docs/getting-started/building-an-image.html index 1499c9f7876..2f253683461 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. Open Images.
    2. Click Build an image.
    3. On the Build Image from Containerfile screen
      1. Containerfile path: select the Containerfile to build.
      2. Image Name: edit the image name: my_image.
      3. Click Build.

    Verification​

    1. Open Images
    2. Your image <my_image> is in the list.
    - + \ 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 80223c200ad..7912f505e97 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 containers

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

    Prerequisites​

    • You are using the Podman container engine.
    • Your containers, running or stopped, are available on the Containers page. For example: <your_frontend_container> and <your_backend_container>.

    Procedure​

    1. Open Podman Desktop dashboard > Containers.
    2. Click the checkboxes to select your containers.
    3. Click to create a pod with the selected containers.
    4. On the Copy containers to a pod screen
      1. Name of the pod: edit the pod name <my_pod>.
      2. Click the Create pod using these containers button.

    Verification​

    1. Open Pods
    2. Your pod <my_pod> is in the list.
    - + \ No newline at end of file diff --git a/docs/getting-started/getting-started.html b/docs/getting-started/getting-started.html index cfe2e90c520..947bcf7b39b 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/intro.html b/docs/intro.html index dff22a8a323..8fea6b8b16a 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 6b27a9edf45..9ef74df8db1 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 491cda8ca8c..0239745ef6b 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 59c9701826c..25132158d53 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 149c45b2ed3..0da260b3bb3 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 68e0122661c..7e2f9732b76 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 7fe940811ca..7111099b96a 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 f2f0a438290..3b3e358e01c 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 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/kind/creating-a-kind-cluster.html b/docs/kubernetes/kind/creating-a-kind-cluster.html index 126ce69148c..7e16ae24213 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 279bfc0d7b1..ddfb87f7e3c 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 2e1b23816f7..011757be4a8 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 1357e9425f6..4617ec5a1dc 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 519f5bacffd..5d3979b2177 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 73e91f37533..fae98ce9e69 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/openshift.html b/docs/kubernetes/openshift.html index 0374122d13c..f455de74afb 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 a2176b69e9e..7dc3895d6a4 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 0a59c3dbfb7..c1f7bc38127 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.html b/docs/kubernetes/viewing-and-selecting-current-kubernete-context.html index 199de0b9dad..5b90a32044b 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 351ec904580..39a1c414328 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 0ebeb500a0c..e501123a321 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 b4f2c1d49d2..7d8af0e0308 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 40007f3c00f..5f480312162 100644 --- a/docs/migrating-from-docker/using-podman-mac-helper.html +++ b/docs/migrating-from-docker/using-podman-mac-helper.html @@ -13,7 +13,7 @@ - + @@ -22,7 +22,7 @@ The service redirects /var/run/docker to the fixed user-assigned UNIX socket location.

    Prerequisites​

    Procedure​

    • Set up the podman-mac-helper service for each user. Run the command:

      sudo podman-mac-helper install

      For additional install options please run the command:

      sudo podman-mac-helper install --help

    Verification​

    1. Your tools communicating to the Docker socket, such as Maven or Testcontainers, communicate with Podman without reconfiguration.

    2. Use the podman-mac-helper tool to run commands. To run a command with Podman by using the podman-mac-helper tool, prefix the command with podman-mac-helper.

      Example:

      $ podman-mac-helper run -it <your_container> bash

    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 af487f8d330..75d62f787e8 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:

      $ export DOCKER_HOST=<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 5ae4d5ed207..5c7f3f5233d 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/tags.html b/docs/tags.html index 7e4d3ebd0e1..4633113aace 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 ad63c813bc1..05ecc06f183 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 ac58ba5f3e9..904936e0af0 100644 --- a/docs/tags/extension.html +++ b/docs/tags/extension.html @@ -13,13 +13,13 @@ - +

    3 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 98ca744a88f..0f27e02a700 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 e4c44e32c14..561e8c513f7 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 742e9da08fa..15aa2424143 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 020d35343ee..b602c469f95 100644 --- a/docs/tags/images.html +++ b/docs/tags/images.html @@ -13,13 +13,13 @@ - +

    2 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 3a0f3538956..0e4afe91099 100644 --- a/docs/tags/installing.html +++ b/docs/tags/installing.html @@ -13,13 +13,13 @@ - +

    13 docs tagged with "installing"

    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/kind.html b/docs/tags/kind.html index c39cd52dea3..c9b91cf935a 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/linux.html b/docs/tags/linux.html index eb41e9a5e43..203c8860a6f 100644 --- a/docs/tags/linux.html +++ b/docs/tags/linux.html @@ -13,13 +13,13 @@ - +

    4 docs tagged with "linux"

    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/mac-0-s.html b/docs/tags/mac-0-s.html index dccca05600f..74e623f6a59 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 ed25358cc4a..3de685ae1e8 100644 --- a/docs/tags/mac-os.html +++ b/docs/tags/mac-os.html @@ -13,13 +13,13 @@ - +

    One doc tagged with "macOS"

    View All Tags
    - + \ No newline at end of file diff --git a/docs/tags/macos.html b/docs/tags/macos.html index cd629581104..329d5680cde 100644 --- a/docs/tags/macos.html +++ b/docs/tags/macos.html @@ -13,13 +13,13 @@ - +

    One doc tagged with "macos"

    View All Tags
    - + \ No newline at end of file diff --git a/docs/tags/migrating-from-docker.html b/docs/tags/migrating-from-docker.html index f969fb5515a..a89a664bf87 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 7403669b9d8..26b844d60c4 100644 --- a/docs/tags/migrating-to-kubernetes.html +++ b/docs/tags/migrating-to-kubernetes.html @@ -13,13 +13,13 @@ - +

    18 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/openshift-local.html b/docs/tags/openshift-local.html index 7d842ddcc45..7ec6dd27e37 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 6e32e73ff7a..375b38e2081 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 be83a67a09f..2b59a2b15a3 100644 --- a/docs/tags/podman-desktop.html +++ b/docs/tags/podman-desktop.html @@ -13,13 +13,13 @@ - +

    16 docs tagged with "podman-desktop"

    View All Tags

    Linux

    You can install Podman Desktop on Linux from Flathub, a Flatpak bundle, or a ZIP archive.

    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 1e3175ab9fb..f16c7e610a9 100644 --- a/docs/tags/podman.html +++ b/docs/tags/podman.html @@ -13,13 +13,13 @@ - +

    3 docs tagged with "podman"

    View All Tags
    - + \ No newline at end of file diff --git a/docs/tags/pods.html b/docs/tags/pods.html index 09d6c453bdd..965a7631f93 100644 --- a/docs/tags/pods.html +++ b/docs/tags/pods.html @@ -13,13 +13,13 @@ - +

    One doc tagged with "pods"

    View All Tags
    - + \ No newline at end of file diff --git a/docs/tags/publishing.html b/docs/tags/publishing.html index 29c70f5c0d2..acebf81ab48 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 04884ed8f76..f269595529a 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 616a6f30493..6ee360c27f3 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/windows.html b/docs/tags/windows.html index 62921515c25..d3528da2fee 100644 --- a/docs/tags/windows.html +++ b/docs/tags/windows.html @@ -13,13 +13,13 @@ - +

    10 docs tagged with "windows"

    View All Tags
    - + \ No newline at end of file diff --git a/docs/tags/winget.html b/docs/tags/winget.html index 9b45de5739f..7b1b4878050 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 6db696a44d3..bb44e939251 100644 --- a/docs/tags/writing.html +++ b/docs/tags/writing.html @@ -13,13 +13,13 @@ - +

    One doc 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 42bb6c0a423..19d3bca3faf 100644 --- a/docs/troubleshooting.html +++ b/docs/troubleshooting.html @@ -13,7 +13,7 @@ - + @@ -25,7 +25,7 @@ So, please check your version and update.

    On Windows, the named pipe is

    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 i.e. /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

    Unable to see information about active containers​

    Issue​

    In this scenario, the screen may be displaying "No Containers" as shown below despite active containers runnning in the background. img

    Solution​

    There are three ways to work this out.

    1. To solve this issue, open the Terminal and run the following commands-

      podman machine stop
      podman machine start

    2. If this does not work for you, you might proceed with the following commands-

      $ podman machine rm
      $ podman machine init

    3. If both of the abovementioned steps don't work for you, run the following commands-

      $ rm -rf ~/.local/share/containers/podman
      $ rm -rf ~/.config/containers/

      After this, you can start off again by initializing a new Podman Machine and loading up the containers.

    Unable to set custom binary path for Podman on macOS​

    Issue​

    When setting a custom binary path (under Preferences -> Custom binary path), Podman is unable to find gvproxy and podman-mac-helper:

    Error: unable to start host networking: "could not find \"gvproxy\" in one of [/usr/local/opt/podman/libexec /opt/homebrew/bin /opt/homebrew/opt/podman/libexec /usr/local/bin /usr/local/libexec/podman /usr/local/lib/podman /usr/libexec/podman /usr/lib/podman $BINDIR/../libexec/podman].  To resolve this error, set the helper_binaries_dir key in the `[engine]` section of containers.conf to the directory containing your helper binaries."

    Solution​

    1. Download gvproxy from the gvisor-tap-vsock release page.
    2. Build the podman-mac-helper from the source code on the Podman GitHub page.
    3. Add the helpers_binaries_dir entry to ~/.config/containers/conf:
    [containers]

    helper_binaries_dir=["/Users/user/example_directory"]

    NOTE: A pre-built binary will be added to the Podman release page so you do not have to build podman-mac-helper. An issue is open for this.

    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 may appear when either:

    • The Docker socket is not mounted correctly
    • Docker Desktop is also being ran at the same time

    Solution​

    On macOS:

    1. Stop Docker Desktop (if install)

    2. Run the podman-mac-helper binary:

      sudo podman-mac-helper install

      for additional options please run the command:

      sudo podman-mac-helper install --help

    3. Restart the Podman machine (the default Docker socket path will be recreated and Podman will emulate it)

    On Linux / Windows:

    1. Stop Docker Desktop (if installed)
    2. Restart the Podman machine (the default Docker socket path will be recreated and Podman will emulate it)

    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.

    Code Ready Containers​

    • Check that Podman preset is defined. (crc config get preset)
    • Check that crc binary is available in the user PATH (/usr/local/bin/crc)
    • Check that crc setup --check-only is running without errors.

    Other Issues​

    Fixing corrupted Podman Machine in Windows​

    If at all you are not able to stop your Podman Machine, you will find such an error in the Logs- Error: Error stopping sysd: exit status 1

    It is highly unlikely that you may be stuck in such a situation but if you are, here's a quick fix for it.

    Assuming the name of the Podman Machine to be my-machine, run the following commands in the terminal:

    wsl --list

    This shall display a list of active distributions i.e. my-machine in this case.

    Then,

    wsl --unregister my-machine

    (Replacing my-machine with the name that is displayed under wsl --list for your Podman Machine)

    This will stop the Podman Machine for you.

    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-machine
    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-machine

    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.

    The terminal session attaches to Podman Desktop when launching it from the command line in Windows​

    Issue​

    When you start Podman Desktop from the command line in Windows the terminal session attaches to it. You cannot quit the terminal because it will kill Podman Desktop as well.

    Solution​

    Set the environment variable ELECTRON_NO_ATTACH_CONSOLE to true before launching Podman Desktop.

    - + \ No newline at end of file diff --git a/downloads.html b/downloads.html index 58e59f3ddcf..4628f576d67 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 bac302201c2..f96b75e2e5c 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 fa5067ed49f..7ae02ad4dd1 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 eae7c589161..e77b992ea8d 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 b92baa007e2..7d2c1b27d34 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 likes Podman, Docker, Lima, etc.

    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 f87a68299ab..f563b33d1a7 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 79495a40241..6f199cf3047 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

    brew install podman-desktop

    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, and Lima.

    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 21c6e4d7648..6eb812fb7ff 100644 --- a/search.html +++ b/search.html @@ -13,13 +13,13 @@ - +

    Search the documentation

    - + \ No newline at end of file