You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardexpand all lines: website/docs/Installation/windows-install.md
+50-35
Original file line number
Diff line number
Diff line change
@@ -3,69 +3,84 @@ sidebar_position: 4
3
3
---
4
4
5
5
# Windows
6
-
## 1. Installing Podman Desktop on Windows
7
6
8
-
In order to install the latest Podman Desktop application for Windows, visit the [Downloads](/downloads/windows) section of this website to download the .exe file.
7
+
This page contains information regarding installation of Podman Desktop on Windows.
9
8
10
-
Simply download the file from the [Downloads](/downloads/windows) section and open it in your Desktop to install Podman Desktop.
9
+
:::infoPrerequisites:
10
+
**NOTE: Administrator access is required for both these prerequisites.**
11
+
1.[Hyper-V should be enabled](https://learn.microsoft.com/en-us/virtualization/hyper-v-on-windows/quick-start/enable-hyper-v)
12
+
2.[Windows Subsystem for Linux v2 (WSL2)](https://learn.microsoft.com/en-us/windows/wsl/install-manual) should be installed.
13
+
:::
11
14
12
-
## 2. Installing Podman (if not already present)
15
+
## Installing Podman Desktop on Windows
13
16
14
-
If you don't have Podman installed in your Windows computer, Podman Desktop will prompt you to do so as soon as you open the application. With the latest update, Podman Desktop will be able to install and configure Podman once you click on the 'Install' button on the home page.
17
+
### a. Using `.exe` file from [Downloads](/downloads/windows)
15
18
16
-
NOTE: Podman Engine on Windows is backed by a virtualized Windows Subsystem for Linux (WSLv2) instance. If you don't have it installed already, Podman Desktop will prompt you to do so when you initialize a Podman Machine for the first time. You can read more about installing Podman on Windows [here](https://github.com/containers/podman/blob/main/docs/tutorials/podman-for-windows.md).
19
+
**1. Download the latest `.exe` file from the [Downloads](/downloads/windows) section of this website.**
17
20
18
-
21
+
**2. Locate the downloaded file and and double-click on it to open Podman Desktop. (Usually, you will find the downloaded file in the Downloads folder)**
19
22
20
-
## 3. Initialize & Start the Podman Machine
23
+
21
24
22
-
### a. Default Configurations
25
+
### b. Using [Chocolatey](https://chocolatey.org/install) package manager for Windows
23
26
24
-
Once Podman is installed, you will see a toggle button at "Home" window that will allow you to initialize a Podman Machine with default configurations. Simply activate the toggle to proceed.
27
+
**1. Using the installation guide [here](https://chocolatey.org/install), install Chocolatey Package Manager.**
25
28
26
-
29
+
**2. To install Podman Desktop, run the following command from the command line or from PowerShell:**
30
+
```sh
31
+
choco install podman-desktop
32
+
```
27
33
28
-
If this is your first time initializing Podman Machine after installation and you do not have WSLv2 installed, Podman Desktop will prompt you to do so (as shown in image below). Click 'OK' and wait for the process to complete.
34
+
**Read more about Podman Desktop on Chocolatey [here](https://community.chocolatey.org/packages/podman-desktop).**
29
35
30
-
36
+
### c. Using [Winget](https://winget.run/pkg/RedHat/Podman-Desktop) package manager for Windows
31
37
32
-
Your device will reboot during the process. You will be again prompted to proceed.
38
+
**1. Get the Winget Package manager for Windows by clicking [here](https://aka.ms/getwinget).**
33
39
34
-
40
+
**2. To install Podman Desktop, run the following command from the command line or from PowerShell:**
41
+
```sh
42
+
winget install -e --id RedHat.Podman-Desktop
43
+
```
35
44
36
-
After reboot, the remaining installation process will be performed. Once WSLv2 is installed, you will find that the Podman Machine is initialized.
45
+
### d. Using [Scoop](https://scoop.sh/#/apps?q=podman-desktop&s=0&d=1&o=true) package manager for Windows
46
+
47
+
**1. Using the installation guide [here](https://github.com/ScoopInstaller/Install#readme), install Scoop Package Manager.**
48
+
49
+
**2. To install Podman Desktop, run the following commands from the command line or from PowerShell:**
50
+
```sh
51
+
scoop bucket add extras
52
+
```
37
53
38
-
54
+
```sh
55
+
scoop install podman-desktop
56
+
```
39
57
40
-
After initializing a Podman Machine, you should see a toggle to Run Podman. This will start the Podman Machine upon activation.
58
+
## Setting up Podman Desktop on Windows
41
59
42
-
60
+
**1. Install Podman from Podman Desktop, if not yet installed.**
43
61
44
-
### b. Custom Configurations
62
+
When you open Podman Desktop, your home screen would look like the one in the image below if you don't have Podman (Engine) installed.
45
63
46
-
In order to initialize a Podman Machine with custom configurations, go to "Preferences" on the menu present in the left-side of the application. Under Resources, you will find Podman. Clicking on it shall load the configuration settings for the machine. Enter the values that deem fit for your purpose and click on the "Create" button.
64
+
47
65
48
-
66
+
**a. To install Podman, click on the `Install` button on the home screen. This will check for all the requirements for installation of Podman Engine.**
49
67
50
-
Once the machine is created, you can click on the Start button in the Machine Settings to start the Machine.
68
+
51
69
52
-
70
+
**b. If you do not have WSL2 installed, follow the instructions [here](https://learn.microsoft.com/en-us/windows/wsl/install-manual) to install the same.**
53
71
54
-
### c. Command Line
72
+
**c. Once all the requirements are met, Podman Desktop will ask you to allow installation of Podman (Engine). Click on `Yes` to continue.**
55
73
56
-
Using the following two commands in the command line, you can initialize and start a Podman Machine the classic way!
74
+
57
75
58
-
To initialize the machine, the command is
76
+
**2. Once installation is completed, you are ready to use Podman Desktop.**
59
77
60
-
```sh
61
-
podman machine init
62
-
```
78
+
After the installation of Podman Engine, your home screen would like the one in the image below.
63
79
64
-
After which, you can start the machine with the command
80
+
65
81
66
-
```sh
67
-
podman machine start
68
-
```
82
+
If the screen says `Podman is installed but not ready`, it means that installation of Podman Engine has been completed but a Podman Machine has not been initialized.
69
83
70
-
**Well that's just it. You shall now be all set to use Podman Desktop on Windows!**
84
+
## Next Steps
71
85
86
+
You can learn more about initializing a Podman Machine and working with Podman Desktop in our [Getting Started guide](/docs/getting-started/getting-started).
0 commit comments