Debugging with ngrok


How can I debug with ngrok?


ngrok can be used to open a public tunnel to the VM which will provide access to the web application running inside the VM from devices not running in the same network. This can be, for example, used to test the website running inside your VM with your mobile phone.

Activate ngrok Inside The VM

ngrok is not active by default. You can activate it by adding the following line to the .customer_provision.yml inside the roles: section:

- role: ngrok
	     - de

Where de is the Project identifier you want to use ngrok for. You can add multiple Projects if you need to.

Then provision your Docker container or VM again:

vagrant up [--provider=docker] --provision

Because there are still issues with supervisor and systemd on Docker, you may need to reload the Docker container if you're using one.

vagrant reload ; vagrant ssh

List Active Tunnels

To get a list of all Active Tunnels, run the following command inside the VM / Docker container:

curl http://localhost:4040/api/tunnels | json_pp

The Tunnel URL listed under public_url can be used to access the respective project from any device.



Still need help? Contact us Contact us