Ngrok evaluation
Quick start

OneView documentation

Ngrok evaluation

Test behind NAT without router configuration.

Purpose

Ngrok is a temporary evaluation option for a computer behind NAT. It creates an outbound tunnel, supplies a public HTTPS development hostname, and avoids router configuration. Do not use this mode as the production deployment.

1. Prepare ngrok

Install ngrok on the OneView computer, sign in, and configure the account authentication token. Start the endpoint:

ngrok http 8080

Note the assigned hostname, for example example-name.ngrok-free.app, without the https:// scheme.

2. Reconfigure or install OneView

Run the current installation command from the approved OneView delivery channel. Select External reverse proxy, enter the assigned ngrok hostname, and use the local ngrok agent as the trusted proxy. Follow the port shown by the installer when starting ngrok.

3. Open setup

Keep ngrok running and open:

https://example-name.ngrok-free.app/setup

The hostname used by the installer must exactly match the active ngrok hostname because OneView validates browser origins and uses secure cookies.

If setup is incomplete, use the installer's supported pre-setup reconfiguration. Once setup is complete, use the documented Network settings workflow.