Kubectl port-forward

kubectl port-forward forward one or more local ports to a pod.

• Man: https://www.mankier.com/1/kubectl-port-forward

Examples

• kubectl --namespace default port-forward $POD_NAME 3000
• kubectl port-forward svc/argocd-server -n argocd 8080:443

export POD_NAME=$(kubectl get pods --namespace default -l "app.kubernetes.io/name=grafana,app.kubernetes.io/instance=grafana" -o jsonpath="{.items[0].metadata.name}")

kubectl --namespace default port-forward $POD_NAME 3000
Forwarding from 127.0.0.1:3000 -> 3000
Forwarding from [::1]:3000 -> 3000

Examples with errors

kubectl --namespace default port-forward $POD_NAME 3000
error: unable to forward port because pod is not running. Current status=Failed

kubectl --namespace default port-forward $POD_NAME 3000
error: unable to forward port because pod is not running. Current status=Pending

kubectl --namespace default port-forward $POD_NAME 3000
error: You must be logged in to the server (Unauthorized)

kubectl --namespace default port-forward $POD_NAME 3000
error: TYPE/NAME and list of ports are required for port-forward
See 'kubectl port-forward -h' for help and examples

Related

• kubectl get pods
• Port forwarding
• kubectl proxy

See also

• kubectl: [ cp | config | create | delete | edit | explain | apply | exec | get | set | drain | uncordon | rolling-update | rollout | logs | run | auth | label | annotate | version | top | diff | debug | replace | describe | port-forward | proxy | scale | rollout | api-resources | expose deployment | expose | patch | attach | get endpoints | ~/.kube/config | kubectl logs --help | kubectl --help, kubectl-convert, kubectl autoscale, kubectl.kubernetes.io
• Kubernetes services, kubectl get services, kubectl describe service, kubectl create service [ loadbalancer | nodeport | clusterip | externalname ], kubectl expose, headless service, service.beta.kubernetes.io