Port Forwarding

Port Forwarding

Podex provides one-click port forwarding to your cluster resources directly from the Explorer table.

How It Works

Click the port icon on any supported resource row to open a dialog, enter a local port (e.g., 8080), and the backend handles the rest:

1. Spawns a kubectl port-forward --address 0.0.0.0 subprocess
2. Auto-detects the container port if not specified
3. Returns a clickable http://127.0.0.1:PORT link (local) or a badge (Docker/sandbox)

Supported Resources

• Pods
• Services
• Deployments
• StatefulSets
• DaemonSets

Port Mapping

• When both port and target_port are provided: kubectl port-forward kind/name PORT:TARGET_PORT -n namespace
• When only port is provided: maps localhost:PORT to the resource's first container port

Docker Support

When running in Docker, the backend automatically:

• Patches kubeconfig replacing 127.0.0.1 with host.docker.internal
• Adds insecure-skip-tls-verify for self-signed certificates
• Sets missing current-context if needed

API Endpoints

POST /api/kube/port-forward
  Body: { kind, name, namespace, port, target_port? }
  Returns: { pid, port, target_port, is_docker }

DELETE /api/kube/port-forward/{pid}
  Kills the port-forward subprocess by PID.