<titledata-rh="true">macOS and Windows | 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/docs/proxy/using-a-proxy"><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-default-current"><metadata-rh="true"name="docsearch:version"content="current"><metadata-rh="true"name="docsearch:docusaurus_tag"content="docs-default-current"><metadata-rh="true"property="og:title"content="macOS and Windows | Podman Desktop"><metadata-rh="true"name="description"content="Using Podman Desktop behind a proxy on macOS and Windows."><metadata-rh="true"property="og:description"content="Using Podman Desktop behind a proxy on macOS and Windows."><metadata-rh="true"name="keywords"content="podman desktop,containers,podman,proxy,windows,macos"><linkdata-rh="true"rel="icon"href="/img/favicon.ico"><linkdata-rh="true"rel="canonical"href="https://podman-desktop.io/docs/proxy/using-a-proxy"><linkdata-rh="true"rel="alternate"href="https://podman-desktop.io/docs/proxy/using-a-proxy"hreflang="en"><linkdata-rh="true"rel="alternate"href="https://podman-desktop.io/docs/proxy/using-a-proxy"hreflang="x-default"><linkdata-rh="true"rel="preconnect"href="https://MR01ANKQ9S-dsn.algolia.net"crossorigin="anonymous"><linkrel="alternate"type="application/rss+xml"href="/blog/rss.xml"title="Podman Desktop RSS Feed">
The configuration applies to the Podman engine, but not to your containers.</p><h4class="anchor anchorWithStickyNavbar_JmGV"id="prerequisites">Prerequisites<ahref="#prerequisites"class="hash-link"aria-label="Direct link to Prerequisites"title="Direct link to Prerequisites"></a></h4><ul><li>Your proxy URL: <code><your.proxy.tld:port></code>.</li><li>Your proxy does not require a custom Certificate Authorities. Else see <ahref="/docs/proxy/using-a-proxy-requiring-a-custom-ca">Using a proxy requiring a custom Certificate Authorities</a>.</li></ul><h4class="anchor anchorWithStickyNavbar_JmGV"id="procedure">Procedure<ahref="#procedure"class="hash-link"aria-label="Direct link to Procedure"title="Direct link to Procedure"></a></h4><ol><li><p>Go to <strong>Settings > Proxy</strong>, and set your proxy URL:</p><ol><li><strong>Proxy configuration enabled</strong>: yes</li><li><strong>Web Proxy (HTTP)</strong>: <code><your.proxy.tld:port></code></li><li><strong>Secure Web Proxy (HTTPS)</strong>: <code><your.proxy.tld:port></code></li><li>Click the <strong>Update</strong> button</li></ol></li><li><p>Go to <strong>Settings > Resources</strong> and restart the Podman machine.</p></li></ol><h4class="anchor anchorWithStickyNavbar_JmGV"id="verification">Verification<ahref="#verification"class="hash-link"aria-label="Direct link to Verification"title="Direct link to Verification"></a></h4><ol><li>Go to <strong>Images</strong>.</li><li>Click <strong>Pull an image</strong>.</li><li><strong>Image to Pull</strong>: <code>bash</code></li><li>Click <strong>Pull image</strong>.</li><li>Podman Desktop reports <code>Download complete</code>.</li></ol></div><footerclass="theme-doc-footer docusaurus-mt-lg"><divclass="theme-doc-footer-tags-row row margin-bottom--sm"><divclass="col"><b>Tags:</b><ulclass="tags_Ow0B padding--none margin-left--sm"><liclass="tag_DFxh"><aclass="tag_otG2 tagRegular_s0E1"href="/docs/tags/podman-desktop">podman-desktop</a></li><liclass="tag_DFxh"><aclass="tag_otG2 tagRegular_s0E1"href="/docs/tags/proxy">proxy</a></li><liclass="tag_DFxh"><aclass="tag_otG2 tagRegular_s0E1"href="/docs/tags/windows">windows</a></li><liclass="tag_DFxh"><aclass="tag_otG2 tagRegular_s0E1"href="/docs/tags/macos">macos</a></li></ul></div></div><divclass="theme-doc-footer-edit-meta-row row"><divclass="col"><ahref="https://github.com/containers/podman-desktop/tree/main/website/docs/proxy/using-a-proxy.md"target="_blank"rel="noreferrer noopener"class="theme-edit-this-page"><svgfill="currentColor"height="20"width="20"viewBox="0 0 40 40"class="iconEdit_bHB7"aria-hidden="true"><g><pathd="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><divclass="col lastUpdated_pbO5"></div></div></footer></article><navclass="pagination-nav docusaurus-mt-lg"aria-label="Docs pages"><aclass="pagination-nav__link pagination-nav__link--prev"href="/docs/proxy"><divclass="pagination-nav__sublabel">Previous</div><divclass="pagination-nav__label">Using behind a proxy</div></a><aclass="pagination-nav__link pagination-nav__link--next"href="/docs/proxy/using-a-proxy-requiring-a-custom-ca"><divclass="pagination-nav__sublabel">Next</div><divclass="pagination-nav__label">Custom Certificate Authorities</div></a></nav></div></div><divclass="col col--3"><divclass="tableOfContents_XG6w thin-scrollbar theme-doc-toc-desktop"></div></div></div></div></main></div></div><footerclass="footer"><divclass="container container-fluid"><divclass="row footer__links"><divclass="col footer__col"><divclass="footer__title">Documentation</div><ulclass="footer__items clean-list"><liclass="footer__item"><aclass="footer__link-item"href="/docs/intro">Introduction</a></li><liclass="footer__item"><aclass="footer__link-item"href="/docs/Installation">Installing Podman Desktop</a></li><liclass="footer__item"><aclass="footer__link-item"href="/docs/getting-started/getting-started">