Skip to main content

MacOS

This page contains information regarding installation of Podman Desktop on MacOS.

You can install Podman Desktop on Mac:

  1. Using the .dmg file
  2. Using Brew
Prerequisite

Podman Desktop requires Podman Engine. If you don't have Podman Engine installed, Podman Desktop will prompt you to do so at a later stage.

Installing Podman Desktop on MacOS using .dmg file​

1. Download the .dmg file from the Downloads section of this website.

While we recommend getting the "universal" binary file which will work irrespective of the chip architecture your Mac possesses, you also have the option to get the applicable .dmg file depending on your Mac Hardware Architecture (that is Intel or Apple M1).

2. Locate the downloaded file and and double-click on it. (Usually, you will find the downloaded file in the Downloads folder)

img0

3. Drag Podman Desktop icon to the Applications folder.

img1

4. Start Podman Desktop from the 'Launchpad' or Mac's Applications directory.

img2

5. Install Podman from Podman Desktop, if not yet installed.

When you open Podman Desktop for the first time, click on the "View detection checks" button to scan if all the prerequisites to use Podman Desktop are met. If it says ❌ podman cli was not found in the PATH, then you need to install the Podman CLI/Engine which can be done within the application.

img3

Click on the "Install" button next to the "View detection checks" button, and follow the instructions on screen. You will be redirected to the Podman Installer. Follow the instructions on screen and enter your system password when asked.

img4

After the installation is complete, close the installation program. Podman Engine has been installed and you are now ready to use Podman Desktop.

Installing Podman Desktop on MacOS using brew.​

Prerequisite

Installation steps​

  1. Open a terminal on your Mac.
  2. Run the command mentioned below.
brew install podman-desktop

Brew will also install the Podman Engine along with the Podman Desktop application, in case you don't have it installed yet.

After the command is executed, you can find the Podman Desktop Application within the Applications directory of the MacOS.

Getting Started​

Learn more on how to get started with Podman Desktop by clicking here.