Install on macOS

Red Hat build of Podman Desktop 1.0

Explore how you can install Red Hat build of Podman Desktop on macOS.

Red Hat Customer Content Services

Abstract

Install Red Hat build of Podman Desktop using the `.dmg` file. The setup process includes installing the Podman engine and configuring your initial Podman machine.

Preface

Install Red Hat build of Podman Desktop on your macOS machine by using the .dmg installer file. This installer package provides a smooth, bundled installation of the following essential components:

  • Red Hat build of Podman Desktop
  • Podman
  • Podman CLI

Chapter 1. Install using the .dmg installer file

The .dmg installer provides the most stable experience by bundling the required components. This avoids the path conflicts and stability issues common with package managers like Homebrew. The .dmg files are available as universal binaries. This ensures that the virtualization layers and helper tools are optimized for your specific macOS hardware.

After installation, the Get started with Red Hat build of Podman Desktop screen helps you to start the onboarding process. You can skip this setup and complete it later using one of the following ways:

  • Use the Set up button in the notification on the Dashboard page.
  • Use the Setup Podman button on the Podman tile, located on the Settings > Resources page.
Important

If you have installed Podman using Homebrew, ensure you uninstall it before using the .dmg installer. This avoids unexpected results when using Red Hat build of Podman Desktop.

Prerequisites

Procedure

  1. Download the .dmg file:

    1. Go to the This content is not included.Downloads page.
    2. Click Download on the macOS tile.
  2. Locate the downloaded file, usually available in the Downloads folder, and double-click it.
  3. Drag the Red Hat build of Podman Desktop application and drop it to the Applications folder.

  4. Start Red Hat build of Podman Desktop from the Launchpad or Mac’s Applications directory. The Get started with Red Hat build of Podman Desktop screen opens.

    Important

    The onboarding setup opens automatically when you first launch the application. However, you can skip this setup manually, or your administrator can disable it.

  5. Click Start Onboarding.

  6. Perform the following steps to install Podman:

    1. Click Next. A confirmation notification opens.
    2. Click Yes. The Podman Setup screen opens.
    3. Follow the instructions on the screen, enter your system password when prompted, and click Install Software.
    4. Click Close. A page notifying that Podman is set up correctly opens.

  7. Perform the following steps to create a Podman machine:

    1. Click Next. A page notifying you to create a Podman machine opens.

    2. Click Next, and then click Create.

      Note

      You can also create additional Podman machines of any provider type later. For more details, refer to Configure a Podman machine.

  8. Click Next, and follow the instructions on the screen to install the kubectl and compose CLIs.
  9. After installing the CLIs, click Next to go to the Dashboard page.

Verification

  • Go to the Settings > Resources page to check the Podman machine is running.

    You are ready to use the application.

Legal Notice

Copyright © Red Hat.
Except as otherwise noted below, the text of and illustrations in this documentation are licensed by Red Hat under the Creative Commons Attribution–Share Alike 3.0 Unported license . If you distribute this document or an adaptation of it, you must provide the URL for the original version.
Red Hat, as the licensor of this document, waives the right to enforce, and agrees not to assert, Section 4d of CC-BY-SA to the fullest extent permitted by applicable law.
Red Hat, the Red Hat logo, JBoss, Hibernate, and RHCE are trademarks or registered trademarks of Red Hat, LLC. or its subsidiaries in the United States and other countries.
Linux® is the registered trademark of Linus Torvalds in the United States and other countries.
XFS is a trademark or registered trademark of Hewlett Packard Enterprise Development LP or its subsidiaries in the United States and other countries.
The OpenStack® Word Mark and OpenStack logo are trademarks or registered trademarks of the Linux Foundation, used under license.
All other trademarks are the property of their respective owners.