2024-03-04 10:44:38 +00:00
<!doctype html>
< html lang = "en" dir = "ltr" class = "docs-wrapper plugin-docs plugin-id-default docs-version-current docs-doc-page docs-doc-id-containers/registries/index" data-has-hydrated = "false" >
< head >
< meta charset = "UTF-8" >
2024-08-14 11:49:56 +00:00
< meta name = "generator" content = "Docusaurus v3.5.2" >
2024-03-04 10:44:38 +00:00
< title data-rh = "true" > Registries | 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:url" content = "https://podman-desktop.io/docs/containers/registries" > < 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-default-current" > < meta data-rh = "true" name = "docsearch:version" content = "current" > < meta data-rh = "true" name = "docsearch:docusaurus_tag" content = "docs-default-current" > < meta data-rh = "true" property = "og:title" content = "Registries | Podman Desktop" > < meta data-rh = "true" name = "description" content = "Working with container registries" > < meta data-rh = "true" property = "og:description" content = "Working with container registries" > < meta data-rh = "true" name = "keywords" content = "podman desktop,podman,containers,registries" > < meta data-rh = "true" property = "og:image" content = "https://podman-desktop.io/img/docs/containers/registries/img/registries.png" > < meta data-rh = "true" name = "twitter:image" content = "https://podman-desktop.io/img/docs/containers/registries/img/registries.png" > < link data-rh = "true" rel = "icon" href = "/img/favicon.ico" > < link data-rh = "true" rel = "canonical" href = "https://podman-desktop.io/docs/containers/registries" > < link data-rh = "true" rel = "alternate" href = "https://podman-desktop.io/docs/containers/registries" hreflang = "en" > < link data-rh = "true" rel = "alternate" href = "https://podman-desktop.io/docs/containers/registries" hreflang = "x-default" > < link data-rh = "true" rel = "preconnect" href = "https://MR01ANKQ9S-dsn.algolia.net" crossorigin = "anonymous" > < link rel = "alternate" type = "application/rss+xml" href = "/blog/rss.xml" title = "Podman Desktop RSS Feed" >
< 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" >
< link rel = "search" type = "application/opensearchdescription+xml" title = "Podman Desktop" href = "/opensearch.xml" >
< link rel = "preconnect" href = "https://podman-desktop-website.goatcounter.com" >
2024-08-28 08:44:16 +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.01082bb4.css" >
2024-08-28 09:33:24 +00:00
< script src = "/assets/js/runtime~main.41ce87c7.js" defer = "defer" > < / script >
< script src = "/assets/js/main.039a9aa3.js" defer = "defer" > < / script >
2024-03-04 10:44:38 +00:00
< / head >
< body class = "navigation-with-keyboard" >
2024-08-28 09:33:24 +00:00
< script > ! function ( ) { function t ( t ) { document . documentElement . setAttribute ( "data-theme" , t ) } var e = function ( ) { try { return new URLSearchParams ( window . location . search ) . get ( "docusaurus-theme" ) } catch ( t ) { } } ( ) || function ( ) { try { return window . localStorage . getItem ( "theme" ) } catch ( t ) { } } ( ) ; null !== e ? t ( e ) : window . matchMedia ( "(prefers-color-scheme: dark)" ) . matches ? t ( "dark" ) : window . matchMedia ( "(prefers-color-scheme: light)" ) . matches ? t ( "light" ) : t ( "dark" ) } ( ) , 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 = "navbar navbar--fixed-top" > < div class = "navbar__inner" > < div class = "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 aria-current = "page" class = "navbar__item navbar__link navbar__link--active" href = "/docs/intro" > Documentation< / a > < a class = "navbar__item navbar__link" href = "/core-values" > Core Values< / a > < a class = "navbar__item navbar__link" href = "/features" > Features< / a > < a class = "navbar__item navbar__link" href = "/downloads" > Downloads< / a > < a class = "navbar__item navbar__link" href = "/extend" > Extend< / a > < a class = "navbar__item navbar__link" href = "/blog" > Blog< / a > < / div > < div class = "navbar__items navbar__items--right" > < a href = "https://github.com/containers/podman-desktop" target = "_blank" rel = "noopener noreferrer" class = "navbar__item navbar__link header-github-link" > < / a > < div class = "toggle_ki11 colorModeToggle_Hewu" > < button class = "clean-btn toggleButton_MMFG toggleButtonDisabled_Uw7m" type = "button" disabled = "" title = "Switch between dark and light mode (currently dark mode)" aria-label = "Switch between dark and light mode (currently dark mode)" aria-live = "polite" > < svg viewBox = "0 0 24 24" width = "24" height = "24" class = "lightToggleIcon_lgto" > < path fill = "currentColor" d = "M12,9c1.65,0,3,1.35,3,3s-1.35,3-3,3s-3-1.35-3-3S10.35,9,12,9 M12,7c-2.76,0-5,2.24-5,5s2.24,5,5,5s5-2.24,5-5 S14.76,7,12,7L12,7z M2,13l2,0c0.55,0,1-0.45,1-1s-0.45-1-1-1l-2,0c-0.55,0-1,0.45-1,1S1.45,13,2,13z M20,13l2,0c0.55,0,1-0.45,1-1 s-0.45-1-1-1l-2,0c-0.55,0-1,0.45-1,1S19.45,13,20,13z M11,2v2c0,0.55,0.45,1,1,1s1-0.45,1-1V2c0-0.55-0.45-1-1-1S11,1.45,11,2z M11,20v2c0,0.55,0.45,1,1,1s1-0.45,1-1v-2c0-0.55-0.45-1-1-1C11.45,19,11,19.45,11,20z M5.99,4.58c-0.39-0.39-1.03-0.39-1.41,0 c-0.39,0.39-0.39,1.03,0,1.41l1.06,1.06c0.39,0.39,1.03,0.39,1.41,0s0.39-1.03,0-1.41L5.99,4.58z M18.36,16.95 c-0.39-0.39-1.03-0.39-1.41,0c-0.39,0.39-0.39,1.03,0,1.41l1.06,1.06c0.39,0.39,1.03,0.39,1.41,0c0.39-0.39,0.39-1.03,0-1.41 L18.36,16.95z M19.42,5.99c0.39-0.39,0.39-1.03,0-1.41c-0.39-0.39-1.03-0.39-1.41,0l-1.06,1.06c-0.39,0.39-0.39,1.03,0,1.41 s1.03,0.39,1.41,0L19.42,5.99z M7.05,18.36c0.39-0.39,0.39-1.03,0-1.41c-0.39-0.39-1.03-0.39-1.41,0l-1.06,1.06 c-0.39,0.39-0.39,1.03,0,1.41s1.03,0.39,1.41,0L7.05,18.36z" > < / path > < / svg > < svg viewBox = "0 0 24 24" width = "24" height = "24" class = "darkToggleIcon_U96C" > < path fill = "currentColor" d = "M9.37,5.51C9.19,6.15,9.1,6.82,9.1,7.5c0,4.08,3.32,7.4,7.4,7.4c0.68,0,1.35-0.09,1.99-0.27C17.45,17.19,14.93,19,12,19 c-3 . 86 , 0-7-3 . 14-7-7C5 , 9 . 07 , 6 . 81 , 6 . 55 , 9 . 37 , 5 . 51z M12 , 3c-4 . 97 , 0-9 , 4 . 03-9 , 9s4 . 03 , 9 , 9 , 9s9-4 . 03 , 9-9c0-0 . 46-0 . 04-0 . 92-0 . 1-1 . 36 c-0 . 98 , 1 . 37-2 . 58 , 2 . 26-4 . 4 , 2 . 26c-2 . 98 , 0
2024-03-04 10:44:38 +00:00
< div class = "theme-admonition theme-admonition-tip admonition_WCGJ alert alert--success" > < div class = "admonitionHeading_GCBg" > < span class = "admonitionIcon_L39b" > < svg viewBox = "0 0 12 16" > < path fill-rule = "evenodd" d = "M6.5 0C3.48 0 1 2.19 1 5c0 .92.55 2.25 1 3 1.34 2.25 1.78 2.78 2 4v1h5v-1c.22-1.22.66-1.75 2-4 .45-.75 1-2.08 1-3 0-2.81-2.48-5-5.5-5zm3.64 7.48c-.25.44-.47.8-.67 1.11-.86 1.41-1.25 2.06-1.45 3.23-.02.05-.02.11-.02.17H5c0-.06 0-.13-.02-.17-.2-1.17-.59-1.83-1.45-3.23-.2-.31-.42-.67-.67-1.11C2.44 6.78 2 5.65 2 5c0-2.2 2.02-4 4.5-4 1.22 0 2.36.42 3.22 1.19C10.55 2.94 11 3.94 11 5c0 .66-.44 1.78-.86 2.48zM4 14h5c-.23 1.14-1.3 2-2.5 2s-2.27-.86-2.5-2z" > < / path > < / svg > < / span > Before you start< / div > < div class = "admonitionContent_pbrs" > < p > Before you start, you should:< / p > < ul >
< li > Get authentication details for your container registry:<!-- -->
< ul >
< li > Registry URL.< / li >
< li > User name.< / li >
< li > Password, or OAuth secret.< / li >
< / ul >
< / li >
< li > Get the fully qualified name of a private image stored in your registry, such as < code > my-registry.tld/my-repository/my-image< / code > .< / li >
< li > Get the fully qualified image name that your registry requires to push an image, such as < code > my-registry.tld/my-repository/my-image< / code > .< / li >
< / ul > < / div > < / div >
2024-08-14 11:49:56 +00:00
< h2 class = "anchor anchorWithStickyNavbar_JmGV" id = "setting-up-a-pre-configured-registry" > Setting up a pre-configured registry< a href = "#setting-up-a-pre-configured-registry" class = "hash-link" aria-label = "Direct link to Setting up a pre-configured registry" title = "Direct link to Setting up a pre-configured registry" > < / a > < / h2 >
2024-03-04 10:44:38 +00:00
< p > To ease usage of the most popular container registries, Podman Desktop has pre-configured registries, including:< / p >
< ul >
< li > Docker Hub< / li >
< li > Red Hat Quay< / li >
< li > GitHub< / li >
< li > Google Container Registry< / li >
< / ul >
< p > If your container registry is in this list, follow the steps:< / p >
< ol >
< li >
< p > Go to < strong > < svg aria-hidden = "true" focusable = "false" data-prefix = "fas" data-icon = "gear" class = "svg-inline--fa fa-gear fa-lg" role = "img" xmlns = "http://www.w3.org/2000/svg" viewBox = "0 0 512 512" > < path fill = "currentColor" d = "M495.9 166.6c3.2 8.7 .5 18.4-6.4 24.6l-43.3 39.4c1.1 8.3 1.7 16.8 1.7 25.4s-.6 17.1-1.7 25.4l43.3 39.4c6.9 6.2 9.6 15.9 6.4 24.6c-4.4 11.9-9.7 23.3-15.8 34.3l-4.7 8.1c-6.6 11-14 21.4-22.1 31.2c-5.9 7.2-15.7 9.6-24.5 6.8l-55.7-17.7c-13.4 10.3-28.2 18.9-44 25.4l-12.5 57.1c-2 9.1-9 16.3-18.2 17.8c-13.8 2.3-28 3.5-42.5 3.5s-28.7-1.2-42.5-3.5c-9.2-1.5-16.2-8.7-18.2-17.8l-12.5-57.1c-15.8-6.5-30.6-15.1-44-25.4L83.1 425.9c-8.8 2.8-18.6 .3-24.5-6.8c-8.1-9.8-15.5-20.2-22.1-31.2l-4.7-8.1c-6.1-11-11.4-22.4-15.8-34.3c-3.2-8.7-.5-18.4 6.4-24.6l43.3-39.4C64.6 273.1 64 264.6 64 256s.6-17.1 1.7-25.4L22.4 191.2c-6.9-6.2-9.6-15.9-6.4-24.6c4.4-11.9 9.7-23.3 15.8-34.3l4.7-8.1c6.6-11 14-21.4 22.1-31.2c5.9-7.2 15.7-9.6 24.5-6.8l55.7 17.7c13.4-10.3 28.2-18.9 44-25.4l12.5-57.1c2-9.1 9-16.3 18.2-17.8C227.3 1.2 241.5 0 256 0s28.7 1.2 42.5 3.5c9.2 1.5 16.2 8.7 18.2 17.8l12.5 57.1c15.8 6.5 30.6 15.1 44 25.4l55.7-17.7c8.8-2.8 18.6-.3 24.5 6.8c8.1 9.8 15.5 20.2 22.1 31.2l4.7 8.1c6.1 11 11.4 22.4 15.8 34.3zM256 336a80 80 0 1 0 0-160 80 80 0 1 0 0 160z" > < / path > < / svg > Settings > Registries< / strong > .< / p >
< / li >
< li >
< p > In your registry line, click < strong > Configure< / strong > .< / p >
< / li >
< li >
< p > Enter your registry credentials:< / p >
< p > < img decoding = "async" loading = "lazy" alt = "Authenticating to a pre-configured registry" src = "/assets/images/authenticating-to-a-preconfigured-registry-12cf722d1b380d17ae90e8129d31a981.png" width = "933" height = "431" class = "img_SS3x" > < / p >
< ol >
< li > < strong > Username< / strong > : Enter your user name.< / li >
< li > < strong > Password< / strong > : Enter your password or OAuth secret.< / li >
< li > Click < strong > Login< / strong > .< / li >
< / ol >
< / li >
< / ol >
< p > Podman Desktop logs Podman in with the provided credentials.< / p >
< p > If you enter the wrong credentials, you see an error message:< / p >
< ol >
< li > Enter the correct credentials< / li >
< li > Click < strong > Login< / strong > again.< / li >
< / ol >
2024-08-14 11:49:56 +00:00
< h2 class = "anchor anchorWithStickyNavbar_JmGV" id = "setting-up-a-custom-registry" > Setting up a custom registry< a href = "#setting-up-a-custom-registry" class = "hash-link" aria-label = "Direct link to Setting up a custom registry" title = "Direct link to Setting up a custom registry" > < / a > < / h2 >
2024-03-04 10:44:38 +00:00
< p > You have a custom container registry, or one that is not available in the pre-configured list: we have got you covered. Follow the steps:< / p >
< ol >
< li >
< p > Go to < strong > < svg aria-hidden = "true" focusable = "false" data-prefix = "fas" data-icon = "gear" class = "svg-inline--fa fa-gear fa-lg" role = "img" xmlns = "http://www.w3.org/2000/svg" viewBox = "0 0 512 512" > < path fill = "currentColor" d = "M495.9 166.6c3.2 8.7 .5 18.4-6.4 24.6l-43.3 39.4c1.1 8.3 1.7 16.8 1.7 25.4s-.6 17.1-1.7 25.4l43.3 39.4c6.9 6.2 9.6 15.9 6.4 24.6c-4.4 11.9-9.7 23.3-15.8 34.3l-4.7 8.1c-6.6 11-14 21.4-22.1 31.2c-5.9 7.2-15.7 9.6-24.5 6.8l-55.7-17.7c-13.4 10.3-28.2 18.9-44 25.4l-12.5 57.1c-2 9.1-9 16.3-18.2 17.8c-13.8 2.3-28 3.5-42.5 3.5s-28.7-1.2-42.5-3.5c-9.2-1.5-16.2-8.7-18.2-17.8l-12.5-57.1c-15.8-6.5-30.6-15.1-44-25.4L83.1 425.9c-8.8 2.8-18.6 .3-24.5-6.8c-8.1-9.8-15.5-20.2-22.1-31.2l-4.7-8.1c-6.1-11-11.4-22.4-15.8-34.3c-3.2-8.7-.5-18.4 6.4-24.6l43.3-39.4C64.6 273.1 64 264.6 64 256s.6-17.1 1.7-25.4L22.4 191.2c-6.9-6.2-9.6-15.9-6.4-24.6c4.4-11.9 9.7-23.3 15.8-34.3l4.7-8.1c6.6-11 14-21.4 22.1-31.2c5.9-7.2 15.7-9.6 24.5-6.8l55.7 17.7c13.4-10.3 28.2-18.9 44-25.4l12.5-57.1c2-9.1 9-16.3 18.2-17.8C227.3 1.2 241.5 0 256 0s28.7 1.2 42.5 3.5c9.2 1.5 16.2 8.7 18.2 17.8l12.5 57.1c15.8 6.5 30.6 15.1 44 25.4l55.7-17.7c8.8-2.8 18.6-.3 24.5 6.8c8.1 9.8 15.5 20.2 22.1 31.2l4.7 8.1c6.1 11 11.4 22.4 15.8 34.3zM256 336a80 80 0 1 0 0-160 80 80 0 1 0 0 160z" > < / path > < / svg > Settings > Registries< / strong > .< / p >
< / li >
< li >
2024-07-17 15:59:50 +00:00
< p > Click < strong > < svg aria-hidden = "true" focusable = "false" data-prefix = "fas" data-icon = "circle-plus" class = "svg-inline--fa fa-circle-plus fa-lg" role = "img" xmlns = "http://www.w3.org/2000/svg" viewBox = "0 0 512 512" > < path fill = "currentColor" d = "M256 512A256 256 0 1 0 256 0a256 256 0 1 0 0 512zM232 344l0-64-64 0c-13.3 0-24-10.7-24-24s10.7-24 24-24l64 0 0-64c0-13.3 10.7-24 24-24s24 10.7 24 24l0 64 64 0c13.3 0 24 10.7 24 24s-10.7 24-24 24l-64 0 0 64c0 13.3-10.7 24-24 24s-24-10.7-24-24z" > < / path > < / svg > Add registry< / strong > at the top right corner of the screen.< / p >
2024-03-04 10:44:38 +00:00
< / li >
< li >
< p > Enter your registry details:< / p >
< p > < img decoding = "async" loading = "lazy" alt = "Adding a custom registry" src = "/assets/images/adding-a-custom-registry-df276b8cd69d722de97670c7eef8b235.png" width = "933" height = "501" class = "img_SS3x" > < / p >
< ol >
< li > < strong > Registry Location< / strong > : Enter your repository URL, such as < code > https://myregistry.tld< / code > .< / li >
< li > < strong > Username< / strong > : Enter your user name.< / li >
< li > < strong > Password< / strong > : Enter your password or OAuth secret.< / li >
< li > Click < strong > Login< / strong > .< / li >
< / ol >
< / li >
< / ol >
< p > Podman Desktop logs Podman in with the provided credentials.< / p >
< p > If you enter the wrong credentials, you see an error message:< / p >
< ol >
< li > Enter the correct credentials< / li >
< li > Click < strong > Login< / strong > again.< / li >
< / ol >
2024-08-14 11:49:56 +00:00
< h2 class = "anchor anchorWithStickyNavbar_JmGV" id = "setting-up-a-registry-with-an-insecure-certificate" > Setting up a registry with an insecure certificate< a href = "#setting-up-a-registry-with-an-insecure-certificate" class = "hash-link" aria-label = "Direct link to Setting up a registry with an insecure certificate" title = "Direct link to Setting up a registry with an insecure certificate" > < / a > < / h2 >
2024-03-04 10:44:38 +00:00
< p > If your registry has an insecure certificate, such as a self-signed certificate, you see a warning when setting up the registry.< / p >
< ol >
< li >
< p > In the < strong > Invalid Certificate< / strong > window, click < strong > Yes< / strong > to add the registry anyway.< / p >
< p > < img decoding = "async" loading = "lazy" alt = "Podman Desktop Registry Warning" src = "/assets/images/registry-warning-insecure-245d7254807b5939c082f47e5d538d80.png" width = "556" height = "206" class = "img_SS3x" > < / p >
< / li >
< li >
< p > Tell Podman that it has your authorization to access the insecure registry: edit the < code > registries.conf< / code > file.< / p >
< ol >
< li >
< p > Go to a location where you can edit the < code > registries.conf< / code > file:< / p >
< div class = "tabs-container tabList_J5MA" > < ul role = "tablist" aria-orientation = "horizontal" class = "tabs" > < li role = "tab" tabindex = "0" aria-selected = "true" class = "tabs__item tabItem_l0OV tabs__item--active" > Windows< / li > < li role = "tab" tabindex = "-1" aria-selected = "false" class = "tabs__item tabItem_l0OV" > macOS< / li > < li role = "tab" tabindex = "-1" aria-selected = "false" class = "tabs__item tabItem_l0OV" > Linux< / li > < / ul > < div class = "margin-top--md" > < div role = "tabpanel" class = "tabItem_wHwb" > < ul >
< li >
< p > The configuration file is in the Podman machine: open a terminal in the Podman Machine.< / p >
< div class = "language-shell-session codeBlockContainer_mQmQ theme-code-block" style = "--prism-color:#F8F8F2;--prism-background-color:#282A36" > < div class = "codeBlockContent_D5yF" > < pre tabindex = "0" class = "prism-code language-shell-session codeBlock_RMoD thin-scrollbar" style = "color:#F8F8F2;background-color:#282A36" > < code class = "codeBlockLines_AclH" > < span class = "token-line" style = "color:#F8F8F2" > < span class = "token command shell-symbol important" > $< / span > < span class = "token command" > < / span > < span class = "token command bash language-bash" > podman machine ssh --username root [optional-machine-name]< / span > < br > < / span > < / code > < / pre > < div class = "buttonGroup_aaMX" > < button type = "button" aria-label = "Copy code to clipboard" title = "Copy" class = "clean-btn" > < span class = "copyButtonIcons_z5j7" aria-hidden = "true" > < svg viewBox = "0 0 24 24" class = "copyButtonIcon_FoOz" > < path fill = "currentColor" d = "M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z" > < / path > < / svg > < svg viewBox = "0 0 24 24" class = "copyButtonSuccessIcon_L0B6" > < path fill = "currentColor" d = "M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z" > < / path > < / svg > < / span > < / button > < / div > < / div > < / div >
< / li >
< / ul > < / div > < div role = "tabpanel" class = "tabItem_wHwb" hidden = "" > < ul >
< li >
< p > The configuration file is in the Podman machine: open a terminal in the Podman Machine.< / p >
< div class = "language-shell-session codeBlockContainer_mQmQ theme-code-block" style = "--prism-color:#F8F8F2;--prism-background-color:#282A36" > < div class = "codeBlockContent_D5yF" > < pre tabindex = "0" class = "prism-code language-shell-session codeBlock_RMoD thin-scrollbar" style = "color:#F8F8F2;background-color:#282A36" > < code class = "codeBlockLines_AclH" > < span class = "token-line" style = "color:#F8F8F2" > < span class = "token command shell-symbol important" > $< / span > < span class = "token command" > < / span > < span class = "token command bash language-bash" > podman machine ssh --username root [optional-machine-name]< / span > < br > < / span > < / code > < / pre > < div class = "buttonGroup_aaMX" > < button type = "button" aria-label = "Copy code to clipboard" title = "Copy" class = "clean-btn" > < span class = "copyButtonIcons_z5j7" aria-hidden = "true" > < svg viewBox = "0 0 24 24" class = "copyButtonIcon_FoOz" > < path fill = "currentColor" d = "M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z" > < / path > < / svg > < svg viewBox = "0 0 24 24" class = "copyButtonSuccessIcon_L0B6" > < path fill = "currentColor" d = "M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z" > < / path > < / svg > < / span > < / button > < / div > < / div > < / div >
< / li >
< / ul > < / div > < div role = "tabpanel" class = "tabItem_wHwb" hidden = "" > < ul >
< li >
< p > The configuration file is in your host: open a terminal with superuser privileges.< / p >
< div class = "language-shell-session codeBlockContainer_mQmQ theme-code-block" style = "--prism-color:#F8F8F2;--prism-background-color:#282A36" > < div class = "codeBlockContent_D5yF" > < pre tabindex = "0" class = "prism-code language-shell-session codeBlock_RMoD thin-scrollbar" style = "color:#F8F8F2;background-color:#282A36" > < code class = "codeBlockLines_AclH" > < span class = "token-line" style = "color:#F8F8F2" > < span class = "token command shell-symbol important" > $< / span > < span class = "token command" > < / span > < span class = "token command bash language-bash" > sudo su -< / span > < br > < / span > < / code > < / pre > < div class = "buttonGroup_aaMX" > < button type = "button" aria-label = "Copy code to clipboard" title = "Copy" class = "clean-btn" > < span class = "copyButtonIcons_z5j7" aria-hidden = "true" > < svg viewBox = "0 0 24 24" class = "copyButtonIcon_FoOz" > < path fill = "currentColor" d = "M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z" > < / path > < / svg > < svg viewBox = "0 0 24 24" class = "copyButtonSuccessIcon_L0B6" > < path fill = "currentColor" d = "M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z" > < / path > < / svg > < / span > < / button > < / div > < / div > < / div >
< / li >
< / ul > < / div > < / div > < / div >
< / li >
< li >
< p > Edit the registry optional configuration file.< / p >
2024-08-06 12:07:33 +00:00
< div class = "language-shell-session codeBlockContainer_mQmQ theme-code-block" style = "--prism-color:#F8F8F2;--prism-background-color:#282A36" > < div class = "codeBlockContent_D5yF" > < pre tabindex = "0" class = "prism-code language-shell-session codeBlock_RMoD thin-scrollbar" style = "color:#F8F8F2;background-color:#282A36" > < code class = "codeBlockLines_AclH" > < span class = "token-line" style = "color:#F8F8F2" > < span class = "token command shell-symbol important" > #< / span > < span class = "token command" > < / span > < span class = "token command bash language-bash" > vi /etc/containers/registries.conf< / span > < br > < / span > < / code > < / pre > < div class = "buttonGroup_aaMX" > < button type = "button" aria-label = "Copy code to clipboard" title = "Copy" class = "clean-btn" > < span class = "copyButtonIcons_z5j7" aria-hidden = "true" > < svg viewBox = "0 0 24 24" class = "copyButtonIcon_FoOz" > < path fill = "currentColor" d = "M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z" > < / path > < / svg > < svg viewBox = "0 0 24 24" class = "copyButtonSuccessIcon_L0B6" > < path fill = "currentColor" d = "M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z" > < / path > < / svg > < / span > < / button > < / div > < / div > < / div >
2024-03-04 10:44:38 +00:00
< p > For each insecure registry, add a < code > [[registry]]< / code > section that defines:< / p >
< ul >
< li > < code > location =< / code > : Enter your registry URL.< / li >
< li > < code > insecure = true< / code > : Accept the insecure certificate.< / li >
< / ul >
< p > For example, if your have two registries, such as < code > https://my-registry.tld< / code > and < code > http://registry.example.com< / code > , add the following lines:< / p >
< div class = "language-toml codeBlockContainer_mQmQ theme-code-block" style = "--prism-color:#F8F8F2;--prism-background-color:#282A36" > < div class = "codeBlockContent_D5yF" > < pre tabindex = "0" class = "prism-code language-toml codeBlock_RMoD thin-scrollbar" style = "color:#F8F8F2;background-color:#282A36" > < code class = "codeBlockLines_AclH" > < span class = "token-line" style = "color:#F8F8F2" > < span class = "token plain" > [[registry]]< / span > < br > < / span > < span class = "token-line" style = "color:#F8F8F2" > < span class = "token plain" > location = " my-registry.tld" < / span > < br > < / span > < span class = "token-line" style = "color:#F8F8F2" > < span class = "token plain" > insecure = true< / 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" > [[registry]]< / span > < br > < / span > < span class = "token-line" style = "color:#F8F8F2" > < span class = "token plain" > location = " registry.example.com" < / span > < br > < / span > < span class = "token-line" style = "color:#F8F8F2" > < span class = "token plain" > insecure = true< / span > < br > < / span > < / code > < / pre > < div class = "buttonGroup_aaMX" > < button type = "button" aria-label = "Copy code to clipboard" title = "Copy" class = "clean-btn" > < span class = "copyButtonIcons_z5j7" aria-hidden = "true" > < svg viewBox = "0 0 24 24" class = "copyButtonIcon_FoOz" > < path fill = "currentColor" d = "M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z" > < / path > < / svg > < svg viewBox = "0 0 24 24" class = "copyButtonSuccessIcon_L0B6" > < path fill = "currentColor" d = "M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z" > < / path > < / svg > < / span > < / button > < / div > < / div > < / div >
< / li >
< / ol >
< / li >
< li >
< p > Restart Podman to apply the changes.< / p >
< div class = "tabs-container tabList_J5MA" > < ul role = "tablist" aria-orientation = "horizontal" class = "tabs" > < li role = "tab" tabindex = "0" aria-selected = "true" class = "tabs__item tabItem_l0OV tabs__item--active" > Windows< / li > < li role = "tab" tabindex = "-1" aria-selected = "false" class = "tabs__item tabItem_l0OV" > macOS< / li > < li role = "tab" tabindex = "-1" aria-selected = "false" class = "tabs__item tabItem_l0OV" > Linux (rootless)< / li > < li role = "tab" tabindex = "-1" aria-selected = "false" class = "tabs__item tabItem_l0OV" > Linux (rootful)< / li > < / ul > < div class = "margin-top--md" > < div role = "tabpanel" class = "tabItem_wHwb" > < ol >
< li > Go to < strong > < svg aria-hidden = "true" focusable = "false" data-prefix = "fas" data-icon = "gear" class = "svg-inline--fa fa-gear fa-lg" role = "img" xmlns = "http://www.w3.org/2000/svg" viewBox = "0 0 512 512" > < path fill = "currentColor" d = "M495.9 166.6c3.2 8.7 .5 18.4-6.4 24.6l-43.3 39.4c1.1 8.3 1.7 16.8 1.7 25.4s-.6 17.1-1.7 25.4l43.3 39.4c6.9 6.2 9.6 15.9 6.4 24.6c-4.4 11.9-9.7 23.3-15.8 34.3l-4.7 8.1c-6.6 11-14 21.4-22.1 31.2c-5.9 7.2-15.7 9.6-24.5 6.8l-55.7-17.7c-13.4 10.3-28.2 18.9-44 25.4l-12.5 57.1c-2 9.1-9 16.3-18.2 17.8c-13.8 2.3-28 3.5-42.5 3.5s-28.7-1.2-42.5-3.5c-9.2-1.5-16.2-8.7-18.2-17.8l-12.5-57.1c-15.8-6.5-30.6-15.1-44-25.4L83.1 425.9c-8.8 2.8-18.6 .3-24.5-6.8c-8.1-9.8-15.5-20.2-22.1-31.2l-4.7-8.1c-6.1-11-11.4-22.4-15.8-34.3c-3.2-8.7-.5-18.4 6.4-24.6l43.3-39.4C64.6 273.1 64 264.6 64 256s.6-17.1 1.7-25.4L22.4 191.2c-6.9-6.2-9.6-15.9-6.4-24.6c4.4-11.9 9.7-23.3 15.8-34.3l4.7-8.1c6.6-11 14-21.4 22.1-31.2c5.9-7.2 15.7-9.6 24.5-6.8l55.7 17.7c13.4-10.3 28.2-18.9 44-25.4l12.5-57.1c2-9.1 9-16.3 18.2-17.8C227.3 1.2 241.5 0 256 0s28.7 1.2 42.5 3.5c9.2 1.5 16.2 8.7 18.2 17.8l12.5 57.1c15.8 6.5 30.6 15.1 44 25.4l55.7-17.7c8.8-2.8 18.6-.3 24.5 6.8c8.1 9.8 15.5 20.2 22.1 31.2l4.7 8.1c6.1 11 11.4 22.4 15.8 34.3zM256 336a80 80 0 1 0 0-160 80 80 0 1 0 0 160z" > < / path > < / svg > Settings > Resources< / strong > .< / li >
< li > Restart the Podman machine.< / li >
< / ol > < / div > < div role = "tabpanel" class = "tabItem_wHwb" hidden = "" > < ol >
< li > Go to < strong > < svg aria-hidden = "true" focusable = "false" data-prefix = "fas" data-icon = "gear" class = "svg-inline--fa fa-gear fa-lg" role = "img" xmlns = "http://www.w3.org/2000/svg" viewBox = "0 0 512 512" > < path fill = "currentColor" d = "M495.9 166.6c3.2 8.7 .5 18.4-6.4 24.6l-43.3 39.4c1.1 8.3 1.7 16.8 1.7 25.4s-.6 17.1-1.7 25.4l43.3 39.4c6.9 6.2 9.6 15.9 6.4 24.6c-4.4 11.9-9.7 23.3-15.8 34.3l-4.7 8.1c-6.6 11-14 21.4-22.1 31.2c-5.9 7.2-15.7 9.6-24.5 6.8l-55.7-17.7c-13.4 10.3-28.2 18.9-44 25.4l-12.5 57.1c-2 9.1-9 16.3-18.2 17.8c-13.8 2.3-28 3.5-42.5 3.5s-28.7-1.2-42.5-3.5c-9.2-1.5-16.2-8.7-18.2-17.8l-12.5-57.1c-15.8-6.5-30.6-15.1-44-25.4L83.1 425.9c-8.8 2.8-18.6 .3-24.5-6.8c-8.1-9.8-15.5-20.2-22.1-31.2l-4.7-8.1c-6.1-11-11.4-22.4-15.8-34.3c-3.2-8.7-.5-18.4 6.4-24.6l43.3-39.4C64.6 273.1 64 264.6 64 256s.6-17.1 1.7-25.4L22.4 191.2c-6.9-6.2-9.6-15.9-6.4-24.6c4.4-11.9 9.7-23.3 15.8-34.3l4.7-8.1c6.6-11 14-21.4 22.1-31.2c5.9-7.2 15.7-9.6 24.5-6.8l55.7 17.7c13.4-10.3 28.2-18.9 44-25.4l12.5-57.1c2-9.1 9-16.3 18.2-17.8C227.3 1.2 241.5 0 256 0s28.7 1.2 42.5 3.5c9.2 1.5 16.2 8.7 18.2 17.8l12.5 57.1c15.8 6.5 30.6 15.1 44 25.4l55.7-17.7c8.8-2.8 18.6-.3 24.5 6.8c8.1 9.8 15.5 20.2 22.1 31.2l4.7 8.1c6.1 11 11.4 22.4 15.8 34.3zM256 336a80 80 0 1 0 0-160 80 80 0 1 0 0 160z" > < / path > < / svg > Settings > Resources< / strong > .< / li >
< li > Restart the Podman machine.< / li >
< / ol > < / div > < div role = "tabpanel" class = "tabItem_wHwb" hidden = "" > < ul >
< li >
< p > Stop all Podman processes.< / p >
< div class = "language-shell-session codeBlockContainer_mQmQ theme-code-block" style = "--prism-color:#F8F8F2;--prism-background-color:#282A36" > < div class = "codeBlockContent_D5yF" > < pre tabindex = "0" class = "prism-code language-shell-session codeBlock_RMoD thin-scrollbar" style = "color:#F8F8F2;background-color:#282A36" > < code class = "codeBlockLines_AclH" > < span class = "token-line" style = "color:#F8F8F2" > < span class = "token command shell-symbol important" > $< / span > < span class = "token command" > < / span > < span class = "token command bash language-bash" > pkill podman< / span > < br > < / span > < / code > < / pre > < div class = "buttonGroup_aaMX" > < button type = "button" aria-label = "Copy code to clipboard" title = "Copy" class = "clean-btn" > < span class = "copyButtonIcons_z5j7" aria-hidden = "true" > < svg viewBox = "0 0 24 24" class = "copyButtonIcon_FoOz" > < path fill = "currentColor" d = "M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z" > < / path > < / svg > < svg viewBox = "0 0 24 24" class = "copyButtonSuccessIcon_L0B6" > < path fill = "currentColor" d = "M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z" > < / path > < / svg > < / span > < / button > < / div > < / div > < / div >
< / li >
< / ul > < / div > < div role = "tabpanel" class = "tabItem_wHwb" hidden = "" > < ul >
< li >
< p > Restart Podman.< / p >
< div class = "language-shell-session codeBlockContainer_mQmQ theme-code-block" style = "--prism-color:#F8F8F2;--prism-background-color:#282A36" > < div class = "codeBlockContent_D5yF" > < pre tabindex = "0" class = "prism-code language-shell-session codeBlock_RMoD thin-scrollbar" style = "color:#F8F8F2;background-color:#282A36" > < code class = "codeBlockLines_AclH" > < span class = "token-line" style = "color:#F8F8F2" > < span class = "token command shell-symbol important" > $< / span > < span class = "token command" > < / span > < span class = "token command bash language-bash" > sudo systemctl restart podman< / span > < br > < / span > < / code > < / pre > < div class = "buttonGroup_aaMX" > < button type = "button" aria-label = "Copy code to clipboard" title = "Copy" class = "clean-btn" > < span class = "copyButtonIcons_z5j7" aria-hidden = "true" > < svg viewBox = "0 0 24 24" class = "copyButtonIcon_FoOz" > < path fill = "currentColor" d = "M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z" > < / path > < / svg > < svg viewBox = "0 0 24 24" class = "copyButtonSuccessIcon_L0B6" > < path fill = "currentColor" d = "M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z" > < / path > < / svg > < / span > < / button > < / div > < / div > < / div >
< / li >
< / ul > < / div > < / div > < / div >
< / li >
< / ol >
2024-08-14 11:49:56 +00:00
< h2 class = "anchor anchorWithStickyNavbar_JmGV" id = "verifying-your-registry-setup" > Verifying your registry setup< a href = "#verifying-your-registry-setup" class = "hash-link" aria-label = "Direct link to Verifying your registry setup" title = "Direct link to Verifying your registry setup" > < / a > < / h2 >
2024-03-04 10:44:38 +00:00
< p > To verify your registry has been properly configured, you can do the following steps:< / p >
< ol >
< li >
< p > In < strong > < svg aria-hidden = "true" focusable = "false" data-prefix = "fas" data-icon = "gear" class = "svg-inline--fa fa-gear fa-lg" role = "img" xmlns = "http://www.w3.org/2000/svg" viewBox = "0 0 512 512" > < path fill = "currentColor" d = "M495.9 166.6c3.2 8.7 .5 18.4-6.4 24.6l-43.3 39.4c1.1 8.3 1.7 16.8 1.7 25.4s-.6 17.1-1.7 25.4l43.3 39.4c6.9 6.2 9.6 15.9 6.4 24.6c-4.4 11.9-9.7 23.3-15.8 34.3l-4.7 8.1c-6.6 11-14 21.4-22.1 31.2c-5.9 7.2-15.7 9.6-24.5 6.8l-55.7-17.7c-13.4 10.3-28.2 18.9-44 25.4l-12.5 57.1c-2 9.1-9 16.3-18.2 17.8c-13.8 2.3-28 3.5-42.5 3.5s-28.7-1.2-42.5-3.5c-9.2-1.5-16.2-8.7-18.2-17.8l-12.5-57.1c-15.8-6.5-30.6-15.1-44-25.4L83.1 425.9c-8.8 2.8-18.6 .3-24.5-6.8c-8.1-9.8-15.5-20.2-22.1-31.2l-4.7-8.1c-6.1-11-11.4-22.4-15.8-34.3c-3.2-8.7-.5-18.4 6.4-24.6l43.3-39.4C64.6 273.1 64 264.6 64 256s.6-17.1 1.7-25.4L22.4 191.2c-6.9-6.2-9.6-15.9-6.4-24.6c4.4-11.9 9.7-23.3 15.8-34.3l4.7-8.1c6.6-11 14-21.4 22.1-31.2c5.9-7.2 15.7-9.6 24.5-6.8l55.7 17.7c13.4-10.3 28.2-18.9 44-25.4l12.5-57.1c2-9.1 9-16.3 18.2-17.8C227.3 1.2 241.5 0 256 0s28.7 1.2 42.5 3.5c9.2 1.5 16.2 8.7 18.2 17.8l12.5 57.1c15.8 6.5 30.6 15.1 44 25.4l55.7-17.7c8.8-2.8 18.6-.3 24.5 6.8c8.1 9.8 15.5 20.2 22.1 31.2l4.7 8.1c6.1 11 11.4 22.4 15.8 34.3zM256 336a80 80 0 1 0 0-160 80 80 0 1 0 0 160z" > < / path > < / svg > Settings > Registries< / strong > , the line with your registry has content in the Username and Password column, and action icons replacing the Configure button.< / p >
< / li >
< li >
< p > Pull a private image from the registry.< / p >
< ol >
< li > Get the name of a private image stored in your registry, such as < code > quay.io/my-repository/my-image< / code > , < code > ghcr.io/my-repository/my-image< / code > , < code > docker.io/my-repository/my-image< / code > , or < code > my-registry.tld/my-repository/my-image< / code > .< / li >
< li > Go to < strong > Images< / strong > .< / li >
< li > Click < strong > Pull an image< / strong > .< / li >
< li > On the < strong > Image to Pull< / strong > screen:<!-- -->
< ol >
< li > < strong > Image to pull< / strong > : Enter the image name.< / li >
< li > Click Pull image.< / li >
< / ol >
< / li >
< li > Click Done.< / li >
< / ol >
< / li >
< li >
< p > Push an image to the registry:< / p >
< ol >
< li >
< p > Get the fully qualified image name that your registry requires, such as < code > quay.io/my-repository/my-image< / code > , < code > ghcr.io/my-repository/my-image< / code > , or < code > docker.io/my-repository/my-image< / code > .< / p >
< / li >
< li >
< p > Go to < strong > Images< / strong > .< / p >
< / li >
< li >
< p > Click < strong > Build an image< / strong > .< / p >
< / li >
< li >
< p > On the < strong > Build Image from Containerfile< / strong > screen< / p >
< ol >
< li > < strong > Containerfile path< / strong > : select the Containerfile or Dockerfile to build.< / li >
< li > < strong > Image Name< / strong > : enter the fully qualified image name that your registry requires.< / li >
< li > Click Build.< / li >
< li > Click Done.< / li >
< / ol >
< / li >
< li >
< p > On your image line, click < strong > < svg aria-hidden = "true" focusable = "false" data-prefix = "fas" data-icon = "ellipsis-vertical" class = "svg-inline--fa fa-ellipsis-vertical fa-lg" role = "img" xmlns = "http://www.w3.org/2000/svg" viewBox = "0 0 128 512" > < path fill = "currentColor" d = "M64 360a56 56 0 1 0 0 112 56 56 0 1 0 0-112zm0-160a56 56 0 1 0 0 112 56 56 0 1 0 0-112zM120 96A56 56 0 1 0 8 96a56 56 0 1 0 112 0z" > < / path > < / svg > < / strong > .< / p >
< p > The contextual menu has a < strong > Push Image to < em > your registry< / em > < / strong > entry.< / p >
< / li >
< / ol >
< / li >
< / ol >
2024-08-14 11:49:56 +00:00
< h2 class = "anchor anchorWithStickyNavbar_JmGV" id = "changing-your-credentials" > Changing your credentials< a href = "#changing-your-credentials" class = "hash-link" aria-label = "Direct link to Changing your credentials" title = "Direct link to Changing your credentials" > < / a > < / h2 >
2024-03-04 10:44:38 +00:00
< p > To change your registry credentials, you can do the following steps:< / p >
< ol >
< li > Go to < strong > < svg aria-hidden = "true" focusable = "false" data-prefix = "fas" data-icon = "gear" class = "svg-inline--fa fa-gear fa-lg" role = "img" xmlns = "http://www.w3.org/2000/svg" viewBox = "0 0 512 512" > < path fill = "currentColor" d = "M495.9 166.6c3.2 8.7 .5 18.4-6.4 24.6l-43.3 39.4c1.1 8.3 1.7 16.8 1.7 25.4s-.6 17.1-1.7 25.4l43.3 39.4c6.9 6.2 9.6 15.9 6.4 24.6c-4.4 11.9-9.7 23.3-15.8 34.3l-4.7 8.1c-6.6 11-14 21.4-22.1 31.2c-5.9 7.2-15.7 9.6-24.5 6.8l-55.7-17.7c-13.4 10.3-28.2 18.9-44 25.4l-12.5 57.1c-2 9.1-9 16.3-18.2 17.8c-13.8 2.3-28 3.5-42.5 3.5s-28.7-1.2-42.5-3.5c-9.2-1.5-16.2-8.7-18.2-17.8l-12.5-57.1c-15.8-6.5-30.6-15.1-44-25.4L83.1 425.9c-8.8 2.8-18.6 .3-24.5-6.8c-8.1-9.8-15.5-20.2-22.1-31.2l-4.7-8.1c-6.1-11-11.4-22.4-15.8-34.3c-3.2-8.7-.5-18.4 6.4-24.6l43.3-39.4C64.6 273.1 64 264.6 64 256s.6-17.1 1.7-25.4L22.4 191.2c-6.9-6.2-9.6-15.9-6.4-24.6c4.4-11.9 9.7-23.3 15.8-34.3l4.7-8.1c6.6-11 14-21.4 22.1-31.2c5.9-7.2 15.7-9.6 24.5-6.8l55.7 17.7c13.4-10.3 28.2-18.9 44-25.4l12.5-57.1c2-9.1 9-16.3 18.2-17.8C227.3 1.2 241.5 0 256 0s28.7 1.2 42.5 3.5c9.2 1.5 16.2 8.7 18.2 17.8l12.5 57.1c15.8 6.5 30.6 15.1 44 25.4l55.7-17.7c8.8-2.8 18.6-.3 24.5 6.8c8.1 9.8 15.5 20.2 22.1 31.2l4.7 8.1c6.1 11 11.4 22.4 15.8 34.3zM256 336a80 80 0 1 0 0-160 80 80 0 1 0 0 160z" > < / path > < / svg > Settings > Registries< / strong > .< / li >
< li > On your registry line, click < strong > < svg aria-hidden = "true" focusable = "false" data-prefix = "fas" data-icon = "ellipsis-vertical" class = "svg-inline--fa fa-ellipsis-vertical fa-lg" role = "img" xmlns = "http://www.w3.org/2000/svg" viewBox = "0 0 128 512" > < path fill = "currentColor" d = "M64 360a56 56 0 1 0 0 112 56 56 0 1 0 0-112zm0-160a56 56 0 1 0 0 112 56 56 0 1 0 0-112zM120 96A56 56 0 1 0 8 96a56 56 0 1 0 112 0z" > < / path > < / svg > < / strong > .< / li >
< li > Click < strong > Edit password< / strong > .< / li >
< li > Enter your credentials in the < strong > Username< / strong > and < strong > Password< / strong > fields, and click < strong > Login< / strong > .< / li >
< / ol >
< p > Podman Desktop logs Podman in with the updated credentials.< / p >
2024-08-14 11:49:56 +00:00
< h2 class = "anchor anchorWithStickyNavbar_JmGV" id = "removing-a-registry" > Removing a registry< a href = "#removing-a-registry" class = "hash-link" aria-label = "Direct link to Removing a registry" title = "Direct link to Removing a registry" > < / a > < / h2 >
2024-03-04 10:44:38 +00:00
< p > To remove your registry, you can do the following steps:< / p >
< ol >
< li > Go to < strong > < svg aria-hidden = "true" focusable = "false" data-prefix = "fas" data-icon = "gear" class = "svg-inline--fa fa-gear fa-lg" role = "img" xmlns = "http://www.w3.org/2000/svg" viewBox = "0 0 512 512" > < path fill = "currentColor" d = "M495.9 166.6c3.2 8.7 .5 18.4-6.4 24.6l-43.3 39.4c1.1 8.3 1.7 16.8 1.7 25.4s-.6 17.1-1.7 25.4l43.3 39.4c6.9 6.2 9.6 15.9 6.4 24.6c-4.4 11.9-9.7 23.3-15.8 34.3l-4.7 8.1c-6.6 11-14 21.4-22.1 31.2c-5.9 7.2-15.7 9.6-24.5 6.8l-55.7-17.7c-13.4 10.3-28.2 18.9-44 25.4l-12.5 57.1c-2 9.1-9 16.3-18.2 17.8c-13.8 2.3-28 3.5-42.5 3.5s-28.7-1.2-42.5-3.5c-9.2-1.5-16.2-8.7-18.2-17.8l-12.5-57.1c-15.8-6.5-30.6-15.1-44-25.4L83.1 425.9c-8.8 2.8-18.6 .3-24.5-6.8c-8.1-9.8-15.5-20.2-22.1-31.2l-4.7-8.1c-6.1-11-11.4-22.4-15.8-34.3c-3.2-8.7-.5-18.4 6.4-24.6l43.3-39.4C64.6 273.1 64 264.6 64 256s.6-17.1 1.7-25.4L22.4 191.2c-6.9-6.2-9.6-15.9-6.4-24.6c4.4-11.9 9.7-23.3 15.8-34.3l4.7-8.1c6.6-11 14-21.4 22.1-31.2c5.9-7.2 15.7-9.6 24.5-6.8l55.7 17.7c13.4-10.3 28.2-18.9 44-25.4l12.5-57.1c2-9.1 9-16.3 18.2-17.8C227.3 1.2 241.5 0 256 0s28.7 1.2 42.5 3.5c9.2 1.5 16.2 8.7 18.2 17.8l12.5 57.1c15.8 6.5 30.6 15.1 44 25.4l55.7-17.7c8.8-2.8 18.6-.3 24.5 6.8c8.1 9.8 15.5 20.2 22.1 31.2l4.7 8.1c6.1 11 11.4 22.4 15.8 34.3zM256 336a80 80 0 1 0 0-160 80 80 0 1 0 0 160z" > < / path > < / svg > Settings > Registries< / strong > .< / li >
< li > On your registry line, click < strong > < svg aria-hidden = "true" focusable = "false" data-prefix = "fas" data-icon = "ellipsis-vertical" class = "svg-inline--fa fa-ellipsis-vertical fa-lg" role = "img" xmlns = "http://www.w3.org/2000/svg" viewBox = "0 0 128 512" > < path fill = "currentColor" d = "M64 360a56 56 0 1 0 0 112 56 56 0 1 0 0-112zm0-160a56 56 0 1 0 0 112 56 56 0 1 0 0-112zM120 96A56 56 0 1 0 8 96a56 56 0 1 0 112 0z" > < / path > < / svg > < / strong > .< / li >
< li > Click Remove.< / li >
< / ol >
< p > Podman Desktop removes the registry from the settings, and logs Podman out from the registry.< / p >
2024-08-14 11:49:56 +00:00
< h2 class = "anchor anchorWithStickyNavbar_JmGV" id = "finding-podman-registry-configuration-files" > Finding Podman registry configuration files< a href = "#finding-podman-registry-configuration-files" class = "hash-link" aria-label = "Direct link to Finding Podman registry configuration files" title = "Direct link to Finding Podman registry configuration files" > < / a > < / h2 >
2024-03-04 10:44:38 +00:00
< p > Podman has two files to configure registries:< / p >
< ul >
< li >
< p > < code > auth.json< / code > defines the authentication to registries.< / p >
< p > Podman Desktop stores this file directly on your host, in < code > $HOME/.config/containers/auth.json< / code > .< / p >
< p > The Podman machine mounts the authentication configuration file to access it.< / p >
< p > When you delete the Podman machine, the registry configuration is not lost: it stays on your host.< / p >
< / li >
< li >
< p > < code > registries.conf< / code > defines optional features, such as allowing insecure certificates.< / p >
< p > The Podman machine stores the file in < code > /etc/containers/registries.conf< / code > .< / p >
< p > When you delete the Podman machine, this file is deleted.< / p >
< / li >
< / ul >
2024-08-14 11:49:56 +00:00
< h2 class = "anchor anchorWithStickyNavbar_JmGV" id = "next-steps" > Next steps< a href = "#next-steps" class = "hash-link" aria-label = "Direct link to Next steps" title = "Direct link to Next steps" > < / a > < / h2 >
2024-03-04 10:44:38 +00:00
< p > Consider completing some other common tasks that depend registries:< / p >
< ul >
< li > Pulling an image.< / li >
< li > Pushing an image to a registry.< / li >
2024-08-14 11:49:56 +00:00
< / ul > < / 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 class = "tag_otG2 tagRegular_s0E1" href = "/docs/tags/podman-desktop" > podman-desktop< / a > < / li > < li class = "tag_DFxh" > < a class = "tag_otG2 tagRegular_s0E1" href = "/docs/tags/containers" > containers< / a > < / li > < / ul > < / div > < / div > < div class = "row margin-top--sm theme-doc-footer-edit-meta-row" > < div class = "col" > < a href = "https://github.com/containers/podman-desktop/tree/main/website/docs/containers/registries/index.md" target = "_blank" rel = "noopener noreferrer" class = "theme-edit-this-page" > < svg fill = "currentColor" height = "20" width = "20" viewBox = "0 0 40 40" class = "iconEdit_bHB7" aria-hidden = "true" > < g > < path d = "m34.5 11.7l-3 3.1-6.3-6.3 3.1-3q0.5-0.5 1.2-0.5t1.1 0.5l3.9 3.9q0.5 0.4 0.5 1.1t-0.5 1.2z m-29.5 17.1l18.4-18.5 6.3 6.3-18.4 18.4h-6.3v-6.2z" > < / path > < / g > < / svg > Edit this page< / a > < / div > < div class = "col lastUpdated_ydrU" > < / div > < / div > < / footer > < / article > < nav class = "pagination-nav docusaurus-mt-lg" aria-label = "Docs pages" > < a class = "pagination-nav__link pagination-nav__link--prev" href = "/docs/containers/onboarding" > < div class = "pagination-nav__sublabel" > Previous< / div > < div class = "pagination-nav__label" > Onboarding for containers< / div > < / a > < a class = "pagination-nav__link pagination-nav__link--next" href = "/docs/containers/images" > < div class = "pagination-nav__sublabel" > Next< / div > < div class = "pagination-nav__label" > Images< / 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 = "#setting-up-a-pre-configured-registry" class = "table-of-contents__link toc-highlight" > Setting up a pre-configured registry< / a > < / li > < li > < a href = "#setting-up-a-custom-registry" class = "table-of-contents__link toc-highlight" > Setting up a custom registry< / a > < / li > < li > < a href = "#setting-up-a-registry-with-an-insecure-certificate" class = "table-of-contents__link toc-highlight" > Setting up a registry with an insecure certificate< / a > < / li > < li > < a href = "#verifying-your-registry-setup" class = "table-of-contents__link toc-highlight" > Verifying your registry setup< / a > < / li > < li > < a href = "#changing-your-credentials" class = "table-of-contents__link toc-highlight" > Changing your credentials< / a > < / li > < li > < a href = "#removing-a-registry" class = "table-of-contents__link toc-highlight" > Removing a registry< / a > < / li > < li > < a href = "#finding-podman-registry-configuration-files" class = "table-of-contents__link toc-highlight" > Finding Podman registry configuration files< / a > < / li > < li > < a href = "#next-steps" class = "table-of-contents__link toc-highlight" > Next steps< / a > < / li > < / ul > < / div > < / div > < / div > < / div > < / main > < / div > < / div > < / div > < footer class = "footer" > < div class = "container container-fluid" > < div class = "row footer__links" > < div class = "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 = "col footer__col" > < div class = "footer__title" > Links< / div > < ul class = "footer__items clean-list" > < li class = "footer__item" > < a href = "https://github.com/containers/podman-desktop" target = "_blank" rel = "noopener noreferrer" class = "footer__link-item" > GitHub< svg width = "13.5" height = "13.5" aria-hidden = "true" viewBox = "0 0 24 24" class = "iconExternalLink_nPrP" > < 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" > < / path > < / svg > < / a > < / li > < li class = "footer__item" > < a href = "https://discord.com/invite/x5GzFF6QH4" target = "_blank" rel =
2024-03-04 10:44:38 +00:00
< / body >
< / html >
