<titledata-rh="true">Interacting with a database server | 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/interacting-with-a-database-server"><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="Interacting with a database server | Podman Desktop"><metadata-rh="true"name="description"content="Interacting with databases from the Podman Desktop application"><metadata-rh="true"property="og:description"content="Interacting with databases from the Podman Desktop application"><metadata-rh="true"name="keywords"content="podman desktop,podman,databases"><linkdata-rh="true"rel="icon"href="/img/favicon.ico"><linkdata-rh="true"rel="canonical"href="https://podman-desktop.io/tutorial/interacting-with-a-database-server"><linkdata-rh="true"rel="alternate"href="https://podman-desktop.io/tutorial/interacting-with-a-database-server"hreflang="en"><linkdata-rh="true"rel="alternate"href="https://podman-desktop.io/tutorial/interacting-with-a-database-server"hreflang="x-default"><linkdata-rh="true"rel="preconnect"href="https://MR01ANKQ9S-dsn.algolia.net"crossorigin="anonymous"><scriptdata-rh="true"type="application/ld+json">{"@context":"https://schema.org","@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","position":1,"name":"Interacting with a database server","item":"https://podman-desktop.io/tutorial/interacting-with-a-database-server"}]}</script><linkrel="alternate"type="application/rss+xml"href="/blog/rss.xml"title="Podman Desktop RSS Feed">
<li><ahref="/docs/containers/images/building-an-image">Build a database server image using a container or docker file</a></li>
<li><ahref="/tutorial/managing-your-application-resources#managing-images">Import a database server image from your local machine</a> using the <strong>Import</strong> button on the <em>Images</em> component page</li>
<li>Pull a database server image from a registry (covered in this tutorial)</li>
<p>This tutorial focuses on creating a PostgreSQL server instance by pulling the <code>quay.io/fedora/postgresql-16</code> image from the <em>quay.io</em> registry.</p>
<h2class="anchor anchorWithStickyNavbar_JmGV"id="before-you-begin">Before you begin<ahref="#before-you-begin"class="hash-link"aria-label="Direct link to Before you begin"title="Direct link to Before you begin"></a></h2>
<h2class="anchor anchorWithStickyNavbar_JmGV"id="pulling-a-postgresql-server-image">Pulling a PostgreSQL server image<ahref="#pulling-a-postgresql-server-image"class="hash-link"aria-label="Direct link to Pulling a PostgreSQL server image"title="Direct link to Pulling a PostgreSQL server image"></a></h2>
<imgdecoding="async"loading="lazy"alt="pulling an image"src="/assets/images/pull-button-b61a933a48870abeefb656425505cdf1.png"width="983"height="187"class="img_SS3x"></li>
<imgdecoding="async"loading="lazy"alt="clicking the pull button"src="/assets/images/click-pull-image-020dee62bb11f3d9e9f3b62c2482cbb0.png"width="981"height="546"class="img_SS3x"></li>
<imgdecoding="async"loading="lazy"alt="image added on the page"src="/assets/images/new-image-added-30bcc973e8ac784a28895b18d9655371.png"width="996"height="177"class="img_SS3x"></li>
<h2class="anchor anchorWithStickyNavbar_JmGV"id="creating-a-postgresql-server-instance">Creating a PostgreSQL server instance<ahref="#creating-a-postgresql-server-instance"class="hash-link"aria-label="Direct link to Creating a PostgreSQL server instance"title="Direct link to Creating a PostgreSQL server instance"></a></h2>
<p>Click the <strong>Run Image</strong> icon corresponding to the PostgreSQL server image you want to run.
<imgdecoding="async"loading="lazy"alt="running an image"src="/assets/images/run-image-icon-7bbf95c413596d1a899d3af1d30e7460.png"width="991"height="185"class="img_SS3x"></p>
<imgdecoding="async"loading="lazy"alt="starting a container"src="/assets/images/starting-a-postgresql-container-eaf09f815af6044b5c3b1fba5882fcd8.png"width="994"height="622"class="img_SS3x"></p>
<p>View the successful operation notification in the <em>Tty</em> tab of the <em>Container Details</em> page.
<imgdecoding="async"loading="lazy"alt="sql server started"src="/assets/images/postgresql-server-started-d473dead665265b5e300cf1a879d9240.png"width="1005"height="574"class="img_SS3x"></p>
<divclass="theme-admonition theme-admonition-note admonition_WCGJ alert alert--secondary"><divclass="admonitionHeading_GCBg"><spanclass="admonitionIcon_L39b"><svgviewBox="0 0 14 16"><pathfill-rule="evenodd"d="M6.3 5.69a.942.942 0 0 1-.28-.7c0-.28.09-.52.28-.7.19-.18.42-.28.7-.28.28 0 .52.09.7.28.18.19.28.42.28.7 0 .28-.09.52-.28.7a1 1 0 0 1-.7.3c-.28 0-.52-.11-.7-.3zM8 7.99c-.02-.25-.11-.48-.31-.69-.2-.19-.42-.3-.69-.31H6c-.27.02-.48.13-.69.31-.2.2-.3.44-.31.69h1v3c.02.27.11.5.31.69.2.2.42.31.69.31h1c.27 0 .48-.11.69-.31.2-.19.3-.42.31-.69H8V7.98v.01zM7 2.3c-3.14 0-5.7 2.54-5.7 5.68 0 3.14 2.56 5.7 5.7 5.7s5.7-2.55 5.7-5.7c0-3.15-2.56-5.69-5.7-5.69v.01zM7 .98c3.86 0 7 3.14 7 7s-3.14 7-7 7-7-3.12-7-7 3.14-7 7-7z"></path></svg></span>note</div><divclass="admonitionContent_pbrs"><p>You can also check the <em>Logs</em> tab for the same notification.</p></div></div>
<h2class="anchor anchorWithStickyNavbar_JmGV"id="accessing-the-instance-from-terminal">Accessing the instance from terminal<ahref="#accessing-the-instance-from-terminal"class="hash-link"aria-label="Direct link to Accessing the instance from terminal"title="Direct link to Accessing the instance from terminal"></a></h2>
<p>Run the <code>psql</code> command to connect to the database server. The prompt changes to <code>postgres=#</code>.
<imgdecoding="async"loading="lazy"alt="connect to the PostgreSQL server instance"src="/assets/images/connect-to-postgresql-f1e17c026240963edac51b465d8ecfe4.png"width="1007"height="201"class="img_SS3x"></p>
<p>Interact with the database server by running any PostgreSQL commands, such as <code>\list</code>:
<imgdecoding="async"loading="lazy"alt="interact with the database"src="/assets/images/interacted-with-database-5a2cd6462083643891b88f15dcfc5b0d.png"width="1002"height="305"class="img_SS3x"></p>