<titledata-rh="true">Testcontainers with Podman | 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/testcontainers-with-podman"><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="Testcontainers with Podman | Podman Desktop"><metadata-rh="true"name="description"content="Learn how to use Testcontainers with Podman and how to create basic tests using Testcontainers technology!"><metadata-rh="true"property="og:description"content="Learn how to use Testcontainers with Podman and how to create basic tests using Testcontainers technology!"><metadata-rh="true"name="keywords"content="podman,podman-desktop,containers,testcontainers"><linkdata-rh="true"rel="icon"href="/img/favicon.ico"><linkdata-rh="true"rel="canonical"href="https://podman-desktop.io/tutorial/testcontainers-with-podman"><linkdata-rh="true"rel="alternate"href="https://podman-desktop.io/tutorial/testcontainers-with-podman"hreflang="en"><linkdata-rh="true"rel="alternate"href="https://podman-desktop.io/tutorial/testcontainers-with-podman"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">
<linkrel="alternate"type="application/atom+xml"href="/blog/atom.xml"title="Podman Desktop Atom Feed">
<script>!function(){functiont(t){document.documentElement.setAttribute("data-theme",t)}vare=function(){try{returnnewURLSearchParams(window.location.search).get("docusaurus-theme")}catch(t){}}()||function(){try{returnwindow.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{constc=newURLSearchParams(window.location.search).entries();for(var[t,e]ofc)if(t.startsWith("docusaurus-data-")){vara=t.replace("docusaurus-data-","data-");document.documentElement.setAttribute(a,e)}}catch(t){}}()</script><divid="__docusaurus"><divrole="region"aria-label="Skip to main content"><aclass="skipToContent_oPtH"href="#__docusaurus_skipToContent_fallback">Skip to main content</a></div><navaria-label="Main"class="navbar navbar--fixed-top"><divclass="navbar__inner"><divclass="navbar__items"><buttonaria-label="Toggle navigation bar"aria-expanded="false"class="navbar__toggle clean-btn"type="button"><svgwidth="30"height="30"viewBox="0 0 30 30"aria-hidden="true"><pathstroke="currentColor"stroke-linecap="round"stroke-miterlimit="10"stroke-width="2"d="M4 7h22M4 15h22M4 23h22"></path></svg></button><aclass="navbar__brand"href="/"><divclass="navbar__logo"><imgsrc="/img/logo.svg"alt="Podman Desktop Logo"class="themedComponent_siVc themedComponent--light_hHel"height="56"><imgsrc="/img/logo.svg"alt="Podman Desktop Logo"class="themedComponent_siVc themedComponent--dark_yETr"height="56"></div><bclass="navbar__title text--truncate">podman desktop</b></a><aclass="navbar__item navbar__link"href="/docs/intro">Documentation</a><aclass="navbar__item navbar__link"href="/features">Features</a><aclass="navbar__item navbar__link"href="/downloads">Downloads</a><aclass="navbar__item navbar__link"href="/extend">Extend</a><aclass="navbar__item navbar__link"href="/blog">Blog</a><aaria-current="page"class="navbar__item navbar__link navbar__link--active"href="/tutorial">Tutorials</a></div><divclass="navbar__items navbar__items--right"><ahref="https://github.com/podman-desktop/podman-desktop"target="_blank"rel="noopener noreferrer"class="navbar__item navbar__link header-github-link"></a><divclass="toggle_ki11 colorModeToggle_Hewu"><buttonclass="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"aria-pressed="true"><svgviewBox="0 0 24 24"width="24"height="24"class="lightToggleIcon_lgto"><pathfill="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><svgviewBox="0 0 24 24"width="24"height="24"class="darkToggleIcon_U96C"><pathfill="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,19c-3.86,0-7-3.14-7-7C5,9.07,6.81,6.55,9.37,5.51zM12,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.36c-0.98,1.37-2.58,2.
<header><h1>What are Testcontainers</h1></header>
<p><ahref="https://testcontainers.com/"target="_blank"rel="noopener noreferrer">Testcontainers</a> is an open source library that allows you to test any containerized dependencies, such as databases, various cloud technologies, or message brokers. For ease of use, Testcontainers has many preconfigured dependencies called modules.</p>
<p>Besides that, Testcontainers supports various languages in which you can easily write your tests, such as Python, Go, Rust, Ruby, JavaScript, .NET, Java, and others.</p>
<h2class="anchor anchorWithStickyNavbar_JmGV"id="common-use-cases-with-testcontainers">Common use cases with Testcontainers<ahref="#common-use-cases-with-testcontainers"class="hash-link"aria-label="Direct link to Common use cases with Testcontainers"title="Direct link to Common use cases with Testcontainers"></a></h2>
<p>Thanks to the container technology, you can obtain fresh, clean instances without any complex setup for use cases such as:</p>
<ul>
<li>Data access layer integration tests</li>
<li>UI/Acceptance tests</li>
<li>Application integration tests</li>
</ul>
<h2class="anchor anchorWithStickyNavbar_JmGV"id="setup-testcontainers-with-podman">Setup Testcontainers with Podman<ahref="#setup-testcontainers-with-podman"class="hash-link"aria-label="Direct link to Setup Testcontainers with Podman"title="Direct link to Setup Testcontainers with Podman"></a></h2>
<p>Before we start, you need to have installed <ahref="https://podman.io/"target="_blank"rel="noopener noreferrer">Podman</a> and run it in socket listening:</p>
<p>Set Testcontainers runtime to Podman by using one of the following options:</p>
<ul>
<li>
<p>Enable the <ahref="https://podman-desktop.io/docs/migrating-from-docker/managing-docker-compatibility"target="_blank"rel="noopener noreferrer">Docker Compatibility</a> feature.</p>
</li>
<li>
<p>Create a <code>.testcontainers.properties</code> file in your home directory for global configuration of your Testcontainers and add the following line to the configuration file:</p>
<h2class="anchor anchorWithStickyNavbar_JmGV"id="creating-a-project">Creating a project<ahref="#creating-a-project"class="hash-link"aria-label="Direct link to Creating a project"title="Direct link to Creating a project"></a></h2>
<p>This example uses the Redis service and Redis module from Testcontainers. You can create a project and install all the dependencies by following the procedure.</p>
<h2class="anchor anchorWithStickyNavbar_JmGV"id="running-tests">Running tests<ahref="#running-tests"class="hash-link"aria-label="Direct link to Running tests"title="Direct link to Running tests"></a></h2>
<p>When running Testcontainers for the first time, ensure that you run your tests in <code>DEBUG</code> mode by using this command:</p>
<p>Those lines indicate that Testcontainers found the configuration file, and the containers are created on the Podman engine instead of Docker.</p>
<h2class="anchor anchorWithStickyNavbar_JmGV"id="conclusion">Conclusion<ahref="#conclusion"class="hash-link"aria-label="Direct link to Conclusion"title="Direct link to Conclusion"></a></h2>
<p>This tutorial provides a basic step-by-step walkthrough using the Testcontainers technology to run a <ahref="https://redis.io/"target="_blank"rel="noopener noreferrer">Redis</a> server with Podman. More examples can be found in the guides of <ahref="https://testcontainers.com/guides/"target="_blank"rel="noopener noreferrer">Testcontainers</a>. If you encounter any problems, feel free to open an issue on Podman Desktop's <ahref="https://github.com/podman-desktop/podman-desktop/issues"target="_blank"rel="noopener noreferrer">GitHub</a>.</p></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"><aclass="tag_otG2 tagRegular_s0E1"href="/tutorial/tags/podman">podman</a></li><liclass="tag_DFxh"><aclass="tag_otG2 tagRegular_s0E1"href="/tutorial/tags/podman-desktop">podman-desktop</a></li><liclass="tag_DFxh"><aclass="tag_otG2 tagRegular_s0E1"href="/tutorial/tags/containers">containers</a></li><liclass="tag_DFxh"><aclass="tag_otG2 tagRegular_s0E1"href="/tutorial/tags/testcontainers">testcontainers</a></li><liclass="tag_DFxh"><aclass="tag_otG2 tagRegular_s0E1"href="/tutorial/tags/tests">tests</a></li></ul></div></div></footer></article><navclass="pagination-nav docusaurus-mt-lg"aria-label="Docs pages"><aclass="pagination-nav__link pagination-nav__link--prev"href="/tutorial/running-an-ai-application"><divclass="pagination-nav__sublabel">Previous</div><divclass="pagination-nav__label">Running an AI application</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="#common-use-cases-with-testcontainers"class="table-of-contents__link toc-highlight">Common use cases with Testcontainers</a></li><li><ahref="#setup-testcontainers-with-podman"class="table-of-contents__link toc-highlight">Setup Testcontainers with Podman</a></li><li><ahref="#creating-a-project"class="table-of-contents__link toc-highlight">Creating a project</a></li><li><ahref="#running-tests"class="table-of-contents__link toc-highlight">Running tests</a></li><li><ahref="#conclusion"class="table-of-contents__link toc-highlight">Conclusion</a></li></ul></div></div></div></div></main></div></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/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="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-hidden="true"viewBox="0 0 24 24"class="iconExternalLink_nPrP"><pathfill="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><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-hidden="true"viewBox="0 0 24 24"class="iconExternalLink_nPrP"><pathfill="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><liclass="footer__item"><a
<divclass="text-xs">The Linux Foundation has registered trademarks and uses trademarks. For a list of trademarks of The Linux Foundation, please see our <ahref="https://www.linuxfoundation.org/trademark-usage/"> Trademark Usage</a> page.
