Skip to main content

Agent SDKs


Agent SDKs enable you to embed ngrok directly into your application. They allow you to programmatically create ngrok endpoints. You handle connections from ngrok's edge just as if you opened a socket to listen on a port.

Example Usage

import (


func ngrokListener(ctx context.Context) (net.Listener, error) {
return ngrok.Listen(ctx,

Go Package Docs:

Supported Languages

Gongrok-go docsngrok-go
Rustngrok-rust docsngrok-rust

When should I use Agent SDKs?

Agent SDKs are often a better fit for your use case over using the ngrok agent. This is especially true when running ngrok with production apps. Agent SDKs are a better choice if:

  • You don't want to manage the lifetime of a separate agent process
  • You don't want to bundle and distribute the ngrok agent
  • The ngrok agent doesn't run on your target platform
  • The ngrok agent's resource requirements are too high for your target platform
  • You want fine-grained programmatic control over the agent's functionality


The agent SDKs are available to all ngrok users at no additional charge. You only incur costs if the resources provisioned by the SDKs incur a cost.