node package manager


node wrapper for ngrok


Ngrok exposes your localhost to the web.


var ngrok = require('ngrok');
ngrok.connect(function (err, url) {});
npm install ngrok -g
ngrok http 8080

You can create basic http-https-tcp tunnel without authtoken. For custom subdomains and more you should obtain authtoken by signing up at Once you set it, it's stored in ngrok config and used for all tunnels. Few ways:

ngrok.authtoken(token, function(err, token) {});
ngrok.connect({authtoken: token, ...}, function (err, url) {});
ngrok authtoken <token>
var ngrok = require('ngrok');
ngrok.connect(function (errurl) {}); // -> http://localhost:80 
ngrok.connect(9090, function (errurl) {}); // -> http://localhost:9090 
ngrok.connect({proto: 'tcp', addr: 22}, function (errurl) {}); // tcp:// 
ngrok.connect(opts, function(errurl) {});
proto: 'http', // http|tcp|tls 
addr: 8080, // port or network address 
auth: 'user:pwd', // http basic authentication for tunnel 
subdomain: 'alex', // reserved tunnel name, 
authtoken: '12345' // your authtoken from 
}, function (errurl) {});

Other options: name, inspect, host_header, bind_tls, hostname, crt, key, client_cas, remote_addr - read here

The ngrok and all tunnels will be killed when node process is done. To stop the tunnels use

ngrok.disconnect(url); // stops one 
ngrok.disconnect(); // stops all 
ngrok.kill(); // kills ngrok process 

Also you can use ngrok as an event emitter, it fires "connect", "disconnect" and "error" events

ngrok.once('connect', function (url) {};

You can use ngrok's configurations files, then just pass name option when making a tunnel. Configuration files allow to specify more options, eg ngrok region you want to use.

OS X /Users/example/.ngrok2/ngrok.yml
Linux /home/example/.ngrok2/ngrok.yml
Windows C:\Users\example\.ngrok2\ngrok.yml

When tunnel is established you can use the ngrok interface to inspect the webhooks done via ngrok.

npm install downloads ngrok binaries for you platform and puts them into bin folder. You can host binaries yourself and set NGROK_CDN_URL env var before installing ngrok.

First time you create tunnel ngrok process is spawned and runs until you disconnect or when parent process killed. All further tunnels are created or stopped by using internal ngrok api which usually runs on

Please run git update-index --assume-unchanged bin/ngrok to not override ngrok stub in your pr. Unfortunately it can't be gitignored.