ngrok Go SDK Quickstart

A minimal Go app demonstrating the ngrok Go SDK.

What you'll need

• An ngrok account.
• Your ngrok auth token.
• Go installed on your machine.

Setup

1. Install dependencies:

   go mod tidy

2. Create a .env file from the example:

   cp .env.example .env

3. Add your ngrok auth token to the .env file:

   NGROK_AUTHTOKEN=your_actual_authtoken_here

4. Reserve a domain in the ngrok dashboard and add it to the .env file:

   NGROK_RESERVED_DOMAIN=your_actual_domain_here

Running the app

1. Start the Go service:

   go run service.go

2. In another terminal, start the ngrok agent endpoint:

   go run endpoint.go

The ngrok agent endpoint will output a URL that forwards traffic to your local app.

Files

• service.go - Basic Go HTTP server
• endpoint.go - ngrok agent endpoint configuration with OAuth
• .env.example - Environment variable template