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 Docker

ngrok is included in the Docker Compose stack. Start it alongside Frona:

mise run docker: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_VOICE_CALLBACK_BASE_URL = "https://abcd1234.ngrok-free.app"

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