Elgato_dark/podman-desktop
1
0
Fork 0
mirror of https://github.com/podman-desktop/podman-desktop synced 2026-05-24 10:18:53 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions

Update content on the Mac OS installation guide

Browse source 
Signed-off-by: Stévan Le Meur <1636769+slemeur@users.noreply.github.com>
This commit is contained in:
Stévan Le Meur 2022-10-03 09:09:48 +00:00 committed by Dev Kumar
parent 082c84edf7
commit 71a59a9ef6
1 changed files with 34 additions and 25 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

59
website/docs/Installation/macos-install.md
View file

@ -4,55 +4,64 @@ sidebar_position: 3
# MacOS
This page contains information regarding installation of Podman Desktop on MacOS. There are two ways by which this is possible; both of which are discussed below.
This page contains information regarding installation of Podman Desktop on MacOS.
You can install Podman Desktop on Mac:
- Using the .dmg file,
- Using Brew
If you don't have Podman installed, Podman Desktop will take care of installing it.
## Installing Podman Desktop on MacOS using .dmg file
### 1. Download the file
1. Download the `.dmg` file from the [Downloads](/downloads/macos) section of this website.
+ • In order to install Podman Desktop and start running containers, you can download the .dmg file from the [Downloads](/downloads/macos) 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 (i.e. Intel or Apple M1).
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 (i.e. Intel or Apple M1).
### 2. Install Podman Desktop
- • Once you have downloaded the file of your choice, you can find it in the Downloads folder. Double-click the file to open it in your device.
2. Locate the downloaded file and and double-click on it. (Usually, you'll find the downloaded file under you Downloads folder)
> ![img0](img/download-dmg.png)
- • Once you open it, the system will prompt you to drag the icon to the Applications folder.
3. Drag Podman Desktop icon to the Applications folder.
> ![img1](img/click-and-drag.png)
- • After which, you are just a click away from using Podman Desktop. You can find Podman Desktop either on the 'Launchpad' or Mac's 'Applications' directory.
- • Double-click the icon to open Podman Desktop.
4. Start Podman Desktop from the 'Launchpad' or Mac's 'Applications' directory.
> ![img2](img/podman-desktop-app.png)
### 3. Check for Prerequisites
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 see 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. You can read more about Podman Engine [here](https://docs.podman.io/en/latest/).
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](img/pd-before-podman.png)
### 4. Install Podman CLI/Engine
- • In order to get Podman CLI/Engine, you can 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.
- 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](img/system-pass.png)
After installation is complete, close the Installer and you are all set to build images and run containers using Podman Desktop. Learn more on how to get started with Podman Desktop by clicking [here](/docs/getting-started/getting-started).
After installation is complete, close the installer.
6. You are ready to use Podman Desktop.
## Installing Podman Desktop on MacOS using [brew](https://brew.sh/).
The following command will help you install Podman Desktop on your Mac through [Homebrew](https://brew.sh/). So make sure you have that installed and set up.
### Prerequisites
- [Homebrew](https://brew.sh/)
To install Podman Desktop, simply run the command below:
### Installation steps
1. Open a terminal on your Mac.
2. Run the command below `brew install podman-desktop`.
Brew will also install the Podman CLI/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.
## Next Steps
Learn more on how to get started with Podman Desktop by clicking [here](/docs/getting-started/getting-started).
```sh
brew install podman-desktop
```
After the command is executed, you can find the Podman Desktop Application within the Applications directory of the MacOS. Brew will also install the Podman CLI/Engine along with the Podman Desktop application. In this case, you thus need not worry about any dependency.