Support

What to put in the message

• App version and build — the Account screen shows both.
• Mac model and macOS version.
• Proxy type: SOCKS5, HTTP or HTTPS. Not the password.
• What you did, what you expected, and what happened instead.
• The exact text of any error, copied rather than described.

If you paste a proxy string, remove the login and password first. We cannot use them and do not want them.

Questions that come up

macOS asks me to allow a network extension

The tunnel is a network extension, and macOS asks once before it runs one. Allow it in System Settings → General → Login Items & Extensions → Network Extensions. The app has to be in the Applications folder for macOS to install it.

Why does macOS ask to add a VPN configuration?

A packet tunnel cannot exist without one. The configuration is created locally by the app and points at nothing but the proxy you entered.

UDP doesn’t work through my proxy

An HTTP proxy carries TCP only — UDP does not exist in that protocol. On SOCKS5 it works only if the proxy answers UDP ASSOCIATE, and many proxies refuse. Check the proxy with the globe on its card: the result says whether UDP is supported.

The tunnel says connected, but nothing loads

The Mac reached the proxy, or the tunnel would not have come up, so the failure is past that point: wrong credentials, a proxy that allows only certain destination ports, or a proxy that is up but not forwarding. Run a check — if it returns an exit address, the path works and the problem is narrower than it looks.

How do I disconnect with the window closed?

From the B icon in the menu bar. It shows whether you are connected and disconnects in one click. Quitting the app disconnects as well.

How do I update?

Check for Updates in the app menu or in the menu of the B icon. If you installed with Homebrew, the app still updates itself the same way.

Can I send only one app through the proxy?

No, and not because it was skipped. The system hands the tunnel raw IP packets, and a packet does not say which app produced it. The API that does know is only available on devices managed by an organisation. Rules by domain are the route we can take instead.

Does the app see my passwords?

Passwords are kept in your iCloud Keychain and sent only to the proxy you entered. See the privacy policy for the details.

Which country does the check show?

Whatever a public address service reports for your proxy’s exit address. The app does not choose it and does not verify it.

iPhone, iPad, Android?

Not for now. Brick proxy is a Mac app for macOS 14 or later, on Apple silicon and Intel.

Security reports

Same address, with security in the subject. Say what you found and how to reproduce it; you will get an answer.