Mapping an App to a Route will cause traffic to be forwarded to the App if the App has instances that are running and healthy.
If multiple Apps are mapped to the same Route they will split traffic between them roughly evenly. Incoming network traffic is handled by multiple gateways which update their routing tables with slight delays and route independently. Because of this, traffic routing may not appear even but it will converge over time.
[[["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 map-route\n\n### Name\n\n`kf map-route` - Grant an App access to receive traffic from the Route.\n\n### Synopsis\n\n```\nkf map-route APP_NAME DOMAIN [--hostname HOSTNAME] [--path PATH] [--weight WEIGHT] [flags]\n```\n\n### Description\n\nMapping an App to a Route will cause traffic to be forwarded to the App if the App has instances that are running and healthy.\n\nIf multiple Apps are mapped to the same Route they will split traffic between them roughly evenly. Incoming network traffic is handled by multiple gateways which update their routing tables with slight delays and route independently. Because of this, traffic routing may not appear even but it will converge over time.\n\n### Examples\n\n```\n kf map-route myapp example.com --hostname myapp # myapp.example.com\n kf map-route myapp myapp.example.com # myapp.example.com\n kf map-route myapp example.com --hostname myapp --weight 2 # myapp.example.com, myapp receives 2x traffic\n kf map-route --space myspace myapp example.com --hostname myapp # myapp.example.com\n kf map-route myapp example.com --hostname myapp --path /mypath # myapp.example.com/mypath\n```\n\n### Flags\n\n`--async`\n: Do not wait for the action to complete on the server before returning.\n\n`--destination-port=`\u003cvar translate=\"no\"\u003eint32\u003c/var\u003e\n: Port on the App the Route will connect to.\n\n`-h, --help`\n: help for map-route\n\n`--hostname=`\u003cvar translate=\"no\"\u003estring\u003c/var\u003e\n: Hostname for the Route.\n\n`--path=`\u003cvar translate=\"no\"\u003estring\u003c/var\u003e\n: URL path for the Route.\n\n`--weight=`\u003cvar translate=\"no\"\u003eint32\u003c/var\u003e\n: Weight for the Route. (default 1)\n\n### Inherited flags\n\nThese flags are inherited from parent commands.\n\n`--as=`\u003cvar translate=\"no\"\u003estring\u003c/var\u003e\n: Username to impersonate for the operation.\n\n`--as-group=`\u003cvar translate=\"no\"\u003estrings\u003c/var\u003e\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: Path to the Kf config file to use for CLI requests.\n\n`--kubeconfig=`\u003cvar translate=\"no\"\u003estring\u003c/var\u003e\n: Path to the kubeconfig file to use for CLI requests.\n\n`--log-http`\n: Log HTTP requests to standard error.\n\n`--space=`\u003cvar translate=\"no\"\u003estring\u003c/var\u003e\n: Space to run the command against. This flag overrides the currently targeted Space."]]