Stay organized with collections
Save and categorize content based on your preferences.
Name
kf proxy - Start a local reverse proxy to an App
Synopsis
kf proxy APP_NAME [flags]
Description
Proxy creates a reverse HTTP proxy to the cluster's gateway on a local port opened on the operating system's loopback device.
The proxy rewrites all HTTP requests, changing the HTTP Host header and adding an additional header X-Kf-App to ensure traffic reaches the specified app even if multiple are attached to the same route.
Proxy DOES NOT establish a direct connection to the App.
For proxy to work:
The cluster's gateway MUST be accessible from your local machine.
The app MUST have a public URL
If you need to establish a direct connection to an App, use the port-forward command in kubectl. It establishes a proxied connection directly to a port on a pod via the Kubernetes cluster. port-forward bypasses all routing.
Examples
kf proxy myapp
Flags
--gateway=string
HTTP gateway to route requests to (default: autodetected from cluster)
-h, --help
help for proxy
--port=int
Local port to listen on (default 8080)
Inherited flags
These flags are inherited from parent commands.
--config=string
Config file (default is $HOME/.kf)
--kubeconfig=string
Kubectl config file (default is $HOME/.kube/config)
--log-http
Log HTTP requests to stderr
--space=string
Space to run the command against. This overrides the currently targeted space
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-09-04 UTC."],[],[],null,["# kf proxy\n\n### Name\n\n`kf proxy` - Start a local reverse proxy to an App\n\n### Synopsis\n\n```\nkf proxy APP_NAME [flags]\n```\n\n### Description\n\nProxy creates a reverse HTTP proxy to the cluster's gateway on a local port opened on the operating system's loopback device.\n\nThe proxy rewrites all HTTP requests, changing the HTTP Host header and adding an additional header X-Kf-App to ensure traffic reaches the specified app even if multiple are attached to the same route.\n\nProxy DOES NOT establish a direct connection to the App.\n\nFor proxy to work:\n\n- The cluster's gateway MUST be accessible from your local machine.\n- The app MUST have a public URL\n\n If you need to establish a direct connection to an App, use the port-forward command in kubectl. It establishes a proxied connection directly to a port on a pod via the Kubernetes cluster. port-forward bypasses all routing.\n\n### Examples\n\n```\n kf proxy myapp\n```\n\n### Flags\n\n`--gateway=`\u003cvar translate=\"no\"\u003estring\u003c/var\u003e\n: HTTP gateway to route requests to (default: autodetected from cluster)\n\n`-h, --help`\n: help for proxy\n\n`--port=`\u003cvar translate=\"no\"\u003eint\u003c/var\u003e\n: Local port to listen on (default 8080)\n\n### Inherited flags\n\nThese flags are inherited from parent commands.\n\n`--config=`\u003cvar translate=\"no\"\u003estring\u003c/var\u003e\n: Config file (default is $HOME/.kf)\n\n`--kubeconfig=`\u003cvar translate=\"no\"\u003estring\u003c/var\u003e\n: Kubectl config file (default is $HOME/.kube/config)\n\n`--log-http`\n: Log HTTP requests to stderr\n\n`--space=`\u003cvar translate=\"no\"\u003estring\u003c/var\u003e\n: Space to run the command against. This overrides the currently targeted space"]]
