thv_proxy_tunnel.md

title	thv proxy tunnel
hide_title	true
description	Reference for ToolHive CLI command `thv proxy tunnel`
last_update	author autogenerated
slug	thv_proxy_tunnel
mdx	format md

thv proxy tunnel

Create a tunnel proxy for exposing internal endpoints

Synopsis

Create a tunnel proxy for exposing internal endpoints.

TARGET may be either:

• a URL (http://..., https://...) -> used directly as the target URI • a workload name -> resolved to its URL

Examples: thv proxy tunnel http://localhost:8080 my-server --tunnel-provider ngrok thv proxy tunnel my-workload my-server --tunnel-provider ngrok

Flags: --tunnel-provider string The provider to use for the tunnel (e.g., "ngrok") - mandatory --provider-args string JSON object with provider-specific arguments: auth-token (mandatory), url, pooling, traffic-policy-file --dry-run If set, only validate the configuration without starting the tunnel

Examples: thv proxy tunnel --tunnel-provider ngrok --provider-args '{"auth-token": "your-token", "url": "https://example.com", "pooling": true}' http://localhost:8080 my-server thv proxy tunnel --tunnel-provider ngrok --provider-args '{"auth-token": "your-token", "traffic-policy-file": "/path/to/policy.yml"}' my-workload my-server

thv proxy tunnel [flags] TARGET SERVER_NAME

Options

  -h, --help                     help for tunnel
      --provider-args string     JSON object with provider-specific arguments (default "{}")
      --tunnel-provider string   The provider to use for the tunnel (e.g., 'ngrok') - mandatory

Options inherited from parent commands

      --debug   Enable debug mode

SEE ALSO

• thv proxy - Create a transparent proxy for an MCP server with authentication support