Skip to content

Commit b5fbb9e

Browse files
[CF1] WSL and split tunnel troubleshooting (#20833)
* [CF1] WSL and split tunnel troubleshooting * spelling and grammar * Update src/content/docs/cloudflare-one/connections/connect-devices/warp/configure-warp/route-traffic/split-tunnels.mdx
1 parent ba57317 commit b5fbb9e

File tree

1 file changed

+14
-0
lines changed

1 file changed

+14
-0
lines changed

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 the WSL environment’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 is included, exclude it from the split tunnel to prevent connectivity issues.

0 commit comments

Comments
 (0)