vpn-repair

What problem does it solve?

It diagnoses and repairs VPN connectivity failures where a VPN either won’t connect or shows “Connected” while traffic can’t reach internal resources.

Core Features & Use Cases

• VPN state and profile troubleshooting: Checks active VPN interfaces and enumerates configured VPN profiles to find stale/mismatched settings.
• Network-path and certificate validation: Verifies general internet reachability, checks reachability to the VPN server, and detects expired server/certificate issues.
• macOS network extension approval handling: Detects required system extension status and prompts the user to approve pending network extension changes in System Settings before reconnecting.
• Tunnel verification and remediation: Reconnects the VPN, flushes DNS cache after reconnect, and verifies routing by testing reachability to a user-provided internal hostname/IP.

Use it when users report: “VPN won’t connect,” “VPN is connected but can’t access company sites,” “VPN keeps disconnecting,” or “VPN stopped working after an OS update.”

Quick Start

Use vpn-repair to diagnose and fix your VPN by having the user approve any pending macOS network extension, then reconnect and verify routing to an internal hostname you provide.