More often than I’d like to admit, I use Port Forwarding to troubleshoot issues with my deployed Kubernetes services.

Port Forwarding can be setup for Pods, Deployments ReplicaSets and Services.

Quick reference for different resource types:

The syntax is:

kubectl port-forward <kubernetes-resource-name> <locahost-port>:<pod-port>

For example: kubectl port-forward my-awesome-pod 1337:8080 will forward 8080 from the pod to 1337 on localhost.


kubectl port-forward nginx-master-345fadbad1-abcd 1337:80 

alternative syntax for pods

kubectl port-forward pods/nginx-master-345fadbad1-abcd 1337:80


kubectl port-forward deployment/nginx-master 1337:80 


kubectl port-forward rs/nginx-master 1337:80


kubectl port-forward svc/nginx-master 1337:80

After you run these commands the Pod/Deployment/ReplicaSet/Service is available on your machine on port 1337. Port forwarding has already saved my life in many debugging sessions.

About the Author:

Marcus "Mo" Eisele

Marcus is fascinated by technology. He loves learning new things.
He is a Software Engineer at Daimler TSS and has a personal blog at