Get started with Localhost | HumongouS.io Documentation
Get started with Localhost

HumongouS.io currently does not support offline connections out of the box but if for some reason you are not able to access your database from the cloud or you just want to test out how your development database would work with Humongous.io then, you can connect your local database to the platform through a secure tunnel with this simple workaround called ngrok.

Ngrok is a command line application that exposes locally networked services to the internet over a secure tunnel even if those services are hidden behind NATs and firewalls. This means, with ngrok, you are able to:

  • Share local websites
  • Self-host personal services
  • Build and test webhook consumers

To use ngrok, you first need to download the latest version for your OS here. After downloading,

Windows users :

  • Extract ngrok.exe from zip file
  • Run the (.exe) file.

Mac OS users :

  • Open the command line terminal
  • Navigate to the directory containing the ngrok file you downloaded. You can verify the existence of the file within the directory by typing ls in the terminal. This command lists all the files and folders within the current directory.

Ubuntu users can use the above process as well.

Now in the terminal window (“command prompt” for Windows users) type:

ngrok tcp 27017

This command will let ngrok initiate a new connection on port 27017. 27017 is the default MongoDB port but you can use any available port on your localhost. At this stage, make sure MongoDB is running on your local computer and if you have followed the tutorial up to this point you should see a window like the one below.

Ngrok started on port 27017

Notice the highlighted area in the Forwarding row, this is the link we will use to connect our local database to the Humongous.io platform.

0.tcp.ngrok.io:58964

Copy the link (without the tcp:// prefix) and paste it in the create project input on Humongous.io followed by the name of the database you would be using. So for instance, if you have a database named test on your localhost, then you will end up with a link like this:

0.tcp.ngrok.io:58964/test

Click save and you should be good to go from here on.

Email us on docs@humongous.io if you encounter issues with any of the steps above.