Ngrok Config
Last updated
Last updated
Visit the Ngrok website and sign up or log in.
Navigate to the download section and select the version for Windows.
Download the ZIP file.
Copy the Auth Token and keep it separately later this will be used to set the ngrok.yml config file
Once downloaded, extract the ZIP file to a folder of your choice, such as C:\ngrok\
. This folder will contain the ngrok.exe
executable.
For Windows users:
Unzip the ngrok
executable to a directory, e.g., C:\ngrok\
.
Right-click on ‘This PC’ or ‘Computer’ on your desktop and select ‘Properties’.
Click on ‘Advanced system settings’.
Click on the ‘Environment Variables‘ button.
In the ‘System variables’ section, find the ‘Path‘ variable and click ‘Edit’.
Click ‘New’ and add the path to the directory where you unzipped ngrok
(e.g., C:\ngrok\
).
Click ‘OK’ to close the dialogs and apply the changes.
Now, ngrok
can be run from the command line regardless of the current directory.
Go to the Ngrok portal, navigate to Domains -> New Domain, and create your free domain.
Open the command prompt in Windows.
Enter the command ngrok config edit
.
This opens the ngrok config file. Enter your Auth Token, Tunnel Name, hostname, and addr as follows:
Replace <Your Auth Token>
with your actual Ngrok authentication token and <your-chosen-hostname>
with the hostname you’ve set up.
Keep Your Ngrok Auth Token Secure: Your Ngrok authentication token is the key to creating tunnels with your account. Keep it secure to prevent unauthorized access.
Use Strong Authentication for Exposed Services: If you’re exposing a web service or application, ensure it has its own strong authentication mechanism.
Monitor Tunnel Usage: Regularly review logs and monitor tunnel usage for any unexpected or unauthorized access.
Limit Exposure Time: Only keep tunnels open for as long as necessary. The longer a tunnel is open, the higher the potential security risk.