Skip to main content

Philosophy

When you encounter an error while using ngrok, ngrok reports a globally unique error code. Each error code corresponds to a specific location in ngrok’s code, which helps ngrok quickly identify where something went wrong and helps you know exactly how to fix it. When you report a bug or email ngrok support about an issue, include the unique error code if you have encountered one. It helps ngrok diagnose and solve your issue much more quickly. ngrok’s error codes were also designed so that you can paste them into your favorite search engine and immediately find a dedicated page with instructions on how to fix your problem.

Programmatic error handling

When you work with ngrok programmatically, ngrok returns these unique error codes in a structured way so that you can write software which appropriately handles different error conditions.

Common errors

You’re more likely to run into some errors than others. The most common are listed here to help make your troubleshooting easier.

All errors

Consult the Errors Reference Documentation for a complete list of all of ngrok’s error codes.

Customize error pages for your traffic

To access and provide feedback on a development preview of custom error pages Fill out the form.