All docs sections
Routekeeper offers to update by itself when a new version comes out: see Updates. All builds are on GitHub Releases.
0.6.0 — November 9, 2026
Build 16.
- A backup route to the proxy. When a server is fine but your Mac can’t reach it, connections go through another server of yours, and sites keep seeing the first server’s address. To never connect to the first one directly, turn on Always Through This Server. It’s set up in the proxy’s card, see Backup route.
- Your own server closes service addresses. After the script on the server is updated, the proxy doesn’t reach
169.254.0.0/16(cloud metadata),100.64.0.0/10(Tailscale among others),0.0.0.0/8orfc00::/7. The server card offers the update. Caddy restarts once; the login and password stay the same. - Site addresses through the proxy are on by default on new installs. If you already use version 0.5, the setting stays as it was: Settings → Network → Look up site addresses through the proxy.
- A new look. A color now means the same on every screen: blue is a proxy, green is working. On a wide window, Overview has two columns.
- Rules has a Mine, System and All switch, and search points to matches in the other list.
- Apps has Turned Off and Not Found on Disk groups; the second can be cleared at once.
- Proxies are added from one menu: by address, from the clipboard, or your own server. Save appears only after an edit.
- The map opens around your marks, and labels stay off each other and inside the edges. Proxy names in Monitor are cut in the middle, so names with the same beginning stay different.
- The welcome screen offers to open Routekeeper at login.
- Routekeeper uses less CPU while its windows are hidden.
0.5.1 — October 20, 2026
Build 15.
- The proxy works again after a restart. When Routekeeper started before the Mac joined a network, macOS refused to start the proxy (“No network available”) and it stayed off: apps assigned to the proxy couldn’t open connections until Routekeeper was restarted. Now Routekeeper starts the proxy as soon as the network is up and starts it again if it stops with an error.
- The main window opens in front of other apps instead of staying behind them until you click the Dock icon.
- In Overview, route rows line up: latency, chart and apps sit in columns, and a lone app in a row is no longer cut down to a couple of letters. With several proxies, the line under the title lists the routes themselves.
- In Apps, two copies of one app, like Telegram from the App Store and from its website, show where each one is. An app that was deleted or moved is marked “not on disk”.
- The latency history axis has at most five labels, in milliseconds or seconds, even when the period had delays of tens of seconds. “Spread” is labeled in ms.
- Helper programs without an icon go by a short name:
sshinstead ofcom.apple.ssh.
0.5.0 — October 17, 2026
Build 14.
- The network extension updates by itself. Right after the app updates, Routekeeper installs the new version of the extension, without a password or a new approval in System Settings. Before, it waited for a click on the banner, and if you missed it, the old extension kept running after the app updated. While the extension restarts, connections through the proxy break, and for a couple of seconds new ones may go direct, just as with a manual update: the update window warns about this before you install, and a notification tells you when the extension is replaced. The banner with the Update… button stays in case the extension couldn’t update by itself. For details, see Updates.
- Site addresses through the proxy. A new switch, Settings → Network → Look up site addresses through the proxy, off by default. With it, apps that go through a proxy ask a public DNS for site addresses through the proxy itself instead of your network’s DNS. This helps when the network, such as a corporate VPN, doesn’t know a site or says the name doesn’t exist, and the site won’t open in an app even though it goes through the proxy. Names of the local network and the VPN, including those from
/etc/resolver, are still asked of its DNS. It works for proxies that have DNS through proxy on. For details, see Site addresses through the proxy. - The proxy server’s address is found even when the network’s DNS doesn’t know it. Some networks, such as a corporate VPN or an ISP with a filter, don’t give out the proxy server’s address by its name, and every app through that proxy used to lose its connection. Now Routekeeper looks the address up over DNS over HTTPS at Cloudflare, Google, AdGuard and Control D and remembers it, so the next connection starts at once. If even that doesn’t help, the proxy card has a new Server IP address field, and the server wizard fills it in by itself. An HTTPS proxy’s certificate is still checked against its name. If the address can’t be found, the message says why: there’s no such name at all, or neither the network’s DNS nor DNS over HTTPS can find it. For details, see Error messages.
- The proxy check passes when ipinfo.io refuses. ipinfo.io refuses addresses of some hosting providers, and a working proxy on such a server failed Check. Now, if ipinfo.io doesn’t answer, Routekeeper asks Cloudflare, then ipify. If they answer but don’t name the address, the proxy still counts as working, just without an IP. For details, see Checking.
0.4.1 — October 13, 2026
Build 13.
- The prompt is no longer cut off. When a process had a long name, as helper programs like
com.apple.dt.Xcode.ITunesSoftwareServicedo, the prompt grew wider than its window and lost its edges: the icon, the Forever duration, the child-process switch. Now the duration reads While the process runs, the switch reads Including child processes, and a long address or process name is shortened in the middle. The “Rule: …” line uses the short name:Xcode.ITunesSoftwareService. Launched by lists only the programs that started the process, not the process itself.
0.4.0 — October 12, 2026
Build 12.
- Local networks go direct. An app that goes through a proxy as a whole now reaches your home network, a corporate VPN and Tailscale directly: a remote proxy can’t reach them. This also applies to child processes: for example,
gitlaunched from a terminal or an AI assistant on a proxy reaches a work git server on the internal network. Rules that name an address or subnet work as before: that’s how you send an internal network through an office proxy. The switch is Settings → Network → Local networks go direct, on by default. More in Which rule wins. - A stalled connection to the proxy no longer holds an app for 15 seconds. If the connection to the proxy isn’t ready after 1.5 seconds, Routekeeper opens a second attempt alongside it, and a third after 4 seconds, and uses whichever succeeds first. This happens on some hosting networks: one connection stalls while new ones get through. The overall limit is still 15 seconds, and a wrong password or a refusal from the proxy is reported at once.
- Share a proxy as one link. The Copy Link button in a proxy’s card and the Copy Link with Password item in its context menu put a line like
https://login:password@server:443#Nameon the clipboard. Send it on: the recipient pastes it into Routekeeper and the whole proxy fills in, name included. More in Share a proxy. - Connections through an HTTPS proxy no longer pile up. When an app closed a connection, an HTTPS proxy never learned of it, and the connection stayed open until the site closed it, and some, like Telegram’s servers, keep it for hours. In a day or two hundreds of them built up, macOS stopped giving Routekeeper new ones, and every connection through the proxy failed with “Cannot allocate memory”. Now, if the site stays silent for a minute after the app closed the connection, Routekeeper closes it itself.
- Turning Routekeeper off drops connections through a proxy. Before, after you turned it off with the switch, connections already open kept going through the proxy until the app closed them, and some live for days. Now they’re dropped at once, and apps reconnect directly. See How to turn it off quickly.
- Proxy latency history. In the Proxy section, each proxy has a latency chart for the last hour, day, 7 or 30 days: the typical time, the spread, and when the proxy didn’t open connections. In Overview, each route’s latency has its chart for the last hour next to it. Routekeeper records the time of real connections and checks and spends no extra traffic. The history is kept for 30 days. See Latency history.
0.3.0 — October 5, 2026
Build 11.
You move to it from 0.2.x by hand, once: see Moving from 0.2.x to 0.3.0.
- License. Routekeeper routes traffic only with a valid license. It’s tied to one Mac and usually lasts a year. Everything else works without it, so you can set up proxies, apps and rules in advance. The Mac code and the license field are in Settings → License. Two weeks before the license ends, Routekeeper reminds you to renew it. See License.
- Your own proxy server from the app. The Your Own Server… button in the Proxy section and on the welcome screen opens a wizard: enter the IP and password of a rented server and a domain, and Routekeeper sets up an HTTPS proxy on the server and adds it by itself. No Terminal needed. The server password isn’t saved: Routekeeper logs in with its own key from the keychain. The card of such a proxy gets a Server block to check and update the server, change the proxy password, turn off password logins to the server and remove the proxy from it. See Setting it up from Routekeeper.
- A new app identifier. The system identifier changes from
dev.ilyabazenov.appproxytoapp.getroutekeeper.mac. For macOS, this is a new app, so versions 0.2.x only tell you about it and give a link to the website. Remove the old version with its own Delete… button, then install the new one and give the three permissions again. Rules, proxies with passwords and settings move over by themselves. If the old extension is still on, the new version shows a banner and explains how to turn it off. In System Settings, the extension is now called “Routekeeper Extension”. - Severity levels in Leaks. Each kind of entry now has its own severity: Process outside the rule is the most serious (red), UDP around the proxy is orange, and DNS around the proxy is the least serious (yellow). If only DNS queries go direct, Overview doesn’t raise the alarm and simply says “DNS queries go direct”. The tip for such an entry explains what the DNS provider sees in this case.
- A lock when the settings can’t be read. Sometimes the extension can’t read the settings file: the file is damaged, or an older version was installed over newer settings. Routekeeper no longer starts with clean settings and sends all apps direct. Instead, it blocks all connections except connections within the Mac, Routekeeper itself and the system DNS service. The banner offers Check for Updates or Reset Settings…, and a reset keeps the old file. For details, see All connections are blocked.
- Settings from older versions can always be read. If the file lacks a setting that was added later, that setting gets its default value.
- New services, including Slack, Zoom, GitHub and Figma. There are now 32 services in all.
- A service adds its app. Along with a service, Routekeeper also adds its Mac app with the same route: for example, Slack, Zoom, ChatGPT, Claude, Cursor, JetBrains IDEs. For Claude, the
claudecommand-line program is added too. An app installed later is added by itself. Apps you’ve already given a route don’t change. - New services without a new version. The whole service catalog now comes from the website: the services themselves, their addresses, the apps added along with a service, and the browsers for which the Monitor suggests DNS over HTTPS. Before, only the addresses were updated from the website. The catalog is checked every 6 hours instead of 12. The section in Settings is called Service Catalog and shows when the last check was.
- A faster traffic map. The map is built in the background and doesn’t slow down the window, and the connection dots move smoothly.
0.2.1 — October 3, 2026
Build 10.
- Through Proxies Now on the Overview screen. Which apps are sending traffic through a proxy right now, how fast, and through which proxy. An app stays in the list for a while after its traffic goes quiet.
- Fewer false “DNS around the proxy” entries. The service queries
ipv4only.arpaand_dns.resolver.arpaare the same for everyone and say nothing about what you do. They’re no longer flagged. - Browsers and DNS. If a browser sends its own DNS queries around the proxy, Routekeeper suggests turning on DNS over HTTPS in it. For browsers, it doesn’t show the Block DNS button: without DoH, a browser with port 53 closed would stop opening sites. Recipe: DNS over HTTPS in the browser.
- The speed graph no longer goes past its edges and shows only its own time window.
0.2.0 — October 3, 2026
Build 9.
- The Overview screen is the new main screen. At the top, it shows whether everything works, and if not, the most serious problem and a button that fixes it. Below are all routes with the status and speed of their proxies, direct traffic, and connections around the proxy.
- Moving routes to another proxy from the window and from the menu bar: all apps at once, or one proxy’s routes. Before moving, Routekeeper shows exactly what will move and from where. Afterwards, it lets you undo for a few seconds. For details, see the recipe The proxy stopped answering.
- Services. A rule for a whole service, for example “ChatGPT through a proxy”, applies in all apps at once. In rules, a service is written as
@chatgpt. An address you enter yourself wins over a service. The service card shows what the rule matched and checks whether an address is on the list. - New services, including Spotify, Notion and JetBrains, and Russian ones: government sites, banks, popular sites. The Russian services are added with the Direct route. There are 25 services in all.
- Service address lists are updated from the website every 12 hours, without a new app version. The date of the lists and a button to check by hand are in Settings → General → Service Addresses.
- You can choose services on the Apps screen and on the welcome screen.
- The prompt in Ask mode suggests the proxy that most apps already go through, and shows how many connections are waiting for an answer. Clicking the prompt no longer brings the main window forward.
- A proxy’s dot turns orange only when the delay is noticeable: from 1500 ms, with the label “slow”.
- If the main proxy fails its check, Routekeeper repeats the check once a minute. Before, after a short failure, the menu bar could show for hours that the proxy was unreachable.
- When two proxies have the same name, the route menu tells them apart by type and port.
- Diagnostics get a fresh list of connections from the extension, even if the monitor is closed.
0.1.0 — October 3, 2026
Build 8. The first public version.
- A route for each app: Through Proxy, Direct, Block or Ask. Apps are recognized by the developer’s signature, together with their child processes.
- Rules by address: site name, wildcard
*., IP, subnet, port and protocol. - SOCKS5, HTTP and HTTPS proxies, with or without a login and password. You can paste a proxy string from the clipboard. The site name is passed to the proxy, and the proxy looks up the address itself.
- If the proxy is unreachable, connections don’t go direct. UDP and QUIC are blocked for apps on a proxy.
- Four firewall modes: Proxy Only, Ask, Silent, Block All.
- A connection monitor with a traffic map, and flags for connections around the proxy, with a tip on how to close them.
- The menu bar icon: status, mode and the proxy’s external IP.
- Import and export of rules, diagnostics collection, automatic updates.
- Interface in English and Russian.
Checked against the Routekeeper code (version 0.2.1 and the one after it) on October 4, 2026.