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

Linking your Podman Desktop app to your Developer Sandbox instance allows you to deploy and control pods from the Podman Desktop app.

Prerequisites:

  • Podman Desktop installed on your computer.
  • Podman installed and running on your computer.
  • A Developer Sandbox account.
  • Terminal session on your computer.

In this lesson, you will:

  • Connect Podman Desktop to your sandbox instance.

Start by installing the oc CLI tool on your computer. The oc CLI allows you to work with your OpenShift cluster from the command line. For this tutorial, it’s needed in order to log in to your Developer Sandbox cluster. Those instructions can be found here: Download and install the Red Hat OpenShift CLI 

The next step is to get connected to your Developer Sandbox from the command line. This starts by logging in to your Developer Sandbox and going through the steps needed to log in to your sandbox at the command line. Those instructions can be found here: Access your Developer Sandbox for Red Hat OpenShift from the command line

Now that you have installed the CLI and logged in to your cluster, it’s time to connect Podman Desktop to the Developer Sandbox cluster.

The starting point is to install the Developer Sandbox for Red Hat OpenShift extension for Podman Desktop.

Go to the Extensions page (Figure 1, Callout 1), select the Catalog list (Figure 1, Callout 2), and click the Download button to download the extension (Figure 1, Callout 3).

Extension install page.
Figure 1: Install the extension to get started.

When the download is complete, the download button will transform into the text ALREADY INSTALLED (Figure 2).

Download installed.
Figure 2: Download is finished; time to connect to your sandbox instance.

Go to the Settings/Resources section (Figure 3) and click on the Developer Sandbox Create new … button.

Click the Create new… button.
Figure 3: Developer Sandbox connection is in the Settings/Resources section.

You are then prompted for the connection information (Figure 4). Note that you are not creating a new sandbox instance—you are connecting to your existing sandbox instance. You will be using the login command that was retrieved earlier in this lesson.

Provide the login command.
Figure 4: This is where you establish the connection between Podman Desktop and your sandbox instance.

Switch the Set as current context option to Enabled, and paste in the login command for your sandbox instance. Then click the Create button (Figure 5).

Toggle Enabled on and enter the login command.
Figure 5: Enable the current context and enter the login command to connect Podman Desktop to your sandbox instance.

After a few seconds, the Developer Sandbox resource will appear as RUNNING and the endpoint of your sandbox instance is active (Figure 6). At this point, the Podman Desktop app running on your machine is connected to your sandbox instance.

Resource is running, indicating that Podman Desktop is connected to your sandbox instance.
Figure 6: Podman Desktop on your computer is now connected to your sandbox instance.

To prove the connection, simply create an app in your sandbox, then view all pods in Podman Desktop. Here’s the sandbox example Node.js app as it appears in Podman Desktop (Figure 7).

Pods running in your sandbox.
Figure 7: Pods running in your sandbox instance are visible in Podman Desktop.

Wrapping up

This is just the start of what Podman Desktop can do. For more information, visit the Podman Desktop documentation web page.

Here are also some other options for next steps:

Previous resource
Install and initialize Podman Desktop and Podman