ProxyBar — Documentation

ProxyBar is a macOS menu bar app that gives you a quick overview of all domains routed through your Traefik reverse proxy.

---

Getting Started

1. Click the ProxyBar icon in your menu bar.
2. Click the gear icon to open Settings.
3. Enter your Traefik HTTP routers API URL and click Save & Fetch.

Your domains will appear in the list immediately.

---

Settings

Traefik API URL

The full URL to your Traefik HTTP routers endpoint. It typically looks like:

https://dashboard.example.com/api/http/routers

If you run Traefik locally it may be:

http://localhost:8080/api/http/routers

Basic Auth (optional)

If your Traefik dashboard is protected by basic authentication, expand this section and enter your username and password. The password is stored securely in your macOS Keychain.

Leave both fields blank if your API is publicly accessible or protected by another mechanism.

Auto-refresh

ProxyBar can automatically re-fetch your routers in the background:

Option	Behaviour
Off	Only refreshes when you click the refresh button
30s	Refreshes every 30 seconds
1m	Refreshes every minute
5m	Refreshes every 5 minutes

---

Using the Domain List

• Click any domain to copy it to your clipboard.
• Hover over a domain to reveal two action buttons:
  • Copy — copies the domain name to your clipboard.
  • Open in browser — opens https://<domain> in your default browser.
• Escape closes the menu.

---

Refreshing

Click the circular arrow button in the header to manually fetch the latest routers from your Traefik instance. The footer shows when the list was last refreshed.

---

Troubleshooting

No domains appear after saving the URL

• Confirm the URL is reachable from your Mac (try opening it in a browser).
• Check that Basic Auth credentials are correct if your dashboard is protected.
• Make sure the URL points to the /api/http/routers endpoint, not the dashboard root.

“No routers returned from the API”

• Traefik returned an empty list. This can happen if no HTTP routers are configured yet.

Domains are missing

• ProxyBar only shows domains defined with the Host(...) matcher. Routes using HostRegexp, PathPrefix, or other matchers are intentionally excluded as they do not represent a single addressable domain.