hgrok - Introspected tunnels to localhost (homepage)
”I want to expose a local hasura project behind a NAT or firewall to the internet.”
What is hgrok?
hgrok is a fork of ngrok for developers to expose their local hasura projects to the Internet via a secure tunnel.
What can I do with hgrok?
- Expose any http service behind a NAT or firewall to the internet on a subdomain of hasura.me. If you choose a subdomain called
john, requests to*.john.hasura.mewill come through the tunnel to your server.
What is hgrok useful for?
- Temporarily sharing your hasura project that is only running on your development machine
- Demoing an app at a hackathon without deploying to a cloud provider
Usage
-
Register an account at hasura
-
Configure your hasura.me subdomain at https://dev.beta.hasura.io/local-development
-
Go to http://console.vcap.me/advanced and add your new hasura.me domain in the Domain Configuration section.
-
Get your hasura.io api token from https://dev.beta.hasura.io/settings
-
Download the hgrok binary for your OS from releases
-
Rename the downloaded file to
hgrok(just to make it easier to run the next set of commands) -
Run
chmod +x hgrokafter downloading the binary -
Run the following command if you are running a server on minikube (mac/linux):
sudo ./hgrok -authtoken="<api-token>" -subdomain="<subdomain>" -proto=http $(minikube ip):80
- Get your minikube ip, and substitute <minikube-ip> in the command below:
sudo ./hgrok -authtoken="<api-token>" -subdomain="<subdomain>" -proto=http <minikube-ip>:80
- Run the following command if you are running a server on localhost:80
sudo ./hgrok -authtoken="<api-token>" -subdomain="<subdomain>" -proto=http 80
Thank you ngrok!
hgrok is a fork of the awesome ngrok. That means you can do pretty much everything you do with ngrok, wth hgrok too!