diff --git a/404.html b/404.html index ce9a5f3b962..b7b9a14ca6c 100644 --- a/404.html +++ b/404.html @@ -4,13 +4,13 @@ Page Not Found | Podman Desktop - +
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/images/containers_error-2ddfc1139b9345ae8d06c597551608ad.png b/assets/images/containers_error-2ddfc1139b9345ae8d06c597551608ad.png new file mode 100644 index 00000000000..7751955fee4 Binary files /dev/null and b/assets/images/containers_error-2ddfc1139b9345ae8d06c597551608ad.png differ diff --git a/assets/js/935f2afb.90c01eb4.js b/assets/js/935f2afb.350537f8.js similarity index 91% rename from assets/js/935f2afb.90c01eb4.js rename to assets/js/935f2afb.350537f8.js index a818eba35d9..38a59f54a42 100644 --- a/assets/js/935f2afb.90c01eb4.js +++ b/assets/js/935f2afb.350537f8.js @@ -1 +1 @@ -"use strict";(self.webpackChunkdocs=self.webpackChunkdocs||[]).push([[53],{1109:t=>{t.exports=JSON.parse('{"pluginId":"default","version":"current","label":"Next","banner":null,"badge":false,"noIndex":false,"className":"docs-version-current","isLast":true,"docsSidebars":{"tutorialSidebar":[{"type":"link","label":"Introduction","href":"/docs/intro","docId":"intro"},{"type":"category","label":"Installation","collapsible":true,"collapsed":true,"items":[{"type":"link","label":"MacOS","href":"/docs/Installation/macos-install","docId":"Installation/macos-install"},{"type":"link","label":"Windows","href":"/docs/Installation/windows-install","docId":"Installation/windows-install"},{"type":"link","label":"Linux","href":"/docs/Installation/linux-install","docId":"Installation/linux-install"}],"href":"/docs/Installation/"},{"type":"category","label":"Getting Started","collapsible":true,"collapsed":true,"items":[{"type":"link","label":"Getting Started with Podman Desktop","href":"/docs/getting-started/getting-started","docId":"getting-started/getting-started"}]},{"type":"link","label":"Troubleshooting","href":"/docs/troubleshooting","docId":"troubleshooting"},{"type":"category","label":"compose","collapsible":true,"collapsed":true,"items":[{"type":"link","label":"Using Podman Compose with Podman Desktop","href":"/docs/compose/podman-compose","docId":"compose/podman-compose"}]}]},"docs":{"compose/podman-compose":{"id":"compose/podman-compose","title":"Using Podman Compose with Podman Desktop","description":"Introduction","sidebar":"tutorialSidebar"},"getting-started/getting-started":{"id":"getting-started/getting-started","title":"Getting Started with Podman Desktop","description":"This blog will help you build and run your first container image on Podman Desktop","sidebar":"tutorialSidebar"},"Installation/index":{"id":"Installation/index","title":"Installation Guide for Podman Desktop","description":"Welcome to the Installation Guide for Podman Desktop!","sidebar":"tutorialSidebar"},"Installation/linux-install":{"id":"Installation/linux-install","title":"Linux","description":"Check out the Downloads section of this website to download either the .flatpak file or the zip file depending on your preference.","sidebar":"tutorialSidebar"},"Installation/macos-install":{"id":"Installation/macos-install","title":"MacOS","description":"This page contains information regarding installation of Podman Desktop on MacOS.","sidebar":"tutorialSidebar"},"Installation/windows-install":{"id":"Installation/windows-install","title":"Windows","description":"This page contains information regarding installation of Podman Desktop on Windows.","sidebar":"tutorialSidebar"},"intro":{"id":"intro","title":"Introduction","description":"Let\'s discover Podman Desktop in less than 5 minutes.","sidebar":"tutorialSidebar"},"troubleshooting":{"id":"troubleshooting","title":"Troubleshooting","description":"Here, find some answers to the question : I have downloaded Podman Desktop but I am unable to see any of my image or container","sidebar":"tutorialSidebar"}}}')}}]); \ No newline at end of file +"use strict";(self.webpackChunkdocs=self.webpackChunkdocs||[]).push([[53],{1109:t=>{t.exports=JSON.parse('{"pluginId":"default","version":"current","label":"Next","banner":null,"badge":false,"noIndex":false,"className":"docs-version-current","isLast":true,"docsSidebars":{"tutorialSidebar":[{"type":"link","label":"Introduction","href":"/docs/intro","docId":"intro"},{"type":"category","label":"Installation","collapsible":true,"collapsed":true,"items":[{"type":"link","label":"MacOS","href":"/docs/Installation/macos-install","docId":"Installation/macos-install"},{"type":"link","label":"Windows","href":"/docs/Installation/windows-install","docId":"Installation/windows-install"},{"type":"link","label":"Linux","href":"/docs/Installation/linux-install","docId":"Installation/linux-install"}],"href":"/docs/Installation/"},{"type":"category","label":"Getting Started","collapsible":true,"collapsed":true,"items":[{"type":"link","label":"Getting Started with Podman Desktop","href":"/docs/getting-started/getting-started","docId":"getting-started/getting-started"}]},{"type":"link","label":"Troubleshooting","href":"/docs/troubleshooting","docId":"troubleshooting"},{"type":"category","label":"compose","collapsible":true,"collapsed":true,"items":[{"type":"link","label":"Using Podman Compose with Podman Desktop","href":"/docs/compose/podman-compose","docId":"compose/podman-compose"}]}]},"docs":{"compose/podman-compose":{"id":"compose/podman-compose","title":"Using Podman Compose with Podman Desktop","description":"Introduction","sidebar":"tutorialSidebar"},"getting-started/getting-started":{"id":"getting-started/getting-started","title":"Getting Started with Podman Desktop","description":"This blog will help you build and run your first container image on Podman Desktop","sidebar":"tutorialSidebar"},"Installation/index":{"id":"Installation/index","title":"Installation Guide for Podman Desktop","description":"Welcome to the Installation Guide for Podman Desktop!","sidebar":"tutorialSidebar"},"Installation/linux-install":{"id":"Installation/linux-install","title":"Linux","description":"Check out the Downloads section of this website to download either the .flatpak file or the zip file depending on your preference.","sidebar":"tutorialSidebar"},"Installation/macos-install":{"id":"Installation/macos-install","title":"MacOS","description":"This page contains information regarding installation of Podman Desktop on MacOS.","sidebar":"tutorialSidebar"},"Installation/windows-install":{"id":"Installation/windows-install","title":"Windows","description":"This page contains information regarding installation of Podman Desktop on Windows.","sidebar":"tutorialSidebar"},"intro":{"id":"intro","title":"Introduction","description":"Let\'s discover Podman Desktop in less than 5 minutes.","sidebar":"tutorialSidebar"},"troubleshooting":{"id":"troubleshooting","title":"Troubleshooting","description":"If you cannot find your issue here or in the documentation, please fill an issue on our repository. You can also explore the discussions and do a search on similar issues on the repository.","sidebar":"tutorialSidebar"}}}')}}]); \ No newline at end of file diff --git a/assets/js/9d9f8394.157f76b8.js b/assets/js/9d9f8394.157f76b8.js new file mode 100644 index 00000000000..6c753bc23b7 --- /dev/null +++ b/assets/js/9d9f8394.157f76b8.js @@ -0,0 +1 @@ +"use strict";(self.webpackChunkdocs=self.webpackChunkdocs||[]).push([[360],{5318:(e,n,t)=>{t.d(n,{Zo:()=>u,kt:()=>m});var o=t(7378);function a(e,n,t){return n in e?Object.defineProperty(e,n,{value:t,enumerable:!0,configurable:!0,writable:!0}):e[n]=t,e}function i(e,n){var t=Object.keys(e);if(Object.getOwnPropertySymbols){var o=Object.getOwnPropertySymbols(e);n&&(o=o.filter((function(n){return Object.getOwnPropertyDescriptor(e,n).enumerable}))),t.push.apply(t,o)}return t}function r(e){for(var n=1;n=0||(a[t]=e[t]);return a}(e,n);if(Object.getOwnPropertySymbols){var i=Object.getOwnPropertySymbols(e);for(o=0;o=0||Object.prototype.propertyIsEnumerable.call(e,t)&&(a[t]=e[t])}return a}var l=o.createContext({}),p=function(e){var n=o.useContext(l),t=n;return e&&(t="function"==typeof e?e(n):r(r({},n),e)),t},u=function(e){var n=p(e.components);return o.createElement(l.Provider,{value:n},e.children)},d={inlineCode:"code",wrapper:function(e){var n=e.children;return o.createElement(o.Fragment,{},n)}},c=o.forwardRef((function(e,n){var t=e.components,a=e.mdxType,i=e.originalType,l=e.parentName,u=s(e,["components","mdxType","originalType","parentName"]),c=p(t),m=a,h=c["".concat(l,".").concat(m)]||c[m]||d[m]||i;return t?o.createElement(h,r(r({ref:n},u),{},{components:t})):o.createElement(h,r({ref:n},u))}));function m(e,n){var t=arguments,a=n&&n.mdxType;if("string"==typeof e||a){var i=t.length,r=new Array(i);r[0]=c;var s={};for(var l in n)hasOwnProperty.call(n,l)&&(s[l]=n[l]);s.originalType=e,s.mdxType="string"==typeof e?e:a,r[1]=s;for(var p=2;p{t.r(n),t.d(n,{assets:()=>l,contentTitle:()=>r,default:()=>d,frontMatter:()=>i,metadata:()=>s,toc:()=>p});var o=t(2685),a=(t(7378),t(5318));const i={sidebar_position:4},r="Troubleshooting",s={unversionedId:"troubleshooting",id:"troubleshooting",title:"Troubleshooting",description:"If you cannot find your issue here or in the documentation, please fill an issue on our repository. You can also explore the discussions and do a search on similar issues on the repository.",source:"@site/docs/troubleshooting.md",sourceDirName:".",slug:"/troubleshooting",permalink:"/docs/troubleshooting",draft:!1,editUrl:"https://github.com/containers/podman-desktop/tree/main/website/docs/troubleshooting.md",tags:[],version:"current",sidebarPosition:4,frontMatter:{sidebar_position:4},sidebar:"tutorialSidebar",previous:{title:"Getting Started with Podman Desktop",permalink:"/docs/getting-started/getting-started"},next:{title:"Using Podman Compose with Podman Desktop",permalink:"/docs/compose/podman-compose"}},l={},p=[{value:"Podman Issues",id:"podman-issues",level:2},{value:"Unable to see any image or container after downloading Podman Desktop",id:"unable-to-see-any-image-or-container-after-downloading-podman-desktop",level:3},{value:"System Requirements",id:"system-requirements",level:4},{value:"Check connection",id:"check-connection",level:4},{value:"Unable to locate Podman Engine",id:"unable-to-locate-podman-engine",level:3},{value:"Issue:",id:"issue",level:4},{value:"Explanation:",id:"explanation",level:4},{value:"Solution:",id:"solution",level:4},{value:"Unable to see information about active containers",id:"unable-to-see-information-about-active-containers",level:3},{value:"Issue:",id:"issue-1",level:4},{value:"Solution:",id:"solution-1",level:4},{value:"Code Ready Containers",id:"code-ready-containers",level:2},{value:"Other Issues",id:"other-issues",level:2},{value:"Fixing corrupted Podman Machine in Windows",id:"fixing-corrupted-podman-machine-in-windows",level:3}],u={toc:p};function d(e){let{components:n,...i}=e;return(0,a.kt)("wrapper",(0,o.Z)({},u,i,{components:n,mdxType:"MDXLayout"}),(0,a.kt)("h1",{id:"troubleshooting"},"Troubleshooting"),(0,a.kt)("p",null,"If you cannot find your issue here or in the documentation, please fill an issue on our ",(0,a.kt)("a",{parentName:"p",href:"https://github.com/containers/podman-desktop/issues"},"repository"),". You can also explore the ",(0,a.kt)("a",{parentName:"p",href:"https://github.com/containers/podman-desktop/discussions"},"discussions")," and do a search on similar issues on the ",(0,a.kt)("a",{parentName:"p",href:"https://github.com/containers/podman-desktop/issues"},"repository"),"."),(0,a.kt)("h2",{id:"podman-issues"},"Podman Issues"),(0,a.kt)("h3",{id:"unable-to-see-any-image-or-container-after-downloading-podman-desktop"},"Unable to see any image or container after downloading Podman Desktop"),(0,a.kt)("h4",{id:"system-requirements"},"System Requirements"),(0,a.kt)("p",null,"The tool connects to Podman using the socket on the host on macOS and on a named pipe on Windows. This is available only on podman 4.0.2+\nSo, please check your version and update."),(0,a.kt)("p",null,"On Windows, the named pipe is ",(0,a.kt)("inlineCode",{parentName:"p"},"//./pipe/docker_engine")," when Docker Desktop is not installed. It will be solved by ",(0,a.kt)("a",{parentName:"p",href:"https://github.com/containers/podman/issues/13502"},"https://github.com/containers/podman/issues/13502")," / ",(0,a.kt)("a",{parentName:"p",href:"https://github.com/containers/podman/pull/13655"},"https://github.com/containers/podman/pull/13655"),". During that time, you may start Docker Desktop so the named pipe is the one expected."),(0,a.kt)("h4",{id:"check-connection"},"Check connection"),(0,a.kt)("p",null,"Check at least a podman machine is running on Windows & macOS:"),(0,a.kt)("pre",null,(0,a.kt)("code",{parentName:"pre",className:"language-bash"},"podman machine list\n")),(0,a.kt)("p",null,"And check a connection can be made with the CLI"),(0,a.kt)("pre",null,(0,a.kt)("code",{parentName:"pre",className:"language-sh"},'$ podman run quay.io/podman/hello\n!... Hello Podman World ...!\n\n .--"--.\n / - - \\\n / (O) (O) \\\n ~~~| -=(,Y,)=- |\n .---. /` \\ |~~\n ~/ o o \\~~~~.----. ~~\n | =(X)= |~ / (O (O) \\\n ~~~~~~~ ~| =(Y_)=- |\n ~~~~ ~~~| U |~~\n\nProject: https://github.com/containers/podman\nWebsite: https://podman.io\nDocuments: https://docs.podman.io\nTwitter: @Podman_io\n')),(0,a.kt)("h3",{id:"unable-to-locate-podman-engine"},"Unable to locate Podman Engine"),(0,a.kt)("h4",{id:"issue"},"Issue:"),(0,a.kt)("p",null,"Despite having Podman Engine installed, you may receive an error as follows -\n",(0,a.kt)("inlineCode",{parentName:"p"},"Error: No such keg: /usr/local/Cellar/podman"),"\nor any similar error denoting that Podman Engine does not exist. "),(0,a.kt)("h4",{id:"explanation"},"Explanation:"),(0,a.kt)("p",null,"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 ",(0,a.kt)("inlineCode",{parentName:"p"},"/opt/podman")," whereas Homebrew uses the path ",(0,a.kt)("inlineCode",{parentName:"p"},"/usr/local")," for macOS Intel, ",(0,a.kt)("inlineCode",{parentName:"p"},"/opt/homebrew")," for Apple Silicon and ",(0,a.kt)("inlineCode",{parentName:"p"},"/home/linuxbrew/.linuxbrew")," for Linux."),(0,a.kt)("h4",{id:"solution"},"Solution:"),(0,a.kt)("p",null,"To check where exactly is your Podman Engine installed, run the command-"),(0,a.kt)("pre",null,(0,a.kt)("code",{parentName:"pre",className:"language-sh"},"which podman\n")),(0,a.kt)("p",null,"This returns the path where the Podman Engine would be installed. This would help determine further action. "),(0,a.kt)("p",null,"For example, if you\u2019re looking to completely uninstall Podman Engine from your system for a fresh installation, running ",(0,a.kt)("inlineCode",{parentName:"p"},"which podman")," returns the exact path where Podman still exists. This could be the path where Podman Installer stores Podman Engine i.e. ",(0,a.kt)("inlineCode",{parentName:"p"},"/opt/podman"),". Once you know the path, simply run-"),(0,a.kt)("pre",null,(0,a.kt)("code",{parentName:"pre",className:"language-sh"},"sudo rm -rf /opt/podman\n")),(0,a.kt)("p",null,"Or "),(0,a.kt)("pre",null,(0,a.kt)("code",{parentName:"pre",className:"language-sh"},"sudo rm -rf path-where-podman-exists\n")),(0,a.kt)("p",null,"Here, you would replace ",(0,a.kt)("inlineCode",{parentName:"p"},"path-where-podman-exists")," with the output of ",(0,a.kt)("inlineCode",{parentName:"p"},"which podman"),"."),(0,a.kt)("p",null,"You can now proceed for a fresh installation of Podman Desktop"),(0,a.kt)("h3",{id:"unable-to-see-information-about-active-containers"},"Unable to see information about active containers"),(0,a.kt)("h4",{id:"issue-1"},"Issue:"),(0,a.kt)("p",null,'In this scenario, the screen may be displaying "No Containers" as shown below despite active containers runnning in the background.\n',(0,a.kt)("img",{alt:"img",src:t(9590).Z,width:"2880",height:"1800"})),(0,a.kt)("h4",{id:"solution-1"},"Solution:"),(0,a.kt)("p",null,"There are three ways to work this out."),(0,a.kt)("ol",null,(0,a.kt)("li",{parentName:"ol"},"To solve this issue, open the Terminal and run the following commands- ")),(0,a.kt)("pre",null,(0,a.kt)("code",{parentName:"pre",className:"language-sh"},"podman machine stop\n")),(0,a.kt)("p",null,"and then,"),(0,a.kt)("pre",null,(0,a.kt)("code",{parentName:"pre",className:"language-sh"},"podman machine start\n")),(0,a.kt)("ol",{start:2},(0,a.kt)("li",{parentName:"ol"},"If this does not work for you, you may proceed with the following commands-")),(0,a.kt)("pre",null,(0,a.kt)("code",{parentName:"pre",className:"language-sh"},"podman machine rm\n")),(0,a.kt)("p",null,"and then,"),(0,a.kt)("pre",null,(0,a.kt)("code",{parentName:"pre",className:"language-sh"},"podman machine init\n")),(0,a.kt)("ol",{start:3},(0,a.kt)("li",{parentName:"ol"},"If both of the abovementioned steps don't work for you, run the following commands-")),(0,a.kt)("pre",null,(0,a.kt)("code",{parentName:"pre",className:"language-sh"},"rm -rf ~/.local/share/containers/podman\n")),(0,a.kt)("p",null,"and then,"),(0,a.kt)("pre",null,(0,a.kt)("code",{parentName:"pre",className:"language-sh"},"rm -rf ~/.config/containers/\n")),(0,a.kt)("p",null,"After this, you can start off again by initializing a new Podman Machine and loading up the containers."),(0,a.kt)("h2",{id:"code-ready-containers"},"Code Ready Containers"),(0,a.kt)("ul",null,(0,a.kt)("li",{parentName:"ul"},"Check that podman preset is defined. (",(0,a.kt)("inlineCode",{parentName:"li"},"crc config get preset"),")"),(0,a.kt)("li",{parentName:"ul"},"Check that ",(0,a.kt)("inlineCode",{parentName:"li"},"crc")," binary is available in the user PATH (",(0,a.kt)("inlineCode",{parentName:"li"},"/usr/local/bin/crc"),")"),(0,a.kt)("li",{parentName:"ul"},"Check that ",(0,a.kt)("inlineCode",{parentName:"li"},"crc setup --check-only")," is running without errors.")),(0,a.kt)("h2",{id:"other-issues"},"Other Issues"),(0,a.kt)("h3",{id:"fixing-corrupted-podman-machine-in-windows"},"Fixing corrupted Podman Machine in Windows"),(0,a.kt)("p",null,"If at all you are not able to stop your Podman Machine, you will find such an error in the Logs-\n",(0,a.kt)("inlineCode",{parentName:"p"},"Error: Error stopping sysd: exit status 1")),(0,a.kt)("p",null,"It is highly unlikely that you may be stuck in such a situation but if you are, here's a quick fix for it."),(0,a.kt)("p",null,"Assuming the name of the Podman Machine to be ",(0,a.kt)("inlineCode",{parentName:"p"},"my-machine"),", run the following commands in the terminal:"),(0,a.kt)("pre",null,(0,a.kt)("code",{parentName:"pre",className:"language-sh"},"wsl --list\n")),(0,a.kt)("p",null,"This shall display a list of active distributions i.e. ",(0,a.kt)("inlineCode",{parentName:"p"},"my-machine")," in this case."),(0,a.kt)("p",null,"Then,"),(0,a.kt)("pre",null,(0,a.kt)("code",{parentName:"pre",className:"language-sh"},"wsl --unregister my-machine\n")),(0,a.kt)("p",null,"(Replacing ",(0,a.kt)("inlineCode",{parentName:"p"},"my-machine")," with the name that is displayed under ",(0,a.kt)("inlineCode",{parentName:"p"},"wsl --list")," for your Podman Machine)"),(0,a.kt)("p",null,"This will stop the Podman Machine for you."))}d.isMDXComponent=!0},9590:(e,n,t)=>{t.d(n,{Z:()=>o});const o=t.p+"assets/images/containers_error-2ddfc1139b9345ae8d06c597551608ad.png"}}]); \ No newline at end of file diff --git a/assets/js/9d9f8394.4e263008.js b/assets/js/9d9f8394.4e263008.js deleted file mode 100644 index 81bb25bee95..00000000000 --- a/assets/js/9d9f8394.4e263008.js +++ /dev/null @@ -1 +0,0 @@ -"use strict";(self.webpackChunkdocs=self.webpackChunkdocs||[]).push([[360],{5318:(e,n,t)=>{t.d(n,{Zo:()=>p,kt:()=>m});var o=t(7378);function a(e,n,t){return n in e?Object.defineProperty(e,n,{value:t,enumerable:!0,configurable:!0,writable:!0}):e[n]=t,e}function i(e,n){var t=Object.keys(e);if(Object.getOwnPropertySymbols){var o=Object.getOwnPropertySymbols(e);n&&(o=o.filter((function(n){return Object.getOwnPropertyDescriptor(e,n).enumerable}))),t.push.apply(t,o)}return t}function r(e){for(var n=1;n=0||(a[t]=e[t]);return a}(e,n);if(Object.getOwnPropertySymbols){var i=Object.getOwnPropertySymbols(e);for(o=0;o=0||Object.prototype.propertyIsEnumerable.call(e,t)&&(a[t]=e[t])}return a}var l=o.createContext({}),c=function(e){var n=o.useContext(l),t=n;return e&&(t="function"==typeof e?e(n):r(r({},n),e)),t},p=function(e){var n=c(e.components);return o.createElement(l.Provider,{value:n},e.children)},d={inlineCode:"code",wrapper:function(e){var n=e.children;return o.createElement(o.Fragment,{},n)}},u=o.forwardRef((function(e,n){var t=e.components,a=e.mdxType,i=e.originalType,l=e.parentName,p=s(e,["components","mdxType","originalType","parentName"]),u=c(t),m=a,h=u["".concat(l,".").concat(m)]||u[m]||d[m]||i;return t?o.createElement(h,r(r({ref:n},p),{},{components:t})):o.createElement(h,r({ref:n},p))}));function m(e,n){var t=arguments,a=n&&n.mdxType;if("string"==typeof e||a){var i=t.length,r=new Array(i);r[0]=u;var s={};for(var l in n)hasOwnProperty.call(n,l)&&(s[l]=n[l]);s.originalType=e,s.mdxType="string"==typeof e?e:a,r[1]=s;for(var c=2;c{t.r(n),t.d(n,{assets:()=>l,contentTitle:()=>r,default:()=>d,frontMatter:()=>i,metadata:()=>s,toc:()=>c});var o=t(2685),a=(t(7378),t(5318));const i={sidebar_position:4},r="Troubleshooting",s={unversionedId:"troubleshooting",id:"troubleshooting",title:"Troubleshooting",description:"Here, find some answers to the question : I have downloaded Podman Desktop but I am unable to see any of my image or container",source:"@site/docs/troubleshooting.md",sourceDirName:".",slug:"/troubleshooting",permalink:"/docs/troubleshooting",draft:!1,editUrl:"https://github.com/containers/podman-desktop/tree/main/website/docs/troubleshooting.md",tags:[],version:"current",sidebarPosition:4,frontMatter:{sidebar_position:4},sidebar:"tutorialSidebar",previous:{title:"Getting Started with Podman Desktop",permalink:"/docs/getting-started/getting-started"},next:{title:"Using Podman Compose with Podman Desktop",permalink:"/docs/compose/podman-compose"}},l={},c=[{value:"Podman",id:"podman",level:2},{value:"System Requirements",id:"system-requirements",level:3},{value:"Check connection",id:"check-connection",level:3},{value:"Fixing corrupted Podman Machine in Windows",id:"fixing-corrupted-podman-machine-in-windows",level:3},{value:"Code Ready Containers",id:"code-ready-containers",level:2}],p={toc:c};function d(e){let{components:n,...t}=e;return(0,a.kt)("wrapper",(0,o.Z)({},p,t,{components:n,mdxType:"MDXLayout"}),(0,a.kt)("h1",{id:"troubleshooting"},"Troubleshooting"),(0,a.kt)("p",null,"Here, find some answers to the question : I have downloaded Podman Desktop but I am unable to see any of my image or container"),(0,a.kt)("h2",{id:"podman"},"Podman"),(0,a.kt)("h3",{id:"system-requirements"},"System Requirements"),(0,a.kt)("p",null,"The tool connects to Podman using the socket on the host on macOS and on a named pipe on Windows. This is available only on podman 4.0.2+\nSo, please check your version and update."),(0,a.kt)("p",null,"On Windows, the named pipe is ",(0,a.kt)("inlineCode",{parentName:"p"},"//./pipe/docker_engine")," when Docker Desktop is not installed. It will be solved by ",(0,a.kt)("a",{parentName:"p",href:"https://github.com/containers/podman/issues/13502"},"https://github.com/containers/podman/issues/13502")," / ",(0,a.kt)("a",{parentName:"p",href:"https://github.com/containers/podman/pull/13655"},"https://github.com/containers/podman/pull/13655"),". During that time, you may start Docker Desktop so the named pipe is the one expected."),(0,a.kt)("h3",{id:"check-connection"},"Check connection"),(0,a.kt)("p",null,"Check at least a podman machine is running on Windows & macOS:"),(0,a.kt)("pre",null,(0,a.kt)("code",{parentName:"pre",className:"language-bash"},"podman machine list\n")),(0,a.kt)("p",null,"And check a connection can be made with the CLI"),(0,a.kt)("pre",null,(0,a.kt)("code",{parentName:"pre",className:"language-sh"},'$ podman run quay.io/podman/hello\n!... Hello Podman World ...!\n\n .--"--.\n / - - \\\n / (O) (O) \\\n ~~~| -=(,Y,)=- |\n .---. /` \\ |~~\n ~/ o o \\~~~~.----. ~~\n | =(X)= |~ / (O (O) \\\n ~~~~~~~ ~| =(Y_)=- |\n ~~~~ ~~~| U |~~\n\nProject: https://github.com/containers/podman\nWebsite: https://podman.io\nDocuments: https://docs.podman.io\nTwitter: @Podman_io\n')),(0,a.kt)("h3",{id:"fixing-corrupted-podman-machine-in-windows"},"Fixing corrupted Podman Machine in Windows"),(0,a.kt)("p",null,"If at all you are not able to stop your Podman Machine, you will find such an error in the Logs-\n",(0,a.kt)("inlineCode",{parentName:"p"},"Error: Error stopping sysd: exit status 1")),(0,a.kt)("p",null,"It is highly unlikely that you may be stuck in such a situation but if you are, here's a quick fix for it."),(0,a.kt)("p",null,"Assuming the name of the Podman Machine to be ",(0,a.kt)("inlineCode",{parentName:"p"},"my-machine"),", run the following commands in the terminal:"),(0,a.kt)("pre",null,(0,a.kt)("code",{parentName:"pre",className:"language-sh"},"wsl --list\n")),(0,a.kt)("p",null,"This shall display a list of active distributions i.e. ",(0,a.kt)("inlineCode",{parentName:"p"},"my-machine")," in this case."),(0,a.kt)("p",null,"Then,"),(0,a.kt)("pre",null,(0,a.kt)("code",{parentName:"pre",className:"language-sh"},"wsl --unregister my-machine\n")),(0,a.kt)("p",null,"(Replacing ",(0,a.kt)("inlineCode",{parentName:"p"},"my-machine")," with the name that is displayed under ",(0,a.kt)("inlineCode",{parentName:"p"},"wsl --list")," for your Podman Machine)"),(0,a.kt)("p",null,"This will stop the Podman Machine for you."),(0,a.kt)("h2",{id:"code-ready-containers"},"Code Ready Containers"),(0,a.kt)("ul",null,(0,a.kt)("li",{parentName:"ul"},"Check that podman preset is defined. (",(0,a.kt)("inlineCode",{parentName:"li"},"crc config get preset"),")"),(0,a.kt)("li",{parentName:"ul"},"Check that ",(0,a.kt)("inlineCode",{parentName:"li"},"crc")," binary is available in the user PATH (",(0,a.kt)("inlineCode",{parentName:"li"},"/usr/local/bin/crc"),")"),(0,a.kt)("li",{parentName:"ul"},"Check that ",(0,a.kt)("inlineCode",{parentName:"li"},"crc setup --check-only")," is running without errors.")))}d.isMDXComponent=!0}}]); \ No newline at end of file diff --git a/assets/js/runtime~main.c30e8412.js b/assets/js/runtime~main.c30e8412.js deleted file mode 100644 index bd4b69be587..00000000000 --- a/assets/js/runtime~main.c30e8412.js +++ /dev/null @@ -1 +0,0 @@ -(()=>{"use strict";var e,t,r,a,o,d={},f={};function c(e){var t=f[e];if(void 0!==t)return t.exports;var r=f[e]={id:e,loaded:!1,exports:{}};return d[e].call(r.exports,r,r.exports,c),r.loaded=!0,r.exports}c.m=d,c.c=f,e=[],c.O=(t,r,a,o)=>{if(!r){var d=1/0;for(i=0;i=o)&&Object.keys(c.O).every((e=>c.O[e](r[n])))?r.splice(n--,1):(f=!1,o0&&e[i-1][2]>o;i--)e[i]=e[i-1];e[i]=[r,a,o]},c.n=e=>{var t=e&&e.__esModule?()=>e.default:()=>e;return c.d(t,{a:t}),t},r=Object.getPrototypeOf?e=>Object.getPrototypeOf(e):e=>e.__proto__,c.t=function(e,a){if(1&a&&(e=this(e)),8&a)return e;if("object"==typeof e&&e){if(4&a&&e.__esModule)return e;if(16&a&&"function"==typeof e.then)return e}var o=Object.create(null);c.r(o);var d={};t=t||[null,r({}),r([]),r(r)];for(var f=2&a&&e;"object"==typeof f&&!~t.indexOf(f);f=r(f))Object.getOwnPropertyNames(f).forEach((t=>d[t]=()=>e[t]));return d.default=()=>e,c.d(o,d),o},c.d=(e,t)=>{for(var r in t)c.o(t,r)&&!c.o(e,r)&&Object.defineProperty(e,r,{enumerable:!0,get:t[r]})},c.f={},c.e=e=>Promise.all(Object.keys(c.f).reduce(((t,r)=>(c.f[r](e,t),t)),[])),c.u=e=>"assets/js/"+({10:"56c3a9b2",53:"935f2afb",68:"d83d689a",114:"e665718d",121:"55960ee5",130:"ac371aaa",178:"ba322490",181:"4e8ec325",207:"beebaad6",217:"d7fbbe43",237:"1df93b7f",241:"631e3189",248:"6101b3fc",262:"059d1c6a",360:"9d9f8394",397:"6194ac84",505:"8894e90f",514:"1be78505",625:"657ac0bc",671:"0e384e19",673:"499ddca7",724:"5087625a",751:"3720c009",813:"933a69d3",847:"43b416ef",918:"17896441",920:"1a4e3797",924:"df203c0f"}[e]||e)+"."+{10:"a4135d22",53:"90c01eb4",68:"a7a10abb",114:"45b00829",121:"90290ae0",127:"bb0f3ced",130:"834fe528",178:"b8a4111d",181:"6220ecc0",207:"15204ec0",217:"27c5da25",237:"f6ea4f0a",241:"650873c0",248:"6ee5fe48",262:"ebf6228d",360:"4e263008",397:"32fdc436",505:"6a8ae5a3",514:"329b6d74",588:"7ee94330",625:"a5763dad",670:"93f9c767",671:"a891cf43",673:"1fd13755",724:"d9b3850c",751:"0e8fb04c",777:"2fd0ec0d",813:"6025d1c6",847:"b8b8d308",893:"d4ec2257",918:"b87f3556",920:"79111379",924:"060157b3"}[e]+".js",c.miniCssF=e=>{},c.g=function(){if("object"==typeof globalThis)return globalThis;try{return this||new Function("return this")()}catch(e){if("object"==typeof window)return window}}(),c.o=(e,t)=>Object.prototype.hasOwnProperty.call(e,t),a={},o="docs:",c.l=(e,t,r,d)=>{if(a[e])a[e].push(t);else{var f,n;if(void 0!==r)for(var b=document.getElementsByTagName("script"),i=0;i{f.onerror=f.onload=null,clearTimeout(s);var o=a[e];if(delete a[e],f.parentNode&&f.parentNode.removeChild(f),o&&o.forEach((e=>e(r))),t)return t(r)},s=setTimeout(l.bind(null,void 0,{type:"timeout",target:f}),12e4);f.onerror=l.bind(null,f.onerror),f.onload=l.bind(null,f.onload),n&&document.head.appendChild(f)}},c.r=e=>{"undefined"!=typeof Symbol&&Symbol.toStringTag&&Object.defineProperty(e,Symbol.toStringTag,{value:"Module"}),Object.defineProperty(e,"__esModule",{value:!0})},c.p="/",c.gca=function(e){return e={17896441:"918","56c3a9b2":"10","935f2afb":"53",d83d689a:"68",e665718d:"114","55960ee5":"121",ac371aaa:"130",ba322490:"178","4e8ec325":"181",beebaad6:"207",d7fbbe43:"217","1df93b7f":"237","631e3189":"241","6101b3fc":"248","059d1c6a":"262","9d9f8394":"360","6194ac84":"397","8894e90f":"505","1be78505":"514","657ac0bc":"625","0e384e19":"671","499ddca7":"673","5087625a":"724","3720c009":"751","933a69d3":"813","43b416ef":"847","1a4e3797":"920",df203c0f:"924"}[e]||e,c.p+c.u(e)},(()=>{var e={303:0,532:0};c.f.j=(t,r)=>{var a=c.o(e,t)?e[t]:void 0;if(0!==a)if(a)r.push(a[2]);else if(/^(303|532)$/.test(t))e[t]=0;else{var o=new Promise(((r,o)=>a=e[t]=[r,o]));r.push(a[2]=o);var d=c.p+c.u(t),f=new Error;c.l(d,(r=>{if(c.o(e,t)&&(0!==(a=e[t])&&(e[t]=void 0),a)){var o=r&&("load"===r.type?"missing":r.type),d=r&&r.target&&r.target.src;f.message="Loading chunk "+t+" failed.\n("+o+": "+d+")",f.name="ChunkLoadError",f.type=o,f.request=d,a[1](f)}}),"chunk-"+t,t)}},c.O.j=t=>0===e[t];var t=(t,r)=>{var a,o,d=r[0],f=r[1],n=r[2],b=0;if(d.some((t=>0!==e[t]))){for(a in f)c.o(f,a)&&(c.m[a]=f[a]);if(n)var i=n(c)}for(t&&t(r);b{"use strict";var e,t,r,a,o,d={},c={};function f(e){var t=c[e];if(void 0!==t)return t.exports;var r=c[e]={id:e,loaded:!1,exports:{}};return d[e].call(r.exports,r,r.exports,f),r.loaded=!0,r.exports}f.m=d,f.c=c,e=[],f.O=(t,r,a,o)=>{if(!r){var d=1/0;for(i=0;i=o)&&Object.keys(f.O).every((e=>f.O[e](r[n])))?r.splice(n--,1):(c=!1,o0&&e[i-1][2]>o;i--)e[i]=e[i-1];e[i]=[r,a,o]},f.n=e=>{var t=e&&e.__esModule?()=>e.default:()=>e;return f.d(t,{a:t}),t},r=Object.getPrototypeOf?e=>Object.getPrototypeOf(e):e=>e.__proto__,f.t=function(e,a){if(1&a&&(e=this(e)),8&a)return e;if("object"==typeof e&&e){if(4&a&&e.__esModule)return e;if(16&a&&"function"==typeof e.then)return e}var o=Object.create(null);f.r(o);var d={};t=t||[null,r({}),r([]),r(r)];for(var c=2&a&&e;"object"==typeof c&&!~t.indexOf(c);c=r(c))Object.getOwnPropertyNames(c).forEach((t=>d[t]=()=>e[t]));return d.default=()=>e,f.d(o,d),o},f.d=(e,t)=>{for(var r in t)f.o(t,r)&&!f.o(e,r)&&Object.defineProperty(e,r,{enumerable:!0,get:t[r]})},f.f={},f.e=e=>Promise.all(Object.keys(f.f).reduce(((t,r)=>(f.f[r](e,t),t)),[])),f.u=e=>"assets/js/"+({10:"56c3a9b2",53:"935f2afb",68:"d83d689a",114:"e665718d",121:"55960ee5",130:"ac371aaa",178:"ba322490",181:"4e8ec325",207:"beebaad6",217:"d7fbbe43",237:"1df93b7f",241:"631e3189",248:"6101b3fc",262:"059d1c6a",360:"9d9f8394",397:"6194ac84",505:"8894e90f",514:"1be78505",625:"657ac0bc",671:"0e384e19",673:"499ddca7",724:"5087625a",751:"3720c009",813:"933a69d3",847:"43b416ef",918:"17896441",920:"1a4e3797",924:"df203c0f"}[e]||e)+"."+{10:"a4135d22",53:"350537f8",68:"a7a10abb",114:"45b00829",121:"90290ae0",127:"bb0f3ced",130:"834fe528",178:"b8a4111d",181:"6220ecc0",207:"15204ec0",217:"27c5da25",237:"f6ea4f0a",241:"650873c0",248:"6ee5fe48",262:"ebf6228d",360:"157f76b8",397:"32fdc436",505:"6a8ae5a3",514:"329b6d74",588:"7ee94330",625:"a5763dad",670:"93f9c767",671:"a891cf43",673:"1fd13755",724:"d9b3850c",751:"0e8fb04c",777:"2fd0ec0d",813:"6025d1c6",847:"b8b8d308",893:"d4ec2257",918:"b87f3556",920:"79111379",924:"060157b3"}[e]+".js",f.miniCssF=e=>{},f.g=function(){if("object"==typeof globalThis)return globalThis;try{return this||new Function("return this")()}catch(e){if("object"==typeof window)return window}}(),f.o=(e,t)=>Object.prototype.hasOwnProperty.call(e,t),a={},o="docs:",f.l=(e,t,r,d)=>{if(a[e])a[e].push(t);else{var c,n;if(void 0!==r)for(var b=document.getElementsByTagName("script"),i=0;i{c.onerror=c.onload=null,clearTimeout(s);var o=a[e];if(delete a[e],c.parentNode&&c.parentNode.removeChild(c),o&&o.forEach((e=>e(r))),t)return t(r)},s=setTimeout(l.bind(null,void 0,{type:"timeout",target:c}),12e4);c.onerror=l.bind(null,c.onerror),c.onload=l.bind(null,c.onload),n&&document.head.appendChild(c)}},f.r=e=>{"undefined"!=typeof Symbol&&Symbol.toStringTag&&Object.defineProperty(e,Symbol.toStringTag,{value:"Module"}),Object.defineProperty(e,"__esModule",{value:!0})},f.p="/",f.gca=function(e){return e={17896441:"918","56c3a9b2":"10","935f2afb":"53",d83d689a:"68",e665718d:"114","55960ee5":"121",ac371aaa:"130",ba322490:"178","4e8ec325":"181",beebaad6:"207",d7fbbe43:"217","1df93b7f":"237","631e3189":"241","6101b3fc":"248","059d1c6a":"262","9d9f8394":"360","6194ac84":"397","8894e90f":"505","1be78505":"514","657ac0bc":"625","0e384e19":"671","499ddca7":"673","5087625a":"724","3720c009":"751","933a69d3":"813","43b416ef":"847","1a4e3797":"920",df203c0f:"924"}[e]||e,f.p+f.u(e)},(()=>{var e={303:0,532:0};f.f.j=(t,r)=>{var a=f.o(e,t)?e[t]:void 0;if(0!==a)if(a)r.push(a[2]);else if(/^(303|532)$/.test(t))e[t]=0;else{var o=new Promise(((r,o)=>a=e[t]=[r,o]));r.push(a[2]=o);var d=f.p+f.u(t),c=new Error;f.l(d,(r=>{if(f.o(e,t)&&(0!==(a=e[t])&&(e[t]=void 0),a)){var o=r&&("load"===r.type?"missing":r.type),d=r&&r.target&&r.target.src;c.message="Loading chunk "+t+" failed.\n("+o+": "+d+")",c.name="ChunkLoadError",c.type=o,c.request=d,a[1](c)}}),"chunk-"+t,t)}},f.O.j=t=>0===e[t];var t=(t,r)=>{var a,o,d=r[0],c=r[1],n=r[2],b=0;if(d.some((t=>0!==e[t]))){for(a in c)f.o(c,a)&&(f.m[a]=c[a]);if(n)var i=n(f)}for(t&&t(r);b Podman Desktop | Podman Desktop - +

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 4591ccea9d1..8d964dd8dd8 100644 --- a/docs/Installation.html +++ b/docs/Installation.html @@ -4,13 +4,13 @@ Installation Guide for Podman Desktop | Podman Desktop - +

Installation Guide for Podman Desktop

Welcome to the Installation Guide for Podman Desktop!

Podman Desktop is available across Windows, MacOS and Linux. This section of documentation intends to help you install the latest version of Podman Desktop on your Operating System. The links to installation guide for different platforms are listed below.

  1. MacOS
  2. Windows
  3. Linux
- + \ No newline at end of file diff --git a/docs/Installation/linux-install.html b/docs/Installation/linux-install.html index 11753b43c54..fddbe6058f9 100644 --- a/docs/Installation/linux-install.html +++ b/docs/Installation/linux-install.html @@ -4,13 +4,13 @@ Linux | Podman Desktop - +

Linux

Check out the Downloads section of this website to download either the .flatpak file or the zip file depending on your preference.

In order to use Podman Desktop, the latest version of Podman is required. Podman is a rootless, daemonless container engine. Read more about it here.

Installing Podman Desktop​

1. Using FlatHub​

With FlatHub, you can install Podman Desktop with just a single command.

Follow the setup guide before installing Podman Desktop

flatpak install --user flathub io.podman_desktop.PodmanDesktop

After installation, to open Podman Desktop, use the following command:

flatpak run io.podman_desktop.PodmanDesktop

2. Using Flatpak application from Downloads​

Prerequisite

Make sure Flatpak is set up in your distribution. Click here to learn more about setting up Flatpak.

Open the Terminal and go to Downloads directory. 

cd Downloads

The Flatpak identifier for the application is io.podman_desktop.PodmanDesktop. This is required to install & start the application using Flatpak.

Run the following command to install the Flatpak application,

flatpak install io.podman_desktop.PodmanDesktop

Run the following command to start the application,

flatpak run io.podman_desktop.PodmanDesktop

You can read more about running Flatpak applications here.

3. Using zip file​

Download the zip file and extract the folder.

Navigate within the folder and double-click on the podman-desktop executable file. This should start the application for you.

Next Steps​

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

- + \ No newline at end of file diff --git a/docs/Installation/macos-install.html b/docs/Installation/macos-install.html index 3e973ce06a7..c53c5e060cb 100644 --- a/docs/Installation/macos-install.html +++ b/docs/Installation/macos-install.html @@ -4,14 +4,14 @@ MacOS | Podman Desktop - +

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 (i.e. Intel or Apple M1).

2. Locate the downloaded file and 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

Click on the "Install" button next to the "View detection checks" button, and follow the instructions on screen. You will be redirected to the Podman Installer. Follow the instructions on screen and enter your system password when asked.

img4

After installation is complete, close the installer. 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 bf8269b0f57..3f58d95ce58 100644 --- a/docs/Installation/windows-install.html +++ b/docs/Installation/windows-install.html @@ -4,13 +4,13 @@ Windows | Podman Desktop - +

Windows

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

Prerequisites:

NOTE: Administrator access is required for both these prerequisites.

  1. Hyper-V should be enabled
  2. Windows Subsystem for Linux v2 (WSL2) should be installed.

Installing Podman Desktop on Windows​

a. Using .exe file from Downloads​

1. Download the latest .exe file from the Downloads section of this website.

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

img0

b. Using Chocolatey package manager for Windows​

1. Using the installation guide here, install Chocolatey Package Manager.

2. To install Podman Desktop, run the following command from the command line or from PowerShell:

choco install podman-desktop

Read more about Podman Desktop on Chocolatey here.

c. Using Winget package manager for Windows​

1. Get the Winget Package manager for Windows by clicking here.

2. To install Podman Desktop, run the following command from the command line or from PowerShell:

winget install -e --id RedHat.Podman-Desktop

d. Using Scoop package manager for Windows​

1. Using the installation guide here, install Scoop Package Manager.

2. To install Podman Desktop, run the following commands from the command line or from PowerShell:

scoop bucket add extras
scoop install podman-desktop

Setting up Podman Desktop on Windows​

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

When you open Podman Desktop, your home screen would look like the one in the image below if you don't have Podman (Engine) installed.

img1

a. To install Podman, click on the Install button on the home screen. This will check for all the requirements for installation of Podman Engine.

img2

b. If you do not have WSL2 installed, follow the instructions here to install the same.

c. Once all the requirements are met, Podman Desktop will ask you to allow installation of Podman (Engine). Click on Yes to continue.

img3

2. Once installation is completed, you are ready to use Podman Desktop.

After the installation of Podman Engine, your home screen would like the one in the image below.

img4

If the screen says Podman is installed but not ready, it means that installation of Podman Engine has been completed but a Podman Machine has not been initialized.

Next Steps​

You can learn more about initializing a Podman Machine and working with Podman Desktop in our Getting Started guide.

- + \ No newline at end of file diff --git a/docs/compose/podman-compose.html b/docs/compose/podman-compose.html index c1bdc23f992..b56c50c78e3 100644 --- a/docs/compose/podman-compose.html +++ b/docs/compose/podman-compose.html @@ -4,13 +4,13 @@ Using Podman Compose with Podman Desktop | Podman Desktop - +

Using Podman Compose with Podman Desktop

Introduction​

Podman Desktop is aimed at providing an amazing graphical experience of managing your containers. Developers who have worked on containers may also be fans of the Compose Spec.

Podman Compose is a community-driven tool that allows developers to run multiple containers at the same time and facilitate communication between them. Podman Compose requires a Compose YAML file with definitions about the containers that need to communicate.

If you are new to writing Compose files or Compose Spec, check out this guide for more information.

Requirements​

1. Podman Desktop​

Get the latest version of Podman Desktop by clicking here. Refer to the installation guide for more information.

2. Podman Compose​

Get Started​

In this tutorial, we will learn about working with containers on Podman Desktop generated using podman-compose. You can find more information about Podman Compose here.

1. Install Podman Compose​

For macOS​

There are many ways to install podman-compose on your macOS system. One of the easier ways is to use Homebrew. To install podman-compose, simply run the following command

brew install podman-compose

To ensure podman-compose is properly installed, run the command: 

podman-compose

and it will return more information about its usage.

For Windows and Linux​

Refer the official installation guide to get the latest version of Podman Compose on your Windows or Linux system.

2. Using Podman Compose to run multiple containers​

For this tutorial, we will use the flask-redis project from the awesome-compose repository. This repository consists of many sample projects for you to get started with Podman Compose.

  1. Open your Terminal window
  2. Change to the project directory 
cd flask-redis
  1. Run the following command 
podman-compose -f compose.yaml up -d

The compose.yaml file contains definitions for multiple containers within the flask-redis project.

img1

3. Manage Compose with Podman Desktop​

In order to check if the containers are running as expected, open Podman Desktop and click on the ‘Containers’ option on the left side of the application. You will notice that the containers are bundled together under a Pod named flask-redis (compose) in this case. Here, the compose within the bracket indicates that it is generated from a Compose YAML file.

img2

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 check if the application is running as expected.

img3

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

img4

Conclusion​

That is it. This is how you can use Podman Desktop for your containers generated through podman-compose. It will be really exciting to see you all developers leverage these compatibilities to build exciting applications using Podman Desktop!

- + \ No newline at end of file diff --git a/docs/getting-started/getting-started.html b/docs/getting-started/getting-started.html index 49a3bd3f03c..050ad26be6e 100644 --- a/docs/getting-started/getting-started.html +++ b/docs/getting-started/getting-started.html @@ -4,13 +4,13 @@ Getting Started with Podman Desktop | Podman Desktop - +

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​

In order 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) In order 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 in order 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, I will 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 77e197cc4ce..ab4adf43bb7 100644 --- a/docs/intro.html +++ b/docs/intro.html @@ -4,13 +4,13 @@ Introduction | Podman Desktop - +

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/tags.html b/docs/tags.html index 1720c0c4264..7db8efcbd8f 100644 --- a/docs/tags.html +++ b/docs/tags.html @@ -4,13 +4,13 @@ Tags | Podman Desktop - +
- + \ No newline at end of file diff --git a/docs/tags/getting-started.html b/docs/tags/getting-started.html index 36977e65e35..e3bf89ecd66 100644 --- a/docs/tags/getting-started.html +++ b/docs/tags/getting-started.html @@ -4,13 +4,13 @@ One doc tagged with "getting-started" | Podman Desktop - +

One doc tagged with "getting-started"

View All Tags
- + \ No newline at end of file diff --git a/docs/tags/podman-desktop.html b/docs/tags/podman-desktop.html index 0f84744cad8..ed2a4195f7b 100644 --- a/docs/tags/podman-desktop.html +++ b/docs/tags/podman-desktop.html @@ -4,13 +4,13 @@ One doc tagged with "podman-desktop" | Podman Desktop - +

One doc tagged with "podman-desktop"

View All Tags
- + \ No newline at end of file diff --git a/docs/troubleshooting.html b/docs/troubleshooting.html index 9f594169dea..102f95d6a75 100644 --- a/docs/troubleshooting.html +++ b/docs/troubleshooting.html @@ -3,16 +3,19 @@ -Troubleshooting | Podman Desktop - +Troubleshooting | Podman Desktop +
-

Troubleshooting

Here, find some answers to the question : I have downloaded Podman Desktop but I am unable to see any of my image or container

Podman​

System Requirements​

The tool connects to Podman using the socket on the host on macOS and on a named pipe on Windows. This is available only on podman 4.0.2+ -So, please check your version and update.

On Windows, the named pipe is //./pipe/docker_engine when Docker Desktop is not installed. It will be solved by https://github.com/containers/podman/issues/13502 / https://github.com/containers/podman/pull/13655. During that time, you may start Docker Desktop so the named pipe is the one expected.

Check connection​

Check at least a podman machine is running on Windows & macOS:

podman machine list

And check a connection can be made with the CLI

$ 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

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.

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

Troubleshooting

If you cannot find your issue here or in the documentation, please fill an issue on our repository. You can also explore the discussions and do a search on similar issues on the repository.

Podman Issues​

Unable to see any image or container after downloading Podman Desktop​

System Requirements​

The tool connects to Podman using the socket on the host on macOS and on a named pipe on Windows. This is available only on podman 4.0.2+ +So, please check your version and update.

On Windows, the named pipe is //./pipe/docker_engine when Docker Desktop is not installed. It will be solved by https://github.com/containers/podman/issues/13502 / https://github.com/containers/podman/pull/13655. During that time, you may start Docker Desktop so the named pipe is the one expected.

Check connection​

Check at least a podman machine is running on Windows & macOS:

podman machine list

And check a connection can be made with the CLI

$ 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

Unable to locate Podman Engine​

Issue:​

Despite having Podman Engine installed, you may receive an error as follows - +Error: No such keg: /usr/local/Cellar/podman +or any similar error denoting that Podman Engine does not exist.

Explanation:​

The Podman Installer and Homebrew use different locations to store the Podman Engine files in the file system. For example, Podman Installer installs Podman Engine in the path /opt/podman whereas Homebrew uses the path /usr/local for macOS Intel, /opt/homebrew for Apple Silicon and /home/linuxbrew/.linuxbrew for Linux.

Solution:​

To check where exactly is your Podman Engine installed, run the command-

which podman

This returns the path where the Podman Engine would be installed. This would help determine further action.

For example, if you’re looking to completely uninstall Podman Engine from your system for a fresh installation, running which podman returns the exact path where Podman still exists. This could be the path where Podman Installer stores Podman Engine i.e. /opt/podman. Once you know the path, simply 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

and then,

podman machine start
  1. If this does not work for you, you may proceed with the following commands-
podman machine rm

and then,

podman machine init
  1. If both of the abovementioned steps don't work for you, run the following commands-
rm -rf ~/.local/share/containers/podman

and then,

rm -rf ~/.config/containers/

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

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.

+ \ No newline at end of file diff --git a/downloads.html b/downloads.html index c7d4017d723..7309591dd22 100644 --- a/downloads.html +++ b/downloads.html @@ -4,13 +4,13 @@ Podman Desktop | Podman Desktop - +

Downloads

Windows

Podman Desktop for Windows

Download NowWindows *.exe, version
Package managers for Windows:
Windows install 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:
IntelArm

Using Brew? Install in one command:

brew install podman-desktop

Linux

Podman Desktop for Linux

Download NowLinux *.flatpak, version
Other Linux downloads:
Source *.tar.gz

Using FlatHub ? Install in one command:

flatpak install --user flathub io.podman_desktop.PodmanDesktop
- + \ No newline at end of file diff --git a/downloads/linux.html b/downloads/linux.html index eebd17cf141..02c07756e66 100644 --- a/downloads/linux.html +++ b/downloads/linux.html @@ -4,13 +4,13 @@ Podman Desktop | Podman Desktop - +

Linux Downloads

Linux

Podman Desktop for Linux

Download NowLinux *.flatpak, version
Other Linux downloads:
Source *.tar.gz

Using FlatHub ? Install in one command:

flatpak install --user flathub io.podman_desktop.PodmanDesktop
- + \ No newline at end of file diff --git a/downloads/macOS.html b/downloads/macOS.html index b1040621499..e75b88a6ced 100644 --- a/downloads/macOS.html +++ b/downloads/macOS.html @@ -4,13 +4,13 @@ Podman Desktop | Podman Desktop - +

macOS Downloads

macOS

Podman Desktop for macOS

Download NowUniversal *.dmg, version
Other macOS downloads:
IntelArm

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 a57223d7e85..898ee3d137e 100644 --- a/downloads/windows.html +++ b/downloads/windows.html @@ -4,13 +4,13 @@ Podman Desktop | Podman Desktop - +

Windows Downloads

Windows

Podman Desktop for Windows

Download NowWindows *.exe, version
Package managers for Windows:
Windows install 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 7ab91d45347..d88e3b22fb9 100644 --- a/extend.html +++ b/extend.html @@ -4,13 +4,13 @@ Podman Desktop | Podman Desktop - +

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 cede228431e..cc21c9fce40 100644 --- a/features.html +++ b/features.html @@ -4,13 +4,13 @@ Podman Desktop | Podman Desktop - +

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 208c24a291e..b1764181d17 100644 --- a/index.html +++ b/index.html @@ -4,13 +4,13 @@ Leverage Podman with a Desktop App | Podman Desktop - +

Containers and Kubernetes for application developers

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

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 zip

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

Create and "Podify"

Create Pods from existing containers

Create, start, inspect and manage pods

Kubernetes

Play Kubernetes YAML directly with Podman Engine

Generate Kubernetes YAML from pods

Deploy to existing Kubernetes environments

Discover More

Configure

Multiple configuration options

Registries

Manage OCI registries. Add/edit/delete registries.

Proxy

Configure your proxy settings (in progress..).

Resources Utilization

Configure CPU/Memory/Disk of Podman machines (work in progress)

Container Engines

Handle multiple container engines at the same time (Podman, Docker, 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 directly in Podman Desktop

Current Podman Desktop plug-ins: Podman, Docker, Lima and CRC/OpenShift Local.

Reuse Docker Desktop extensionsReuse Docker Desktop extensions
Learn More

update

Install and keep up to date Podman
Work in progress

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!

Coming soon on MacOS.

enterprise

Enterprise ready
Work in progress

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 1c0d9a6ce5a..0e48bd71fa5 100644 --- a/search.html +++ b/search.html @@ -4,13 +4,13 @@ Search the documentation | Podman Desktop - +

Search the documentation

- + \ No newline at end of file