Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

windows doc updated with info on wsl #355

Merged
merged 1 commit into from
Aug 1, 2022
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
20 changes: 17 additions & 3 deletions website/docs/Installation/windows-install.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,6 +13,8 @@ Simply download the file from the [Downloads](/downloads/windows) section and op

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.

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).

![img1](img/homescreen.png)

## 3. Initialize & Start the Podman Machine
Expand All @@ -23,19 +25,31 @@ Once Podman is installed, you will see a toggle button at "Home" window that wil

![img2](img/initialize.png)

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.

![img3](img/wsl_before_reboot_1.png)

Your device will reboot during the process. You will be again prompted to proceed.

![img4](img/wsl_before_reboot_2.png)

After reboot, the remaining installation process will be performed. Once WSLv2 is installed, you will find that the Podman Machine is initialized.

![img5](img/wsl_after_reboot.png)

After initializing a Podman Machine, you should see a toggle to Run Podman. This will start the Podman Machine upon activation.

![img3](img/starting.png)
![img6](img/starting.png)

### b. Custom Configurations

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.

![img2](img/create.png)
![img7](img/create.png)

Once the machine is created, you can click on the Start button in the Machine Settings to start the Machine.

![img3](img/machine.png)
![img8](img/machine.png)

### c. Command Line

Expand Down