From 78c7a4b161298b1af9e0b0d4a92509f07e3cd04e Mon Sep 17 00:00:00 2001 From: Nic Klaassen Date: Fri, 20 Dec 2024 12:29:05 -0800 Subject: [PATCH] docs: vnet troubleshooting for IP range conflicts --- docs/pages/connect-your-client/vnet.mdx | 16 ++++++++++++++++ .../application-access/guides/vnet.mdx | 2 ++ 2 files changed, 18 insertions(+) diff --git a/docs/pages/connect-your-client/vnet.mdx b/docs/pages/connect-your-client/vnet.mdx index 71e394d526dc0..5ef384e470ac9 100644 --- a/docs/pages/connect-your-client/vnet.mdx +++ b/docs/pages/connect-your-client/vnet.mdx @@ -75,6 +75,20 @@ $ tsh vnet ## Troubleshooting +### Conflicting IPv4 ranges + +On the client computer, VNet uses IPv4 addresses from the CGNAT IP range `100.64.0.0/10` by +default, and needs to configure addresses and routes for this range. +This can conflict with other VPN-like applications, notably Tailscale also uses +this range. + +If you are experiencing connectivity problems with VNet, check if you are +running Tailscale or another VPN client, and try disabling it to see if the +issue persists. +To avoid the conflict and run VNet alongside Tailscale or another VPN client you +can configure VNet to use a different IPv4 range, see our VNet configuration +[guide](../enroll-resources/application-access/guides/vnet.mdx#configuring-ipv4-cidr-range). + ### Connecting to the app without VNet Sometimes connectivity issues are not related to VNet, and you can narrow that down by trying to @@ -141,4 +155,6 @@ client you use. ## Next steps +- Read our VNet configuration [guide](../enroll-resources/application-access/guides/vnet.mdx) + to learn how to configure VNet access to your applications. - Read [RFD 163](https://github.com/gravitational/teleport/blob/master/rfd/0163-vnet.md) to learn how VNet works on a technical level. diff --git a/docs/pages/enroll-resources/application-access/guides/vnet.mdx b/docs/pages/enroll-resources/application-access/guides/vnet.mdx index d2030547b3640..199ebf93d08e5 100644 --- a/docs/pages/enroll-resources/application-access/guides/vnet.mdx +++ b/docs/pages/enroll-resources/application-access/guides/vnet.mdx @@ -167,4 +167,6 @@ used depends solely on the app itself and its clients. ### Further reading +- Read our VNet usage [guide](../../../connect-your-client/vnet.mdx) for end-users + accessing your applications with VNet. - Read [RFD 163](https://github.com/gravitational/teleport/blob/master/rfd/0163-vnet.md) to learn how VNet works on a technical level.