ngrok creates a public tunnel to your local Frona instance. This is required for features that need inbound webhooks, such as Twilio Voice.

Get an auth token

1. Create a free account at ngrok.com
2. Copy your auth token from the ngrok dashboard

Configure

Add your auth token to mise.local.toml:

[env]
NGROK_AUTHTOKEN = "2e..."

Run with a container runtime

ngrok is included in the Compose stack. Start it alongside Frona using the detected Podman or Docker runtime:

mise run container:dev

Once running, the ngrok inspection UI is available at http://localhost:4040. Open it to find your public URL (e.g. https://abcd1234.ngrok-free.app).

Configure Twilio callback

To use ngrok with Twilio Voice, set the callback base URL in your mise.local.toml:

[env]
FRONA_SERVER_EXTERNAL_URL = "https://abcd1234.ngrok-free.app"

This tells Frona to use the ngrok URL for Twilio and other inbound webhook callbacks while keeping local access unchanged.