Developer
Get Support
Sign in
Get Support
Sign in
DOCUMENTATION
Cloud
Data Center
Resources
Sign in
Sign in
DOCUMENTATION
Cloud
Data Center
Resources
Sign in
assistant
build
deploy
environments
install
providers
settings
storage
variables
version
Last updated Sep 3, 2025

tunnel

Description

start a tunnel to connect your local code with the app running in the development environment

Usage

1
2
Usage: forge tunnel [options]

Options

1
2
--verbose                                              enable verbose mode
-e, --environment [environment]                        specify the environment (see your default environment by running forge settings list)
-d, --debug                                            enable debugger mode
-f,--debugFunctionHandlers <debugFunctionHandlers...>  list of function handlers declared on manifest to debug, separated by space. This option must be specified if debug mode is enabled.  It is only used for Node runtime debugger
-p,--debugStartingPort [debugStartingPort]             starting port to use for debugging, multiple handlers will get subsequent ports. It is only used for Node runtime debugger (default: "9229")
-n, --no-verify                                        disable pre-tunnel checks
-h, --help                                             display help for command

For CLI versions 10.1.0 and beyond, tunnels running on Cloudflare do not require additional setup.

Further information

  • Debug functions using IntelliJ: This tutorial demonstrates debugging back-end Forge functions in Node.js with IntelliJ's debugger.
  • Debug functions using VSCode: This tutorial demonstrates debugging back-end Forge functions in Node.js with VS Code's debugger.
  • Tunneling: This guide explains how to debug in real-time between the local environment and the Forge platform.

Rate this page: