Docs

How to use Routekeeper

Routekeeper sends the traffic of the apps you choose on your Mac through your proxy, lets it go direct, or blocks it. Choose where to start: step-by-step setup, recipes for a proxy you already have, or an exact description of how it behaves.

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

Setup

In practice

Reference

Something not working?

Find a case like yours. If none fits, start with the quick check.

What happenedWhere to look
Sites or apps stopped opening after setupTurn 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 proxyNot 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 windowThe network extension
“All connections are blocked”, the settings couldn’t be readAll connections blocked
The proxy is down or has become slowIf the proxy is down
Calls or voice chats don’t work through the proxyLimitations: UDP
Entries have appeared in the Leaks sectionLeaks
You need to report a bugCollect 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.