KUROKOTO LAB
SplitLane Guide — Chapter 4 of 6

Troubleshooting

Recovery steps for the most common problems, plus how to pull a diagnostic report.

This page mirrors the offline Help tab built into the app (Dashboard sidebar, above Settings) — the same five questions, in the same recovery-first order, so you can find it here too if you’re troubleshooting from another device.

How do I send all traffic through the VPN again?

Open the Dashboard and switch Traffic Mode to All via VPN. This routes all of your Mac’s traffic through the VPN tunnel, with no per-rule routing involved.

If the helper isn’t responding, or the switch doesn’t seem to take effect, this also works and doesn’t depend on SplitLane’s helper at all: in Settings, turn off “Automatically apply when a VPN connection is detected,” then disconnect and reconnect your VPN. Your VPN client will re-establish its own all-traffic state on reconnect.

How do I completely uninstall SplitLane?

Go to Settings > Helper and choose Uninstall. This automatically removes every route SplitLane applied and completely deletes the helper’s saved state. Afterward, move SplitLane.app to the Trash.

See Uninstall for the full picture, including what stays behind and why.

My network is broken or unstable. How do I recover?

Open Diagnostics and use the two emergency buttons: “Restore Default Route” points your default route back to your physical network, and “Remove all app routes” clears every route SplitLane added. Neither one touches your VPN connection itself, so it’s safe to try.

If that doesn’t help, try disconnecting and reconnecting your VPN. As a last resort, restart your Mac — a restart always lets macOS rebuild its own network routing from scratch, so you’re never permanently stuck.

I applied rules but traffic doesn’t go through the VPN

This is usually one of three things:

  • Some VPN clients — especially ones with a kill switch or that constantly reassert their own routes — will override or undo the routes SplitLane sets. This is a limitation of that VPN client, not something SplitLane can control.
  • Rules for CDN-hosted domains (large SaaS products, content networks) can be partial, because those services frequently change IP addresses and a rule only covers the addresses it last resolved.
  • If SplitLane is closed while your VPN reconnects, some traffic outside your rules may temporarily travel over the VPN too. To restore split routing, open SplitLane and click Reload.

The helper won’t install or shows “approval required”

Waiting for approval is normal — it isn’t a bug or a failure. macOS requires you to explicitly allow the helper before it can install:

  1. Open System Settings > Login Items & Extensions.
  2. Find SplitLane in the list and allow it.
  3. Make sure SplitLane.app is in your Applications folder — helper installation only works from there.

Getting a diagnostic report

If none of the above resolves your issue, or you’re reporting a bug, open the Diagnostics tab and click “Copy Diagnostic Report”. Paste it into your support email or GitHub issue.

The report is plain text and includes a route table excerpt, your interface list, DNS resolution test results, the helper’s status, applied-route vs. actual-route-table comparison, and recent events. It includes the destinations (IPs/domains) from your rules, since that’s necessary to diagnose routing problems — SplitLane shows a notice before copying so you know this before you paste it anywhere. It does not include your license key or anything else identifying you personally.

The diagnostic report is always in English, regardless of which language the app’s interface is set to — this keeps it consistent and readable for whoever is helping you, even if that’s not the same person who wrote it.

It also helps to mention, when you reach out:

  • The steps that led to the problem.
  • Your VPN client (corporate VPN, L2TP, IKEv2, etc., if known).
  • Your macOS version.