Skip to content

Testing a JS Client app over HTTPS

Omnis Studio has a built in server for testing your remote forms and apps. However, this is only served on the local network over http.

If your remote form contains a feature that requires a secure context, such as accessing the user's camera device in the camera control, then this will fail to work when testing on a device other than the localhost. For example, if you use a mobile device on the same network to preview the app, pError in the relative event will be populated with an error code and description similar to:

Not Secure Context Error

Or perhaps you just want to temporarily share your progress and give someone outside your local network access to your app, either way, this short tech note is for you.


ngrok (available at is a small utility that can be used to provide a solution to the above use cases. The capabilities of ngrok far exceed this, but we are covering just its basic usage here to meet most Omnis developers basic needs for testing.

  • Download ngrok from for your platform (or follow the instructions to install via a package manager such as brew or chocolatey)
  • Sign up for a free ngrok account at
  • Once you are logged in, copy your auth token, open a terminal and run the following command:
    ngrok config add-authtoken <your-token-here>
  • You should then be able to create a tunnel with the following command (where port is your $serverport value):
    ngrok http <port>

ngrok should now be running in your terminal like in the image below:

ngrok tunnel app

The Forwarding line shows you the live address which is now pointing at your localhost:port

Copy this address and append the path to your html file, like /jschtml/jsCamera.htm, and share where you need to. You'll now be able to properly test features that require secure context on other devices and share your work with others.

Remember: The address is only temporary and will change next time you run ngrok.