Kubernetes Port-Forward
Manager

Professional terminal interface for managing multiple Kubernetes port-forwards with auto-reconnect, hot-reload, and real-time health monitoring.

Version License Go Report

Features

Everything you need for production-grade port-forwarding

Interactive TUI

Beautiful terminal interface powered by Bubble Tea. Toggle forwards on/off, view real-time status updates.

Auto-Reconnect

Automatic reconnection on failure with exponential backoff. Never lose connectivity to your services.

Hot-Reload

Configuration changes applied automatically. Add, remove, or modify forwards without restarting.

Health Checks

Real-time health monitoring with 5-second intervals. Grace period prevents false error alerts.

Error Reporting

Detailed error messages displayed in the interface. Know exactly what went wrong.

Multi-Context

Support for multiple Kubernetes contexts and namespaces. Manage all your clusters from one place.

Installation

Get started in seconds

Homebrew

macOS & Linux

brew install lukaszraczylo/tap/kportal

Quick Install

All platforms

curl -fsSL https://raw.githubusercontent.com/lukaszraczylo/kportal/main/install.sh | bash

Manual Download

Direct download from GitHub releases

Download Binary

Configuration

Simple YAML configuration

.kportal.yaml
contexts:
  - name: production
    namespaces:
      - name: backend
        forwards:
          - resource: service/postgres
            protocol: tcp
            port: 5432
            localPort: 5432
            alias: prod-db

      - name: frontend
        forwards:
          - resource: service/redis
            protocol: tcp
            port: 6379
            localPort: 6379
            alias: prod-redis

Resource Types

  • pod/name - Direct pod
  • service/name - Service
  • deployment/name - Deployment

Features

  • Pod prefix matching
  • Label selectors
  • Alias support
  • Auto-reconnect

Documentation

Everything you need to know