FAQ & troubleshooting
Answers to common questions and quick fixes for the issues people hit most often.
I get certificate errors on HTTPS sites
The device or tool isn't trusting the BlankTrail Proxy root certificate. Install it from the dashboard's CA Certificate button, then restart the browser or tool. On Windows the installer usually does this for you; other devices need it installed manually.
"Port already in use" or a 409 error
The port you asked for is taken — either already open in BlankTrail Proxy or used by another program. Pick a different port, or use the dashboard's suggested free port (the API's /ports/suggest endpoint does the same).
My license won't activate
- Confirm you're using your blanktrail.com account email and password.
- Check the machine has internet access to reach the licensing server.
- If your account has two-factor confirmation, complete the ticket step.
- Still stuck? Contact support from your account.
How do I make sure a proxy isn't leaking?
Use the pre-flight leak check in the Open Port dialog, or the /upstream/test API with the "leak" check, before opening a port. It compares the DNS resolver against the exit IP and probes for an IPv6 escape route, so a leaky egress is caught up front.
Where do I find my API key?
Open the dashboard, click the gear icon to open Settings, and copy the API key shown there. You can rotate it in the same place if it may have been exposed. Send it as the X-API-Key header on API calls.
How do I update?
BlankTrail Proxy keeps itself current automatically. On Windows you can also re-run the installer and choose "Update — keep license, settings and password". On Linux, updates arrive through the service; your license and settings are preserved.
How do I get help?
Sign in to your account at blanktrail.com and open support (Telegram or web chat). If you hit a bug in the app, the Settings dialog has a "Report a bug" option that sends a redacted diagnostic bundle to our team with your consent.