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, when Podman requires to access resources that are behind a user-controlled VPN, enable the user mode networking in your Podman machine.
themr0c marked this conversation as resolved.
Show resolved Hide resolved

#### Prerequisites

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

#### Procedure

1. To enable user mode networking, when creating the Podman machine, select the **User mode networking (traffic relayed by a user process).** option.
themr0c marked this conversation as resolved.
Show resolved Hide resolved

#### Verification

- You can access resources that are behind the VPN.
themr0c marked this conversation as resolved.
Show resolved Hide resolved
Original file line number Diff line number Diff line change
Expand Up @@ -52,3 +52,11 @@ You can find here troubleshooting help for issues specific to Windows.
#### Workaround

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