Podman Desktop is a free alternative to Docker Desktop that’s another great option for local development use. It offers a similar feature set while remaining entirely open-source, letting you avoid the licensing implications of using Docker’s product.

In this article, you’ll learn how to install and get started with Podman Desktop to run containers and deploy to Kubernetes. The experience will be familiar if you’ve previously used Docker Desktop but it should also be quick to pick up anew.

What Is Podman Desktop?

Podman is an OCI container engine that you can use instead of Docker. The Podman CLI is intentionally similar to Docker’s; you can convert most commands by simply substituting podman instead of docker, such as podman run and podman push.

Podman Desktop is an official graphical interface for Podman’s functionality. In addition to wrapping the Podman CLI, it bundles extra features including Kubernetes integration and third-party extensions. You can use Desktop to conveniently interact with containers and related resources on your workstation, if you want to avoid running terminal commands.

Getting Started

Make sure you’ve got the regular Podman CLI installed before you start using Podman Desktop. Desktop needs to detect the CLI to manage your containers. You can find detailed installation instructions in the Podman docs.

Next, download the latest Podman Desktop release from the project’s website. Alternatively, use one of the following commands to install using your system’s package manager:

  • Windowswinget install -e --id RedHat.Podman-Desktop
  • macOSbrew install podman-desktop
  • Linuxflatpak install --user flathub io.podman_desktop.PodmanDesktop

Now you can launch Podman Desktop. You should see Podman is successfully detected. The homescreen will also display any other container environments available on your system, such as a Docker Engine installation.

image of the Podman Desktop dashboard

Exploring Podman Desktop

Podman Desktop’s interface is split into five main sections which you can switch between using the left sidebar. There’s also a separate Settings menu, accessed at the bottom of the sidebar, where you can configure your container engines, enable HTTP proxies, and supply image registry credentials.

Running Containers

The Containers tab is where you’ll spend most of your time. It displays all the containers that exist in your environment. To create a new container, press the purple “Create container” button in the top-right.

image of the Podman Desktop containers screen in its empty state

You’ll be prompted to choose between building a Containerfile or Dockerfile, or starting a container from an existing image:

image of creating a container in Podman Desktop

If you choose “From Containerfile/Dockerfile”, you’ll need to select the path to your file by clicking in the “Containerfile path” input on the next screen. You can use any existing Dockerfile; the Containerfile terminology is simply a more generic alternative. Supply an initial tag for your image in the “Image Name” field, then press the “Build” button to build your image.

image of building an image in Podman Desktop

The build command’s output will be shown in an embedded terminal window. Click the Done button to continue. You’ll be taken to the Images screen where your new image will be displayed. If you opt not to build a new image, you’ll land on the Images screen after you press the “From existing image” button in the container creation dialog.

Next, hover over any image and click the play button that appears on the right side of the screen:

image of images in Podman Desktop

Now you can configure the properties of your new container instance. Assign a name for your container, mount any volumes you require, and set environment variables on the “Basic” tab:

image of creating a container in Podman Desktop

The Advanced tab lets you attach a TTY, set the user that the container runs as, and change the restart policy that’ll apply:

image of creating a container in Podman Desktop

Networking configures the container’s network stack, including its hostname, /etc/hosts file entries, and DNS configuration:

image of networking settings when creating a container in Podman Desktop

Finally, the Security tab lets you activate privileged mode (if you know you require it), modify the container’s kernel capabilities, and specify a read-only filesystem if you expect an immutable environment:

image of security settings when creating a container in Podman Desktop

Once you’re done configuring your container, click the purple “Start Container” button at the bottom of the screen to run it. It’ll show up back on the Containers screen.

image of containers in Podman Desktop


Managing Containers

Hovering over containers reveals actions that let you stop or delete them. You can also use the checkboxes on the left side to select multiple containers and apply actions in bulk.

Clicking the three dots button on the far right reveals an overflow menu with more options. Here, you can immediately restart your container, or quickly launch a terminal session.

image of viewing a container's menu in Podman Desktop

Click any container to view its details. This yields a tabbed interface where you can access the container’s logs, podman inspect output, and terminal session.

image of viiewing a container's details in Podman Desktop

Managing Images

Images are managed in a similar way. Click any image to access its details, including its podman inspect output and layer history.

image of viewing an image's history in Podman Desktop

Click the “Pull Image” button in the top-right of the Images screen to pull a new remote image into your environment. You’ll be prompted to enter the image you want to pull, such as ubuntu:latest or registry.example.com/private-image:v1.

image of pulling an image in Podman Desktop

Podman will download the image when you press the “Pull Image” button. Progress is displayed in an inline terminal window.

image of pulling an image in Podman Desktop

To use images in private registries, you need to set up authentication credentials first. Press the “Manage Registries” button on the Pull Image screen, or navigate to Settings > Add Registries, then press the “Add registry” button in the bottom right. Enter your registry’s hostname and supply your username and password. Click the Login button to authenticate.

image of supplying registry credentials in Podman Desktop

Managing Volumes

The Volumes screen provides an overview of all the persistent volumes you’ve created, including their age and total size:

image of volumes in Podman Desktop

Clicking a volume reveals its podman inspect output:

image of viewing volume details in Podman Desktop

You can delete a volume by clicking the button in the top-right.

Using Kubernetes

Podman has integrated Kubernetes support. This is surfaced in Podman Desktop’s Pods screen. Pods in Podman are equivalent to Kubernetes Pods, being a collection of multiple containers that are grouped together. To deploy a Pod, click the “Play Kubernetes YAML” button in the top-right.

image of Pods in Podman Desktop

Supply the path to your YAML file on the screen that appears:

image of creating a Pod in Podman Desktop

You can use this simple Pod manifest if you don’t have one available:

apiVersion: v1
kind: Pod
  name: nginx
    - image: nginx:latest

When you click the “Play” button, Podman will deploy the Pods defined by your manifest. The created Pod IDs are shown in the embedded terminal window’s output.

You’ll now see your Pod appear on the Pods screen:

image of Pods in Podman Desktop

Pods are still containers running in Podman. To deploy to a real Kubernetes cluster, expand the Pod’s three dots menu and select the “Deploy to Kubernetes” action.

On the next screen, choose whether to replace hostPort bindings with Kubernetes services. This is  safer as it prevents Pods being directly bound to ports on your cluster’s Nodes. Click “Deploy” to launch your Pod into your active Kubernetes cluster, as defined by your ~.kube/config file. You can choose a different cluster connection in the settings menu.

image of deploying to Kubernetes from Podman Desktop

Podman Desktop incorporates convenience features for moving between local containers and Kubernetes clusters. The “Kube” tab on the container details screen provides an auto-generated Kubernetes YAML file for any container in your environment, allowing you to deploy without manually writing manifests.

image of viewing a container's Kubernetes manifest in Podman Desktop

Installing Extensions

Podman Desktop supports most Docker Desktop extensions so you can add custom functionality. Extensions are distributed as container images with specially prepared content. You can find them on Docker Hub by filtering to the Extension content type.


Once you’ve found an extension you’d like to use, add it to Podman Desktop by heading to Settings > Desktop Extensions. Paste the extension’s image name into the input field, then press the “Install extension from the OCI image” button. The installation logs will be shown below.

image of installing an extension in Podman Desktop

The extension’s UI will then be available back in the main Podman Desktop interface, under the Extensions sidebar item.

image of using an extension in Podman Desktop


Podman Desktop is a graphical tool for managing Podman container environments. You can interact with the containers, images, and volumes on your machine, deploy Kubernetes manifests, and monitor logs, all within a single interface. Podman Desktop’s also compatible with Docker Desktop extensions so you can access additional integrations developed by the wider container ecosystem.

These capabilities mean Podman Desktop can often be used as a drop-in replacement for Docker Desktop. You’ll need to stick with Docker if you rely on its collaboration, enterprise management, and development environment functions, though. Podman doesn’t offer anything comparable to these, instead focusing on offering a fast, light, and open container experience.

Profile Photo for James Walker James Walker
James Walker is a contributor to How-To Geek DevOps. He is the founder of Heron Web, a UK-based digital agency providing bespoke software development services to SMEs. He has experience managing complete end-to-end web development workflows, using technologies including Linux, GitLab, Docker, and Kubernetes.
Read Full Bio »