All docs sections
Straight to the point: recipes for a messenger, a browser, the terminal, a local client and a work proxy · which rule wins · how to turn Routekeeper off quickly.
All sections
Getting started
From download to your first app through a proxy, and a check that it works.
LicenseThe Mac’s code, entering a license, its term and renewal, moving to another Mac.
How it worksThe app and the network extension, the order in which an action is chosen, DNS and UDP.
Setup
Types, fields, pasting a proxy string, checking, several proxies, a local client and a work proxy.
Apps and servicesAn app’s route, child processes, command-line tools and 32 services.
RulesExceptions by domain, address and port, which rule wins, import and export.
Firewall modesProxy Only, Silent, Ask, Block All: what to do with a connection that has no rule.
Your own proxy serverAn HTTPS proxy on your own VPS with one command, and connecting it to Routekeeper.
In practice
A messenger, one service and DNS in the browser, developer tools, a local client, a work proxy, a proxy that’s down.
Checking and monitoringOverview, the connection monitor, the Leaks section and what it detects.
Reference
Symptoms and causes, error messages, diagnostics, how to report a problem.
Updates and removalUpdates, moving from 0.2.x, turning it off, removing it completely, and where the data is kept.
LimitationsUDP and calls, connections without a site name, browser profiles, other VPNs.
GlossaryProxy, DNS, UDP, QUIC, VPS and other terms in plain words.
What’s newWhat changed in each version.
Something not working?
Find a case like yours. If none fits, start with the quick check.
| What happened | Where to look |
|---|---|
| Sites or apps stopped opening after setup | Turn Routekeeper off, then do the quick check |
| macOS won’t give a permission, or you clicked “Don’t Allow” | macOS permissions |
| An app goes direct instead of through the proxy | Not going through the proxy |
| Checking the proxy shows an error, such as “SOCKS5: wrong login or password” or “The proxy didn’t answer in time” | Error messages |
| “The network extension isn’t responding” at the top of the window | The network extension |
| “All connections are blocked”, the settings couldn’t be read | All connections blocked |
| The proxy is down or has become slow | If the proxy is down |
| Calls or voice chats don’t work through the proxy | Limitations: UDP |
| Entries have appeared in the Leaks section | Leaks |
| You need to report a bug | Collect diagnostics and send a report |
No proxy of your own yet? The Your own proxy server page shows how to rent a VPS, run one command and get an HTTPS proxy with a password and a ready line for Routekeeper. Without the password, such a server answers like an ordinary web server. So scanners don’t find an open proxy, and strangers can’t use it.
Checked against the Routekeeper code (version 0.2.1 and the one after it) on October 4, 2026.