Install Podman Desktop and connect it to your Developer Sandbox

Podman Desktop and the Developer Sandbox for Red Hat OpenShift are both valuable tools for learning about and creating apps for Red Hat OpenShift. Combining the two creates a developer environment rich with tools and benefits. This learning path guides you in the installation of Podman Desktop and its connection to your sandbox account.

Access the Developer Sandbox

This lesson walks you through installing and running both Podman and Podman Desktop. 

Prerequisites:

  • Terminal session on your computer.

In this lesson, you will:

  • Onboard Podman Desktop.

The first step is to visit the Podman Desktop website and download the bits for your operating system (Figure 1).

Podman Desktop download page.
Figure 1: Podman Desktop runs in most development environments.

Follow the installation instructions and you will have Podman Desktop up and running on your computer in short order (Figure 2).

Initial screen of Podman Desktop when first started on macOS.
Figure 2: Podman Desktop when first started on macOS.

You’ll notice the Start onboarding button in the lower right corner. This begins a process where you install other pieces of software to round out the development environment.

To continue, click the Start onboarding button.

When prompted to execute the Compose download, click the Next button in the lower right corner as shown in Figure 3.

Download Compose screen.
Figure 3: The Compose download supports the podman compose command.

The next prompt is to begin the process of a system-wide install of Compose. Continue by clicking the Next button (Figure 4).

Compose has been installed with the Next button in the lower right corner.
Figure 4: After the Compose download, it needs to be installed system wide.

Continue the installation; you will be prompted to install the kubectl command-line interface (CLI). When prompted, click the Next button (Figure 5).

kubectl download page
Figure 5: The kubectl command supports command line operations.

Continue with the installation of kubectl until it is finished (Figure 6).

kubectl installed on your machine.
Figure 6: kubectl works with any Kubernetes cluster.

When the installation of kubectl is finished, click the Next button to continue to the installation of Podman, the engine on which Podman Desktop runs (Figure 7).

Install Podman.
Figure 7: If Podman isn’t installed, Podman Desktop will guide you to install it.

Click the Next button to begin the installation of Podman.

When asked for permission to install Podman, click the Yes button (Figure 8).

Click Yes to install Podman.
Figure 8: Get the latest version of Podman.

Follow the screen instructions to complete the installation of Podman.

Accept any default settings and click the Next button to continue to the Podman initialization steps. See Figure 9.

Podman settings.
Figure 9: Autostart isn’t required but suggested.

The Podman machine runs in a virtual machine (VM) and is an optional engine that supports Podman Desktop. Click the Next button to begin the Podman machine setup (Figure 10).

Create Podman machine.
Figure 10: Podman machine is the engine for Podman.

Accept the default settings and click the Create button (Figure 11).

Click Create to create the machine.
Figure 11: You can tweak the settings if you wish.

Once the Podman engine has been initialized, you are ready to start using Podman Desktop. See Figure 12.

Podman successfully installed.
Figure 12: Everything is installed and running and ready for you to start developing software on your machine.

When the Podman Desktop dashboard appears, you are notified that Podman needs to be set up. You just finished this, so you can dismiss that notification. It is not necessary to run Set up again (Figure 13).

Notification that Podman needs to be set up—dismiss this.
Figure 13: Dismiss this notification after you’ve installed Podman.

With this notification dismissed, you are ready to start using Podman Desktop. If you wish to prove the installation, open a terminal window and run the command podman --version.

You have now successfully installed Podman and Podman Desktop, and configured both to enable a robust and complete container image development environment. The next lesson is to connect your Podman Desktop app to your Developer Sandbox instance.

Previous resource
Overview: Install Podman Desktop and connect it to your Developer Sandbox
Next resource
Connect Podman Desktop to the Developer Sandbox