funnel

CLI Reference

All funnel client commands and flags

funnel http

Create an HTTP tunnel to a local service.

funnel http <address>

<address> is a port number or host:port. If only a port is given, localhost is assumed.

FlagDescription
--id, -iTunnel ID (subdomain). Generated if omitted
--server, -sServer URL, overrides context config
--token, -tAuth token, overrides context config
--quic-portQUIC port on the server, overrides auto-discovery
--insecureSkip TLS certificate verification
--teamAssociate tunnel with a team
funnel http 3000
funnel http 3000 --id my-app
funnel http 127.0.0.1:8080 --server https://tunnel.example.com

funnel login

Authenticate via OAuth. Opens a browser for the OAuth flow and stores the received token.

funnel login
funnel login --provider gitlab
FlagDefaultDescription
--providergithubOAuth provider name

funnel logout

Clear the stored token for the current context.

funnel logout

funnel whoami

Show the currently authenticated user.

funnel whoami

funnel status

List active tunnels on the server.

funnel status

funnel keys

Manage API keys.

funnel keys create --name "deploy-key"
funnel keys list

funnel sessions

View tunnel session history.

funnel sessions
funnel sessions --all    # admin only: show all users
funnel sessions --limit 100

funnel users

Manage users (admin only).

funnel users list
funnel users set-role --user <id> --role admin

funnel teams

Manage teams.

funnel teams create --name backend
funnel teams list
funnel teams add-member --team <id> --user <id>
funnel teams remove-member --team <id> --user <id>
funnel teams list-members --team <id>
funnel teams set-member-role --team <id> --user <id> --role owner

funnel context

Manage server contexts. See contexts for details.

funnel context create <name> --server <url>
funnel context use <name>
funnel context list
funnel context delete <name>

funnel config

View the current configuration.

funnel config show

Global flags

FlagDescription
--context, -cUse a specific context for this command
--versionPrint version and protocol info
--helpPrint help

On this page