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

docs: added _Accessing resources behind a VPN with Podman on Windows_ #3577

Merged
merged 11 commits into from
Aug 23, 2023
3 changes: 2 additions & 1 deletion website/docs/proxy/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,4 +13,5 @@ You can use Podman Desktop behind a proxy in various situations, such as:
- [Using a proxy on Windows and macOS](proxy/using-a-proxy)
- [Using a proxy requiring a custom Certificate Authorities on macOS and Windows](proxy/using-a-proxy-requiring-a-custom-ca)
- [Using a proxy on Linux](proxy/using-a-proxy-on-linux)
- [Using a proxy in your containers](proxy/using-a-proxy-in-your-containers.md)
- [Using a proxy in your containers](proxy/using-a-proxy-in-your-containers)
- [Accessing resources behind a VPN with Podman on Windows](proxy/using-a-vpn-on-windows)
24 changes: 24 additions & 0 deletions website/docs/proxy/using-a-vpn-on-windows.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,24 @@
---
sidebar_position: 5
title: Podman behind a VPN on Windows
description: Accessing resources behind a VPN with Podman on Windows
tags: [podman, vpn, windows]
keywords: [podman, vpn, windows]
---

# Accessing resources behind a VPN with Podman on Windows

On Windows, if Podman needs to access resources behind a user-controlled VPN, enable user mode networking in your Podman machine.

#### Prerequisites

- Windows host with updated WSL2.
- Podman 4.6.0 or greater.

#### Procedure

- When creating the Podman machine, select the **User mode networking (traffic relayed by a user process)** option to enable user mode networking.

#### Verification

- You can now access resources that are behind the VPN.
Original file line number Diff line number Diff line change
Expand Up @@ -53,6 +53,14 @@ You can find here troubleshooting help for issues specific to Windows.

- Set the environment variable `ELECTRON_NO_ATTACH_CONSOLE` to true before launching Podman Desktop.

## When the host is behind a VPN, Podman cannot access network resources

When the host is behind a VPN, Podman might fail to access network resources, and display errors such as _Temporary failure in name resolution_.

### Solution

See [Accessing resources behind a VPN with Podman on Windows](/docs/proxy/using-a-vpn-on-windows).

## Older WSL versions might lead to networking issues

Older versions of WSL might cause networking issues, such as the `Get-NetTCPConnection` error, indicating that the WSL loopback forwarding facility is not functioning correctly. Recent versions of WSL do not have this issue
Expand Down