Skip to content

Commit

Permalink
docs: vnet troubleshooting for IP range conflicts
Browse files Browse the repository at this point in the history
  • Loading branch information
nklaassen committed Dec 20, 2024
1 parent 1cab8d9 commit 78c7a4b
Show file tree
Hide file tree
Showing 2 changed files with 18 additions and 0 deletions.
16 changes: 16 additions & 0 deletions docs/pages/connect-your-client/vnet.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down Expand Up @@ -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.
Original file line number Diff line number Diff line change
Expand Up @@ -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.

0 comments on commit 78c7a4b

Please sign in to comment.