<titledata-rh="true">Running a pod using a container or docker file | Podman Desktop</title><metadata-rh="true"name="viewport"content="width=device-width,initial-scale=1"><metadata-rh="true"name="twitter:card"content="summary_large_image"><metadata-rh="true"property="og:image"content="https://podman-desktop.io/img/banner_podman-desktop.png"><metadata-rh="true"name="twitter:image"content="https://podman-desktop.io/img/banner_podman-desktop.png"><metadata-rh="true"property="og:url"content="https://podman-desktop.io/tutorial/running-a-pod-using-a-container-docker-file"><metadata-rh="true"property="og:locale"content="en"><metadata-rh="true"name="docusaurus_locale"content="en"><metadata-rh="true"name="docsearch:language"content="en"><metadata-rh="true"name="docusaurus_version"content="current"><metadata-rh="true"name="docusaurus_tag"content="docs-tutorial-current"><metadata-rh="true"name="docsearch:version"content="current"><metadata-rh="true"name="docsearch:docusaurus_tag"content="docs-tutorial-current"><metadata-rh="true"property="og:title"content="Running a pod using a container or docker file | Podman Desktop"><metadata-rh="true"name="description"content="Create and run a pod from a container or docker file on your machine."><metadata-rh="true"property="og:description"content="Create and run a pod from a container or docker file on your machine."><metadata-rh="true"name="keywords"content="podman desktop,podman,pod,Containerfile,Dockerfile"><linkdata-rh="true"rel="icon"href="/img/favicon.ico"><linkdata-rh="true"rel="canonical"href="https://podman-desktop.io/tutorial/running-a-pod-using-a-container-docker-file"><linkdata-rh="true"rel="alternate"href="https://podman-desktop.io/tutorial/running-a-pod-using-a-container-docker-file"hreflang="en"><linkdata-rh="true"rel="alternate"href="https://podman-desktop.io/tutorial/running-a-pod-using-a-container-docker-file"hreflang="x-default"><linkdata-rh="true"rel="preconnect"href="https://MR01ANKQ9S-dsn.algolia.net"crossorigin="anonymous"><scriptdata-rh="true"type="application/ld+json">{"@context":"https://schema.org","@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","position":1,"name":"Running a pod using a container or docker file","item":"https://podman-desktop.io/tutorial/running-a-pod-using-a-container-docker-file"}]}</script><linkrel="alternate"type="application/rss+xml"href="/blog/rss.xml"title="Podman Desktop RSS Feed">
<p>Define volumes to configure a persistent storage location. For this, you must set up a host directory and then mount this directory to a container. You can keep your application data intact in your host directory even after your container is stopped or failed.</p>
<p>Define port mapping to create an externally accessible container. For this, you must map a host port with the container port. After this mapping, any requests to port on the host are forwarded to port in the container.</p>
<h2class="anchor anchorTargetStickyNavbar_tleR"id="before-you-begin">Before you begin<ahref="#before-you-begin"class="hash-link"aria-label="Direct link to Before you begin"title="Direct link to Before you begin"translate="no"></a></h2>
<h2class="anchor anchorTargetStickyNavbar_tleR"id="building-an-image">Building an image<ahref="#building-an-image"class="hash-link"aria-label="Direct link to Building an image"title="Direct link to Building an image"translate="no"></a></h2>
<imgdecoding="async"loading="lazy"alt="Create a new container"src="/assets/images/create-a-new-container-c3419d57d22da0359935309ddd5c742c.png"width="1178"height="525"class="img_SS3x"></p>
<liclass="">Containerfile path: Select the path where the container or docker file is placed.</li>
<liclass="">Build context directory: The field automatically picks up the context directory based on the file path.</li>
<liclass="">Image name: Enter the image name, if required.</li>
<liclass="">Build arguments: Pass the required arguments to build the image. This example uses arguments, such as <code>NODE_VERSION</code> and <code>ALPINE_VERSION</code></li>
<liclass="">Platform: Change the platform on which you want to build the image. The default platform is Intel and AMD x86_64 systems.
<imgdecoding="async"loading="lazy"alt="Build an image from a containerfile"src="/assets/images/build-image-from-containerfile-d842ceedd3110ec55205a6e64c2ced86.png"width="1952"height="1260"class="img_SS3x"></li>
<h2class="anchor anchorTargetStickyNavbar_tleR"id="creating-a-container">Creating a container<ahref="#creating-a-container"class="hash-link"aria-label="Direct link to Creating a container"title="Direct link to Creating a container"translate="no"></a></h2>
<p>Click the <strong>Run Image</strong> icon corresponding to the image you want to run. The <strong>Create a container from image page</strong> opens.
<imgdecoding="async"loading="lazy"alt="running an image"src="/assets/images/run-image-8e07bb1386f655e5b2d7730eafe69081.png"width="1952"height="446"class="img_SS3x"></p>
<p>Optional: Configure the basic details of the container:
<imgdecoding="async"loading="lazy"alt="basic details of a container"src="/assets/images/basic-config-container-c935b251ea9a74db43ced66947495630.png"width="2432"height="1224"class="img_SS3x"></p>
<p>Optional: Select the <strong>Advanced</strong> tab to configure advanced details of the container:
<imgdecoding="async"loading="lazy"alt="advanced details of a container"src="/assets/images/advanced-config-container-563bf8a672ec90dc564ad1efb2208a5d.png"width="2432"height="1224"class="img_SS3x"></p>
<p>Optional: Select the <strong>Networking</strong> tab to configure the networking details of the container:
<imgdecoding="async"loading="lazy"alt="networking details of a container"src="/assets/images/networking-config-container-29f121b925232c90f2124a1ddcd2f830.png"width="2432"height="1224"class="img_SS3x"></p>
<p>Optional: Select the <strong>Security</strong> tab to configure the security details of the container:
<imgdecoding="async"loading="lazy"alt="security details of a container"src="/assets/images/security-config-container-6355b3f3990f8db753ad03df3f7c33d2.png"width="2432"height="1224"class="img_SS3x"></p>
<h2class="anchor anchorTargetStickyNavbar_tleR"id="creating-and-running-a-pod">Creating and running a pod<ahref="#creating-and-running-a-pod"class="hash-link"aria-label="Direct link to Creating and running a pod"title="Direct link to Creating and running a pod"translate="no"></a></h2>
</ol></div><footerclass="theme-doc-footer docusaurus-mt-lg"><divclass="row margin-top--sm theme-doc-footer-tags-row"><divclass="col"><b>Tags:</b><ulclass="tags_Ow0B padding--none margin-left--sm"><liclass="tag_DFxh"><arel="tag"class="tag_otG2 tagRegular_s0E1"href="/tutorial/tags/podman-desktop">podman-desktop</a></li><liclass="tag_DFxh"><arel="tag"class="tag_otG2 tagRegular_s0E1"href="/tutorial/tags/running-a-pod-from-docker-file">running-a-pod-from-docker-file</a></li><liclass="tag_DFxh"><arel="tag"class="tag_otG2 tagRegular_s0E1"href="/tutorial/tags/running-a-pod-from-container-file">running-a-pod-from-container-file</a></li></ul></div></div></footer></article><navclass="docusaurus-mt-lg pagination-nav"aria-label="Docs pages"><aclass="pagination-nav__link pagination-nav__link--prev"href="/tutorial"><divclass="pagination-nav__sublabel">Previous</div><divclass="pagination-nav__label">Introduction</div></a><aclass="pagination-nav__link pagination-nav__link--next"href="/tutorial/running-a-kubernetes-cluster"><divclass="pagination-nav__sublabel">Next</div><divclass="pagination-nav__label">Running a Kubernetes cluster</div></a></nav></div></div><divclass="col col--3"><divclass="tableOfContents_XG6w thin-scrollbar theme-doc-toc-desktop"><ulclass="table-of-contents table-of-contents__left-border"><li><ahref="#before-you-begin"class="table-of-contents__link toc-highlight">Before you begin</a></li><li><ahref="#building-an-image"class="table-of-contents__link toc-highlight">Building an image</a></li><li><ahref="#creating-a-container"class="table-of-contents__link toc-highlight">Creating a container</a></li><li><ahref="#creating-and-running-a-pod"class="table-of-contents__link toc-highlight">Creating and running a pod</a></li></ul></div></div></div></div></main></div></div></div><footerclass="theme-layout-footer footer"><divclass="container container-fluid"><divclass="row footer__links"><divclass="theme-layout-footer-column col footer__col"><divclass="footer__title">Documentation</div><ulclass="footer__items clean-list"><liclass="footer__item"><aclass="footer__link-item"href="/docs/installation">Installing Podman Desktop</a></li><liclass="footer__item"><aclass="footer__link-item"href="/docs/migrating-from-docker">Migrating from Docker</a></li><liclass="footer__item"><aclass="footer__link-item"href="/docs/kubernetes">Working with Kubernetes</a></li><liclass="footer__item"><aclass="footer__link-item"href="/docs/troubleshooting">Troubleshooting</a></li></ul></div><divclass="theme-layout-footer-column col footer__col"><divclass="footer__title">Links</div><ulclass="footer__items clean-list"><liclass="footer__item"><ahref="https://github.com/podman-desktop/podman-desktop"target="_blank"rel="noopener noreferrer"class="footer__link-item">GitHub<svgwidth="13.5"height="13.5"aria-label="(opens in new tab)"class="iconExternalLink_nPrP"><usehref="#theme-svg-external-link"></use></svg></a></li><liclass="footer__item"><ahref="https://discord.com/invite/x5GzFF6QH4"target="_blank"rel="noopener noreferrer"class="footer__link-item">Chat (bridged): #podman-desktop on Discord<svgwidth="13.5"height="13.5"aria-label="(opens in new tab)"class="iconExternalLink_nPrP"><usehref="#theme-svg-external-link"></use></svg></a></li><liclass="footer__item"><ahref="https://github.com/podman-desktop/podman-desktop#communication"target="_blank"rel="noopener noreferrer"class="footer__link-item">Other ways to Communicate<svgwidth="13.5"height="13.5"aria-label="(opens in new tab)"class="iconExternalLink_nPrP"><usehref="#theme-svg-external-link"></use></svg></a></li><liclass="footer__item"><ahref="https://github.com/orgs/podman-desktop/projects/4/views/3"target="_blank"rel="noopener noreferrer"class="footer__link-item">Current Sprint<svgwidth="13.5"height="13.5"aria-label="(opens in new tab)"class="iconExternalLink_nPrP"><usehref="#theme-svg-external-link"></use></svg></a></li></ul></div></div><divclass="footer__bottom text--center"><divclass="footer__copyright">
