Skip to main content

Networking and Tunnels

The example stack includes ngrok-related variables, but scripts/run_stack.sh does not start the ngrok service by default. Use this page only when you deliberately expose parts of the stack.

NGROK_AUTHTOKEN​

  1. Create an ngrok account (free tier works for development) and log in.
  2. Navigate to Getting Started → Your Authtoken.
  3. Copy the token string (2Hk...) and paste it into docker/.stack.env as NGROK_AUTHTOKEN.
  4. Keep the token secret; it grants access to your ngrok account limits.

NGROK_REGION​

  • Pick the region closest to your machine or the people testing with you. Common choices: us, eu, ap, au, sa, jp, in.
  • Check the ngrok region list if you need the full set.
  • Update the env variable whenever you move to a different geography to keep latency low.

NGROK_AGENT_EXTRA_ARGS​

  • Optional raw flags passed to ngrok.
  • Use this for reserved domains, request header behavior, or other advanced tunnel settings.