Skip to content

Commit 92f3789

Browse files
[CF1] WSL and split tunnel troubleshooting
1 parent 2d9aee9 commit 92f3789

File tree

2 files changed

+18
-0
lines changed

2 files changed

+18
-0
lines changed

src/content/docs/cloudflare-one/connections/connect-devices/warp/configure-warp/route-traffic/split-tunnels.mdx

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -91,3 +91,7 @@ Removing default Split Tunnel entries may cause users to lose Internet connectiv
9191
4. Find the IP address or hostname in the list and select **Delete**.
9292

9393
If you need to revert to the default Split Tunnel entries recommended by Cloudflare, select **Restore default entries**.
94+
95+
## Troubleshooting
96+
97+
- [WSL2 losing connectivity when WARP is running](/cloudflare-one/faq/troubleshooting/#i-see-wsl2-losing-connectivity-when-using-warp)

src/content/docs/cloudflare-one/faq/troubleshooting.mdx

Lines changed: 14 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -305,3 +305,17 @@ This error is returned when proper API permissions are not set up in the identit
305305
For example, [Microsoft Entra](/cloudflare-one/identity/idp-integration/entra-id/#2-configure-api-permissions-in-entra-id) and [Okta](</cloudflare-one/identity/idp-integration/okta/#:~:text=(Optional)%20Create%20an%20Okta%20API%20token%20and%20enter%20it%20in%20Zero%20Trust%20(the%20token%20can%20be%20read%2Donly).%20This%20will%20prevent%20your%20Okta%20groups%20from%20failing%20if%20you%20have%20more%20than%20100%20groups>) have required permissions stated in their integration guides.
306306

307307
You can also examine logs in your identity provider to identify any denied requests related to API access.
308+
309+
## WSL2 is losing connectivity when using WARP.
310+
311+
If your WSL2 environment is losing connectivity while using WARP, check your [split tunnel configuration](/cloudflare-one/connections/connect-devices/warp/configure-warp/route-traffic/split-tunnels/).
312+
313+
The issue may arise because the IP range that the WSL environment uses to communicate with the host device is included in the split tunnel configuration. Excluding (or not including) the WSL evironment's IP range should restore connectivity.
314+
315+
You must ensure the host device is included in the WARP tunnel while excluding the WSL environment to prevent connectivity issues between WSL and the host device.
316+
317+
To debug this issue:
318+
319+
1. Review the WSL2 environment's IP address and compare it with the laptop’s IP.
320+
2. Check if the WSL network is [included in the split tunnel configuration](/cloudflare-one/connections/connect-devices/warp/configure-warp/route-traffic/split-tunnels/#change-split-tunnels-mode).
321+
3. If the WSL network included, exclude the WSL network from the split tunnel to prevent connectivity issues.

0 commit comments

Comments
 (0)