Frequently Asked Questions
General
Section titled “General”What is Weproxa?
Section titled “What is Weproxa?”Weproxa is a native macOS HTTP/HTTPS proxy debugger. It lets you capture, inspect, modify, and replay network traffic from any app on your Mac.
What platforms does Weproxa support?
Section titled “What platforms does Weproxa support?”Currently, Weproxa is available for macOS 11.0+ (Big Sur and later) on both Apple Silicon and Intel Macs.
Is Weproxa free?
Section titled “Is Weproxa free?”Weproxa offers a free tier with core features. Advanced features are available with a Pro license. See Pricing for details.
Setup & Configuration
Section titled “Setup & Configuration”Why does Weproxa need to install a certificate?
Section titled “Why does Weproxa need to install a certificate?”To inspect HTTPS (encrypted) traffic, Weproxa needs to generate and trust a local Certificate Authority. This is standard practice for proxy debugging tools. The certificate is generated locally and never leaves your machine. See Certificate Trust.
How do I enable the system proxy?
Section titled “How do I enable the system proxy?”Click the network icon in the toolbar. Weproxa will configure your Mac’s system proxy settings automatically. When you stop the proxy or quit the app, the settings are restored.
Does Weproxa work with all apps?
Section titled “Does Weproxa work with all apps?”Most apps that respect macOS system proxy settings will work automatically. Some apps (like those using custom proxy configurations or certificate pinning) may need additional setup.
HTTPS & Security
Section titled “HTTPS & Security”Is my data safe?
Section titled “Is my data safe?”Yes. Weproxa runs entirely on your local machine. No traffic data is ever sent to external servers. The CA certificate and private key are stored locally in the app’s data directory.
Can Weproxa decrypt HTTPS traffic?
Section titled “Can Weproxa decrypt HTTPS traffic?”Yes, when the Weproxa CA certificate is trusted. This is a standard man-in-the-middle (MITM) technique used by all proxy debugging tools.
What about certificate pinning?
Section titled “What about certificate pinning?”Apps with certificate pinning will reject Weproxa’s generated certificates. This is by design — it’s a security feature of those apps.
Troubleshooting
Section titled “Troubleshooting”I don’t see any requests
Section titled “I don’t see any requests”- Make sure the proxy is running (green indicator in toolbar)
- Check that the system proxy is enabled
- Try opening a website in Safari — it uses system proxy settings
HTTPS requests show certificate errors
Section titled “HTTPS requests show certificate errors”The Weproxa CA certificate may not be trusted. See Certificate Trust for setup instructions.
The app is slow with many requests
Section titled “The app is slow with many requests”Weproxa keeps up to 10,000 requests in memory. Use the Clear button in the toolbar to remove old requests, or use filters to focus on relevant traffic.