2024-09-16 12:54:12 +00:00
<!doctype html>
< html lang = "en" dir = "ltr" class = "docs-wrapper plugin-docs plugin-id-tutorial docs-version-current docs-doc-page docs-doc-id-running-a-pod-using-a-container-docker-file" data-has-hydrated = "false" >
< head >
< meta charset = "UTF-8" >
2025-10-20 08:31:16 +00:00
< meta name = "generator" content = "Docusaurus v3.8.1" >
2025-09-08 13:08:00 +00:00
< title data-rh = "true" > Running a pod using a container or docker file | Podman Desktop< / title > < meta data-rh = "true" name = "viewport" content = "width=device-width,initial-scale=1" > < meta data-rh = "true" name = "twitter:card" content = "summary_large_image" > < meta data-rh = "true" property = "og:image" content = "https://podman-desktop.io/img/banner_podman-desktop.png" > < meta data-rh = "true" name = "twitter:image" content = "https://podman-desktop.io/img/banner_podman-desktop.png" > < meta data-rh = "true" property = "og:url" content = "https://podman-desktop.io/tutorial/running-a-pod-using-a-container-docker-file" > < meta data-rh = "true" property = "og:locale" content = "en" > < meta data-rh = "true" name = "docusaurus_locale" content = "en" > < meta data-rh = "true" name = "docsearch:language" content = "en" > < meta data-rh = "true" name = "docusaurus_version" content = "current" > < meta data-rh = "true" name = "docusaurus_tag" content = "docs-tutorial-current" > < meta data-rh = "true" name = "docsearch:version" content = "current" > < meta data-rh = "true" name = "docsearch:docusaurus_tag" content = "docs-tutorial-current" > < meta data-rh = "true" property = "og:title" content = "Running a pod using a container or docker file | Podman Desktop" > < meta data-rh = "true" name = "description" content = "Create and run a pod from a container or docker file on your machine." > < meta data-rh = "true" property = "og:description" content = "Create and run a pod from a container or docker file on your machine." > < meta data-rh = "true" name = "keywords" content = "podman desktop,podman,pod,Containerfile,Dockerfile" > < link data-rh = "true" rel = "icon" href = "/img/favicon.ico" > < link data-rh = "true" rel = "canonical" href = "https://podman-desktop.io/tutorial/running-a-pod-using-a-container-docker-file" > < link data-rh = "true" rel = "alternate" href = "https://podman-desktop.io/tutorial/running-a-pod-using-a-container-docker-file" hreflang = "en" > < link data-rh = "true" rel = "alternate" href = "https://podman-desktop.io/tutorial/running-a-pod-using-a-container-docker-file" hreflang = "x-default" > < link data-rh = "true" rel = "preconnect" href = "https://MR01ANKQ9S-dsn.algolia.net" crossorigin = "anonymous" > < script data-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 > < link rel = "alternate" type = "application/rss+xml" href = "/blog/rss.xml" title = "Podman Desktop RSS Feed" >
2024-09-16 12:54:12 +00:00
< link rel = "alternate" type = "application/atom+xml" href = "/blog/atom.xml" title = "Podman Desktop Atom Feed" >
< link rel = "alternate" type = "application/json" href = "/blog/feed.json" title = "Podman Desktop JSON Feed" >
2025-01-14 13:36:07 +00:00
2024-09-16 12:54:12 +00:00
< link rel = "search" type = "application/opensearchdescription+xml" title = "Podman Desktop" href = "/opensearch.xml" >
< link rel = "preconnect" href = "https://podman-desktop-website.goatcounter.com" >
2025-10-21 05:31:46 +00:00
< script async src = "//gc.zgo.at/count.js" data-goatcounter = "https://podman-desktop-website.goatcounter.com/count" > < / script > < link rel = "stylesheet" href = "/assets/css/styles.031396ea.css" >
2025-10-24 06:06:15 +00:00
< script src = "/assets/js/runtime~main.3ecccfad.js" defer = "defer" > < / script >
< script src = "/assets/js/main.62de54db.js" defer = "defer" > < / script >
2024-09-16 12:54:12 +00:00
< / head >
< body class = "navigation-with-keyboard" >
2025-10-20 08:31:16 +00:00
< svg xmlns = "http://www.w3.org/2000/svg" style = "display: none;" > < defs >
2025-09-08 13:08:00 +00:00
< symbol id = "theme-svg-external-link" viewBox = "0 0 24 24" > < path fill = "currentColor" d = "M21 13v10h-21v-19h12v2h-10v15h17v-8h2zm3-12h-10.988l4.035 4-6.977 7.07 2.828 2.828 6.977-7.07 4.125 4.172v-11z" / > < / symbol >
< / defs > < / svg >
2025-10-20 08:31:16 +00:00
< script > ! function ( ) { var t = function ( ) { try { return new URLSearchParams ( window . location . search ) . get ( "docusaurus-theme" ) } catch ( t ) { } } ( ) || function ( ) { try { return window . localStorage . getItem ( "theme" ) } catch ( t ) { } } ( ) ; document . documentElement . setAttribute ( "data-theme" , t || ( window . matchMedia ( "(prefers-color-scheme: dark)" ) . matches ? "dark" : "light" ) ) , document . documentElement . setAttribute ( "data-theme-choice" , t || "system" ) } ( ) , function ( ) { try { const c = new URLSearchParams ( window . location . search ) . entries ( ) ; for ( var [ t , e ] of c ) if ( t . startsWith ( "docusaurus-data-" ) ) { var a = t . replace ( "docusaurus-data-" , "data-" ) ; document . documentElement . setAttribute ( a , e ) } } catch ( t ) { } } ( ) < / script > < div id = "__docusaurus" > < div role = "region" aria-label = "Skip to main content" > < a class = "skipToContent_oPtH" href = "#__docusaurus_skipToContent_fallback" > Skip to main content< / a > < / div > < nav aria-label = "Main" class = "theme-layout-navbar navbar navbar--fixed-top" > < div class = "navbar__inner" > < div class = "theme-layout-navbar-left navbar__items" > < button aria-label = "Toggle navigation bar" aria-expanded = "false" class = "navbar__toggle clean-btn" type = "button" > < svg width = "30" height = "30" viewBox = "0 0 30 30" aria-hidden = "true" > < path stroke = "currentColor" stroke-linecap = "round" stroke-miterlimit = "10" stroke-width = "2" d = "M4 7h22M4 15h22M4 23h22" > < / path > < / svg > < / button > < a class = "navbar__brand" href = "/" > < div class = "navbar__logo" > < img src = "/img/logo.svg" alt = "Podman Desktop Logo" class = "themedComponent_siVc themedComponent--light_hHel" height = "56" > < img src = "/img/logo.svg" alt = "Podman Desktop Logo" class = "themedComponent_siVc themedComponent--dark_yETr" height = "56" > < / div > < b class = "navbar__title text--truncate" > podman desktop< / b > < / a > < a class = "navbar__item navbar__link" href = "/docs/intro" > Documentation< / a > < a class = "navbar__item navbar__link" href = "/downloads" > Downloads< / a > < a class = "navbar__item navbar__link" href = "/community" > Community< / a > < div class = "navbar__item dropdown dropdown--hoverable" > < a href = "#" aria-haspopup = "true" aria-expanded = "false" role = "button" class = "navbar__link" > Resources< / a > < ul class = "dropdown__menu" > < li > < a class = "dropdown__link" href = "/features" > Features< / a > < / li > < li > < a aria-current = "page" class = "dropdown__link dropdown__link--active" href = "/tutorial" > Tutorials< / a > < / li > < li > < a class = "dropdown__link" href = "/extend" > Extend< / a > < / li > < / ul > < / div > < a class = "navbar__item navbar__link" href = "/blog" > Blog< / a > < / div > < div class = "theme-layout-navbar-right navbar__items navbar__items--right" > < a href = "https://github.com/podman-desktop/podman-desktop" target = "_blank" id = "github-stars-button" rel = "noopener noreferrer" class = "navbar__item navbar__link hidden xl:flex items-center gap-2 px-4 mr-3 py-[9px] border border-black dark:border-white rounded-lg font-medium min-w-[9rem] text-base" > < svg data-prefix = "fab" data-icon = "github" class = "svg-inline--fa fa-github" role = "img" viewBox = "0 0 512 512" aria-hidden = "true" > < path fill = "currentColor" d = "M173.9 397 . 4c0 2-2 . 3 3 . 6-5 . 2 3 . 6-3 . 3 . 3-5 . 6-1 . 3-5 . 6-3 . 6 0-2 2 . 3-3 . 6 5 . 2-3 . 6 3- . 3 5 . 6 1 . 3 5 . 6 3 . 6zm-31 . 1-4 . 5c- . 7 2 1 . 3 4 . 3 4 . 3 4 . 9 2 . 6 1 5 . 6 0 6 . 2-2s-1 . 3-4 . 3-4 . 3-5 . 2c-2 . 6- . 7-5 . 5 . 3-6 . 2 2 . 3zm44 . 2-1 . 7c-2 . 9 . 7-4 . 9 2 . 6-4 . 6 4 . 9 . 3 2 2 . 9 3 . 3 5 . 9 2 . 6 2 . 9- . 7 4 . 9-2 . 6 4 . 6-4 . 6- . 3-1 . 9-3-3 . 2-5 . 9-2 . 9zM252 . 8 8c-138 . 7 0-244 . 8 105 . 3-244 . 8 244 0 110 . 9 69 . 8 205 . 8 169 . 5 239 . 2 12 . 8 2 . 3 17 . 3-5 . 6 17 . 3-12 . 1 0-6 . 2- . 3-40 . 4- . 3-61 . 4 0 0-70 15-84 . 7-29 . 8 0 0-11 . 4-29 . 1-27 . 8-36 . 6 0 0-22 . 9-15 . 7 1 . 6-15 . 4 0 0 24 . 9 2 38 . 6 25 . 8 21 . 9 38 . 6 58 . 6 27 . 5 72 . 9 20 . 9 2 . 3-16 8 . 8-27 . 1 16-33 . 7-55 . 9-6 . 2-112 . 3-14 . 3-112 . 3-110 . 5 0-27 . 5 7 . 6-41 . 3 23 . 6-58 . 9-2 . 6-6 . 5-11 . 1-33 . 3 2 . 6-67 . 9 20 . 9-6 . 5 69 27 69 27 20-5 . 6 41 . 5-8 . 5 62 . 8-8 . 5s42 . 8 2 . 9 62 . 8 8 . 5c0 0 48 . 1-33 . 6 69-27 13 . 7 34 . 7 5 . 2 61 . 4 2 . 6 67 . 9 16 17 . 7 25 . 8 31 . 5 25 . 8 58 . 9 0 96 . 5-58 . 9 104 . 2-114 . 8 110 . 5 9 . 2 7 . 9 17 22 . 9 17 46 . 4 0 33 . 7- . 3 75 . 4- . 3 83 . 6 0 6 . 5 4 . 6 14 . 4 17 . 3 12 . 1 100-33 . 2 167 . 8-128 . 1 167 . 8-239 0-138 . 7-112 . 5-244-251 . 2-244zM105 . 2 352 . 9c-1 . 3 1-1 3 . 3 . 7 5 . 2 1 . 6 1 . 6 3 . 9 2 . 3 5 . 2 1 1 . 3-1 1-3 . 3- . 7-5 . 2-1 . 6-1 . 6-3 . 9-2 . 3-5 . 2-1zm-10 . 8-8 . 1c- . 7 1 . 3 . 3 2 . 9 2 . 3 3 . 9 1 . 6 1 3 . 6 . 7 4 . 3- . 7 . 7-1 . 3- . 3-2 . 9-2 . 3-3 . 9-2- . 6-3 . 6- . 3-4 . 3 . 7zm32 . 4 35 . 6c-1 . 6 1 . 3-1 4 . 3 1 . 3 6 . 2 2 . 3 2 . 3 5 . 2 2 . 6 6 . 5 1 1 . 3-1 . 3 . 7-4 .
2024-09-27 04:39:44 +00:00
< p > This tutorial covers the following end-to-end tasks required to run a pod from a container or docker file:< / p >
2024-09-16 12:54:12 +00:00
< ul >
2025-10-20 08:31:16 +00:00
< li > Building an image< / li >
< li > Creating a container< / li >
< li > Creating and running a pod< / li >
2024-09-16 12:54:12 +00:00
< / ul >
< p > When creating a container, you can set the following configurations:< / p >
< ul >
2025-10-20 08:31:16 +00:00
< li >
2024-09-16 12:54:12 +00:00
< p > With < strong > Basic< / strong > configuration, you have the option to:< / p >
< ul >
2025-10-20 08:31:16 +00:00
< li >
2024-09-16 12:54:12 +00:00
< 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 >
< / li >
2025-10-20 08:31:16 +00:00
< li >
2024-09-16 12:54:12 +00:00
< 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 >
< / li >
2025-10-20 08:31:16 +00:00
< li >
2024-09-16 12:54:12 +00:00
< p > Select a file containing environment variables for your container. This file contains data in the < code > key=value< / code > format.< / p >
< / li >
< / ul >
< / li >
2025-10-20 08:31:16 +00:00
< li >
2024-09-16 12:54:12 +00:00
< p > With < strong > Advanced< / strong > configuration, you have the option of:< / p >
< ul >
2025-10-20 08:31:16 +00:00
< li > Automatic removal of container< / li >
< li > Specifying ID of the user who can run a container< / li >
< li > Selecting a restart policy that defines whether a container should restart on exit< / li >
2024-09-16 12:54:12 +00:00
< / ul >
< / li >
2025-10-20 08:31:16 +00:00
< li >
2024-09-16 12:54:12 +00:00
< p > With < strong > Networking< / strong > configuration, you have the option of defining:< / p >
< ul >
2025-10-20 08:31:16 +00:00
< li > A container host name< / li >
< li > A custom DNS server< / li >
< li > Additional hosts< / li >
< li > The networking mode for a container< / li >
2024-09-16 12:54:12 +00:00
< / ul >
< / li >
2025-10-20 08:31:16 +00:00
< li >
2024-09-16 12:54:12 +00:00
< p > With < strong > Security< / strong > configuration, you have the option to:< / p >
< ul >
2025-10-20 08:31:16 +00:00
< li > Secure you container resources< / li >
< li > Make container root filesystem read-only< / li >
< li > Add or drop security capabilities< / li >
< li > Specify a namespace to restrict the usage of containers to a group of users with defined privileges and ownership< / li >
2024-09-16 12:54:12 +00:00
< / ul >
< / li >
< / ul >
2025-10-20 08:31:16 +00:00
< h2 class = "anchor anchorWithStickyNavbar_JmGV" id = "before-you-begin" > Before you begin< a href = "#before-you-begin" class = "hash-link" aria-label = "Direct link to Before you begin" title = "Direct link to Before you begin" > < / a > < / h2 >
2024-09-27 04:39:44 +00:00
< p > Make sure you have:< / p >
2024-09-16 12:54:12 +00:00
< ul >
2025-10-20 08:31:16 +00:00
< li > < a href = "/docs/installation" > Installed Podman Desktop< / a > .< / li >
< li > < a href = "/docs/podman/creating-a-podman-machine" > A running Podman machine< / a > .< / li >
< li > A developer role.< / li >
< li > Created a docker file using the following code, if you do not have one on your machine:< / li >
2024-09-16 12:54:12 +00:00
< / ul >
2025-09-08 13:08:00 +00:00
< div class = "language-dockerfile codeBlockContainer_mQmQ theme-code-block" style = "--prism-color:#F8F8F2;--prism-background-color:#282A36" > < div class = "codeBlockContent_t_Hd" > < pre tabindex = "0" class = "prism-code language-dockerfile codeBlock_RMoD thin-scrollbar" style = "color:#F8F8F2;background-color:#282A36" > < code class = "codeBlockLines_AclH" > < span class = "token-line" style = "color:#F8F8F2" > < span class = "token comment" style = "color:rgb(98, 114, 164)" > # syntax=docker/dockerfile:1< / span > < span class = "token plain" > < / span > < br > < / span > < span class = "token-line" style = "color:#F8F8F2" > < span class = "token plain" style = "display:inline-block" > < / span > < br > < / span > < span class = "token-line" style = "color:#F8F8F2" > < span class = "token plain" > < / span > < span class = "token instruction keyword" style = "color:rgb(189, 147, 249);font-style:italic" > ARG< / span > < span class = "token instruction" > NODE_VERSION< / span > < span class = "token plain" > < / span > < br > < / span > < span class = "token-line" style = "color:#F8F8F2" > < span class = "token plain" > < / span > < span class = "token instruction keyword" style = "color:rgb(189, 147, 249);font-style:italic" > ARG< / span > < span class = "token instruction" > ALPINE_VERSION< / span > < span class = "token plain" > < / span > < br > < / span > < span class = "token-line" style = "color:#F8F8F2" > < span class = "token plain" style = "display:inline-block" > < / span > < br > < / span > < span class = "token-line" style = "color:#F8F8F2" > < span class = "token plain" > < / span > < span class = "token instruction keyword" style = "color:rgb(189, 147, 249);font-style:italic" > FROM< / span > < span class = "token instruction" > node:< / span > < span class = "token instruction variable" style = "color:rgb(189, 147, 249);font-style:italic" > ${NODE_VERSION}< / span > < span class = "token instruction" > -alpine< / span > < span class = "token instruction variable" style = "color:rgb(189, 147, 249);font-style:italic" > ${ALPINE_VERSION}< / span > < span class = "token instruction" > < / span > < span class = "token instruction keyword" style = "color:rgb(189, 147, 249);font-style:italic" > AS< / span > < span class = "token instruction" > base< / span > < span class = "token plain" > < / span > < br > < / span > < span class = "token-line" style = "color:#F8F8F2" > < span class = "token plain" > < / span > < span class = "token instruction keyword" style = "color:rgb(189, 147, 249);font-style:italic" > WORKDIR< / span > < span class = "token instruction" > /src< / span > < span class = "token plain" > < / span > < br > < / span > < span class = "token-line" style = "color:#F8F8F2" > < span class = "token plain" style = "display:inline-block" > < / span > < br > < / span > < span class = "token-line" style = "color:#F8F8F2" > < span class = "token plain" > < / span > < span class = "token instruction keyword" style = "color:rgb(189, 147, 249);font-style:italic" > FROM< / span > < span class = "token instruction" > base < / span > < span class = "token instruction keyword" style = "color:rgb(189, 147, 249);font-style:italic" > AS< / span > < span class = "token instruction" > build< / span > < span class = "token plain" > < / span > < br > < / span > < span class = "token-line" style = "color:#F8F8F2" > < span class = "token plain" > < / span > < span class = "token instruction keyword" style = "color:rgb(189, 147, 249);font-style:italic" > COPY< / span > < span class = "token instruction" > package*.json ./< / span > < span class = "token plain" > < / span > < br > < / span > < span class = "token-line" style = "color:#F8F8F2" > < span class = "token plain" > < / span > < span class = "token instruction keyword" style = "color:rgb(189, 147, 249);font-style:italic" > RUN< / span > < span class = "token instruction" > npm ci< / span > < span class = "token plain" > < / span > < br > < / span > < span class = "token-line" style = "color:#F8F8F2" > < span class = "token plain" > < / span > < span class = "token instruction keyword" style = "color:rgb(189, 147, 249);font-style:italic" > RUN< / span > < span class = "token instruction" > npm run build< / span > < span class = "token plain" > < / span > < br > < / span > < span class = "token-line" style = "color:#F8F8F2" > < span class = "token plain" style = "display:inline-block" > < / span > < br > < / span > < span class = "token-line" style = "color:#F8F8F2" > < span class = "token plain" > < / span > < span class = "token instruction keyword" style = "color:rgb(189, 147, 249);font-style:italic" > FROM< / span > < span class = "token instruction" > base < / span > < span class = "token instruction keyword" style = "color:rg
2025-10-20 08:31:16 +00:00
< h2 class = "anchor anchorWithStickyNavbar_JmGV" id = "building-an-image" > Building an image< a href = "#building-an-image" class = "hash-link" aria-label = "Direct link to Building an image" title = "Direct link to Building an image" > < / a > < / h2 >
2024-09-16 12:54:12 +00:00
< ol >
2025-10-20 08:31:16 +00:00
< li >
2024-09-16 12:54:12 +00:00
< p > Click < strong > Containers< / strong > in the left navigation pane.< / p >
< / li >
2025-10-20 08:31:16 +00:00
< li >
2024-09-16 12:54:12 +00:00
< p > Click < strong > Create< / strong > .
< img decoding = "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 >
< / li >
2025-10-20 08:31:16 +00:00
< li >
2024-09-16 12:54:12 +00:00
< p > On the < strong > Build image from Containerfile< / strong > page, provide the following details:< / p >
< ul >
2025-10-20 08:31:16 +00:00
< li > Containerfile path: Select the path where the container or docker file is placed.< / li >
< li > Build context directory: The field automatically picks up the context directory based on the file path.< / li >
< li > Image name: Enter the image name, if required.< / li >
< li > 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 >
< li > Platform: Change the platform on which you want to build the image. The default platform is Intel and AMD x86_64 systems.
2024-09-16 12:54:12 +00:00
< img decoding = "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 >
< / ul >
< / li >
2025-10-20 08:31:16 +00:00
< li >
2024-09-16 12:54:12 +00:00
< p > Click < strong > Build< / strong > . The image starts to build.< / p >
< / li >
2025-10-20 08:31:16 +00:00
< li >
2024-09-16 12:54:12 +00:00
< p > Click < strong > Done< / strong > once the image is built successfully.< / p >
< / li >
2025-10-20 08:31:16 +00:00
< li >
2024-09-16 12:54:12 +00:00
< p > View the newly created image on the < strong > Images< / strong > page.< / p >
< / li >
< / ol >
2025-10-20 08:31:16 +00:00
< h2 class = "anchor anchorWithStickyNavbar_JmGV" id = "creating-a-container" > Creating a container< a href = "#creating-a-container" class = "hash-link" aria-label = "Direct link to Creating a container" title = "Direct link to Creating a container" > < / a > < / h2 >
2024-09-16 12:54:12 +00:00
< ol >
2025-10-20 08:31:16 +00:00
< li >
2024-09-16 12:54:12 +00:00
< p > Click < strong > Images< / strong > in the left navigation pane.< / p >
< / li >
2025-10-20 08:31:16 +00:00
< li >
2024-09-16 12:54:12 +00:00
< 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.
< img decoding = "async" loading = "lazy" alt = "running an image" src = "/assets/images/run-image-8e07bb1386f655e5b2d7730eafe69081.png" width = "1952" height = "446" class = "img_SS3x" > < / p >
< / li >
2025-10-20 08:31:16 +00:00
< li >
2024-09-16 12:54:12 +00:00
< p > Optional: Configure the basic details of the container:
< img decoding = "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 >
< / li >
2025-10-20 08:31:16 +00:00
< li >
2024-09-16 12:54:12 +00:00
< p > Optional: Select the < strong > Advanced< / strong > tab to configure advanced details of the container:
< img decoding = "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 >
< / li >
2025-10-20 08:31:16 +00:00
< li >
2024-09-16 12:54:12 +00:00
< p > Optional: Select the < strong > Networking< / strong > tab to configure the networking details of the container:
< img decoding = "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 >
< / li >
2025-10-20 08:31:16 +00:00
< li >
2024-09-16 12:54:12 +00:00
< p > Optional: Select the < strong > Security< / strong > tab to configure the security details of the container:
< img decoding = "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 >
< / li >
2025-10-20 08:31:16 +00:00
< li >
2024-09-16 12:54:12 +00:00
< p > Click < strong > Start Container< / strong > .< / p >
< / li >
2025-10-20 08:31:16 +00:00
< li >
2024-09-16 12:54:12 +00:00
< p > Check the < strong > Container Details< / strong > page for information, such as summary, logs, YAML code, and to access the terminal.
< img decoding = "async" loading = "lazy" alt = "container details page" src = "/assets/images/container-details-page-42130fb2c004a3970bed9c92d2c10b6a.png" width = "2432" height = "1018" class = "img_SS3x" > < / p >
< / li >
2025-10-20 08:31:16 +00:00
< li >
2024-10-11 10:16:18 +00:00
< p > Click the < strong > close< / strong > icon on the right hand side of the page.< / p >
2024-09-16 12:54:12 +00:00
< / li >
2025-10-20 08:31:16 +00:00
< li >
2024-10-11 10:16:18 +00:00
< p > View the newly created container on the < strong > Containers< / strong > page.< / p >
2024-09-16 12:54:12 +00:00
< / li >
< / ol >
2025-10-20 08:31:16 +00:00
< h2 class = "anchor anchorWithStickyNavbar_JmGV" id = "creating-and-running-a-pod" > Creating and running a pod< a href = "#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" > < / a > < / h2 >
2024-09-16 12:54:12 +00:00
< ol >
2025-10-20 08:31:16 +00:00
< li >
2024-09-16 12:54:12 +00:00
< p > Go to < strong > Containers< / strong > from the left navigation pane.< / p >
< / li >
2025-10-20 08:31:16 +00:00
< li >
2024-09-16 12:54:12 +00:00
< p > Select the containers from the container list.
2025-07-17 11:00:36 +00:00
< img decoding = "async" loading = "lazy" alt = "selecting containers" src = "/assets/images/selecting-containers-534731d085f40875fcb68de89e4d4e46.png" width = "2432" height = "658" class = "img_SS3x" > < / p >
2024-09-16 12:54:12 +00:00
< / li >
2025-10-20 08:31:16 +00:00
< li >
2024-09-16 12:54:12 +00:00
< p > Click < strong > Create Pod< / strong > . The < strong > Copy containers to a pod< / strong > page opens.< / p >
< / li >
2025-10-20 08:31:16 +00:00
< li >
2024-09-16 12:54:12 +00:00
< p > Change the name of the pod if required and click < strong > Create Pod< / strong > .
< img decoding = "async" loading = "lazy" alt = "creating pods" src = "/assets/images/creating-a-pod-1dcd8844fa8619b3ce915df9046eaf3e.png" width = "2432" height = "826" class = "img_SS3x" > < / p >
< / li >
2025-10-20 08:31:16 +00:00
< li >
2024-09-16 12:54:12 +00:00
< p > View the newly created pod on the < strong > Pods< / strong > page.< / p >
< / li >
2025-10-20 08:31:16 +00:00
< li >
2024-09-16 12:54:12 +00:00
< p > Click the < strong > Start Pod< / strong > icon corresponding to the pod you created.< / p >
< / li >
2025-10-20 08:31:16 +00:00
< li >
2024-09-16 12:54:12 +00:00
< p > Check that the pod is running on the same page.
< img decoding = "async" loading = "lazy" alt = "running pod" src = "/assets/images/my-pod-d0605843631636e62b1bf8baf34a981e.png" width = "1072" height = "215" class = "img_SS3x" > < / p >
< / li >
2025-10-20 08:31:16 +00:00
< / ol > < / div > < footer class = "theme-doc-footer docusaurus-mt-lg" > < div class = "row margin-top--sm theme-doc-footer-tags-row" > < div class = "col" > < b > Tags:< / b > < ul class = "tags_Ow0B padding--none margin-left--sm" > < li class = "tag_DFxh" > < a rel = "tag" class = "tag_otG2 tagRegular_s0E1" href = "/tutorial/tags/podman-desktop" > podman-desktop< / a > < / li > < li class = "tag_DFxh" > < a rel = "tag" class = "tag_otG2 tagRegular_s0E1" href = "/tutorial/tags/running-a-pod-from-docker-file" > running-a-pod-from-docker-file< / a > < / li > < li class = "tag_DFxh" > < a rel = "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 > < nav class = "docusaurus-mt-lg pagination-nav" aria-label = "Docs pages" > < a class = "pagination-nav__link pagination-nav__link--prev" href = "/tutorial" > < div class = "pagination-nav__sublabel" > Previous< / div > < div class = "pagination-nav__label" > Introduction< / div > < / a > < a class = "pagination-nav__link pagination-nav__link--next" href = "/tutorial/running-a-kubernetes-cluster" > < div class = "pagination-nav__sublabel" > Next< / div > < div class = "pagination-nav__label" > Running a Kubernetes cluster< / div > < / a > < / nav > < / div > < / div > < div class = "col col--3" > < div class = "tableOfContents_XG6w thin-scrollbar theme-doc-toc-desktop" > < ul class = "table-of-contents table-of-contents__left-border" > < li > < a href = "#before-you-begin" class = "table-of-contents__link toc-highlight" > Before you begin< / a > < / li > < li > < a href = "#building-an-image" class = "table-of-contents__link toc-highlight" > Building an image< / a > < / li > < li > < a href = "#creating-a-container" class = "table-of-contents__link toc-highlight" > Creating a container< / a > < / li > < li > < a href = "#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 > < footer class = "theme-layout-footer footer" > < div class = "container container-fluid" > < div class = "row footer__links" > < div class = "theme-layout-footer-column col footer__col" > < div class = "footer__title" > Documentation< / div > < ul class = "footer__items clean-list" > < li class = "footer__item" > < a class = "footer__link-item" href = "/docs/installation" > Installing Podman Desktop< / a > < / li > < li class = "footer__item" > < a class = "footer__link-item" href = "/docs/migrating-from-docker" > Migrating from Docker< / a > < / li > < li class = "footer__item" > < a class = "footer__link-item" href = "/docs/kubernetes" > Working with Kubernetes< / a > < / li > < li class = "footer__item" > < a class = "footer__link-item" href = "/docs/troubleshooting" > Troubleshooting< / a > < / li > < / ul > < / div > < div class = "theme-layout-footer-column col footer__col" > < div class = "footer__title" > Links< / div > < ul class = "footer__items clean-list" > < li class = "footer__item" > < a href = "https://github.com/podman-desktop/podman-desktop" target = "_blank" rel = "noopener noreferrer" class = "footer__link-item" > GitHub< svg width = "13.5" height = "13.5" aria-hidden = "true" class = "iconExternalLink_nPrP" > < use href = "#theme-svg-external-link" > < / use > < / svg > < / a > < / li > < li class = "footer__item" > < a href = "https://discord.com/invite/x5GzFF6QH4" target = "_blank" rel = "noopener noreferrer" class = "footer__link-item" > Chat (bridged): #podman-desktop on Discord< svg width = "13.5" height = "13.5" aria-hidden = "true" class = "iconExternalLink_nPrP" > < use href = "#theme-svg-external-link" > < / use > < / svg > < / a > < / li > < li class = "footer__item" > < a href = "https://github.com/podman-desktop/podman-desktop#communication" target = "_blank" rel = "noopener noreferrer" class = "footer__link-item" > Other ways to Communicate< svg width = "13.5" height = "13.5" aria-hidden = "true" class = "iconExternalLink_nPrP" > < use href = "#theme-svg-external-link" > < / use > < / svg > < / a > < / li > < li class = "footer__item" > < a href = "https://github.com/orgs/podman-desktop/projects/4/views/3" target = "_blank" rel = "noopener noreferrer" class = "footer__link-item" > Current Sprint< svg width = "13.5" height = "13.5" aria-hidden = "true" class = "iconExternalLink_nPrP" > < use href = "#theme-svg-external-link" > < / use > < / svg > < / a > < / li > < / ul > < / div > < / div > < div class = "footer__bottom text--center" > < div class = "footer__copyright" >
2025-04-14 17:49:47 +00:00
< div class = "flex flex-col items-start text-left gap-4" >
< div class = "w-96 mt-8 mb-8" >
< img class = "dark:hidden" alt = "Cloud Native Computing Foundation" src = "/img/cncf-logo.svg" >
< img class = "hidden dark:inline" alt = "Cloud Native Computing Foundation" src = "/img/cncf-logo-dark.svg" >
< / div >
< div class = "text-sm" >
< p class = "mb-1" > We are a < a href = "https://cncf.io/" class = "underline" > Cloud Native Computing Foundation< / a > sandbox project.< / p >
< p class = "mb-1" > © Copyright Podman Desktop Contributors 2025. © 2025 The Linux Foundation. All rights reserved.< / p >
< p class = "mb-1" > The Linux Foundation has registered trademarks and uses trademarks.
For a list of trademarks of The Linux Foundation, please see our
< a href = "https://www.linuxfoundation.org/trademark-usage/" class = "underline" > Trademark Usage< / a > page.< / p >
< / div >
< / div >
< / div > < / div > < / div > < / footer > < / div >
2024-09-16 12:54:12 +00:00
< / body >
< / html >
