Stay organized with collections
Save and categorize content based on your preferences.
Name
kf proxy-route - Start a local reverse proxy to a Route.
Synopsis
kf proxy-route ROUTE [flags]
Description
Proxy route 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 to match
the Route. If multiple Apps are mapped to the same route, the traffic sent
over the proxy will follow their routing rules with regards to weight.
If no Apps are mapped to the route, traffic sent through the proxy will
return a HTTP 404 status code.
Proxy route DOES NOT establish a direct connection to any Kubernetes resource.
For proxy to work:
The cluster's gateway MUST be accessible from your local machine.
The Route MUST have a public URL
Examples
kf proxy-route myhost.example.com
Flags
--gateway=string
IP address of the HTTP gateway to route requests to.
-h, --help
help for proxy-route
--port=int
Local port to listen on. (default 8080)
Inherited flags
These flags are inherited from parent commands.
--as=string
Username to impersonate for the operation.
--as-group=strings
Group to impersonate for the operation. Include this flag multiple times to specify multiple groups.
--config=string
Path to the Kf config file to use for CLI requests.
--kubeconfig=string
Path to the kubeconfig file to use for CLI requests.
--log-http
Log HTTP requests to standard error.
--space=string
Space to run the command against. This flag 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-08-28 UTC."],[],[],null,["# kf proxy-route\n\n### Name\n\n`kf proxy-route` - Start a local reverse proxy to a Route.\n\n### Synopsis\n\n```\nkf proxy-route ROUTE [flags]\n```\n\n### Description\n\nProxy route creates a reverse HTTP proxy to the cluster's gateway on a local\nport opened on the operating system's loopback device.\n\nThe proxy rewrites all HTTP requests, changing the HTTP Host header to match\nthe Route. If multiple Apps are mapped to the same route, the traffic sent\nover the proxy will follow their routing rules with regards to weight.\nIf no Apps are mapped to the route, traffic sent through the proxy will\nreturn a HTTP 404 status code.\n\nProxy route DOES NOT establish a direct connection to any Kubernetes resource.\n\nFor proxy to work:\n\n- The cluster's gateway MUST be accessible from your local machine.\n- The Route MUST have a public URL\n\n### Examples\n\n```\nkf proxy-route myhost.example.com\n```\n\n### Flags\n\n`--gateway=`\u003cvar translate=\"no\"\u003estring\u003c/var\u003e\n\n: IP address of the HTTP gateway to route requests to.\n\n`-h, --help`\n\n: help for proxy-route\n\n`--port=`\u003cvar translate=\"no\"\u003eint\u003c/var\u003e\n\n: Local port to listen on. (default 8080)\n\n### Inherited flags\n\nThese flags are inherited from parent commands.\n\n`--as=`\u003cvar translate=\"no\"\u003estring\u003c/var\u003e\n\n: Username to impersonate for the operation.\n\n`--as-group=`\u003cvar translate=\"no\"\u003estrings\u003c/var\u003e\n\n: Group to impersonate for the operation. Include this flag multiple times to specify multiple groups.\n\n`--config=`\u003cvar translate=\"no\"\u003estring\u003c/var\u003e\n\n: Path to the Kf config file to use for CLI requests.\n\n`--kubeconfig=`\u003cvar translate=\"no\"\u003estring\u003c/var\u003e\n\n: Path to the kubeconfig file to use for CLI requests.\n\n`--log-http`\n\n: Log HTTP requests to standard error.\n\n`--space=`\u003cvar translate=\"no\"\u003estring\u003c/var\u003e\n\n: Space to run the command against. This flag overrides the currently targeted Space."]]
