Clarify ngrok Free plan behavior and suggest reverse proxy workaround on quickstart.md#242
Clarify ngrok Free plan behavior and suggest reverse proxy workaround on quickstart.md#242minnsou wants to merge 1 commit intomicromdm:mainfrom
Conversation
Clarify ngrok Free plan behavior and suggest reverse proxy workaround
It's unclear why this is a requirement just because it's mentioned in the guide. The separate URLs are just a byproduct of ngrok generating separate hostnames in the past. For example MicroMDM has used a single URL from the get-go. |
|
Thanks for the clarification — I agree that separate hostnames are not However the quickstart currently runs both services directly behind ngrok Example ngrok config: version: 2
authtoken: xxxxxxxxxxxxxxxxxxxxx
tunnels:
scep:
proto: http
addr: 8080
nanomdm:
proto: http
addr: 9000Example result: In this case ngrok does not route based on path. Instead it effectively For example: This means the workaround using the tunnels stanza may not work as My intention with the note was to clarify this behavior and suggest a |
The current quickstart suggests using two ngrok tunnels for the SCEP server
and NanoMDM server and provides a workaround using the
tunnelsstanzawhen the user encounters the "1 simultaneous ngrok agent" limitation.
However, with modern versions of ngrok (v3) on the Free plan, multiple HTTP
tunnels may be multiplexed onto the same public hostname. In practice this
can result in output like:
In this situation both the SCEP server and NanoMDM server are exposed under
the same hostname, which prevents configuring separate URLs in the
enrollment profile as described later in this guide.
This PR adds a short note explaining this behavior and suggests a simple
workaround: running a local reverse proxy (e.g. nginx) and exposing a
single ngrok endpoint while routing paths to the appropriate backend
services.
Example routing:
This keeps the quickstart simple while allowing the guide to work correctly
with ngrok v3 Free accounts.