kportal logo

Kubernetes Port-Forward
Manager

Terminal interface for professionals managing multiple Kubernetes port-forwards with auto-reconnect, hot-reload, and real-time health monitoring. No, it's not a wrapper for the kubectl command.

Version License Go Report
kportal terminal interface

Features

Everything you need for production-grade port-forwarding

Live Add

Add forwards on-the-fly

Live Edit

Modify in real-time

Live Delete

Remove instantly

Toggle Forwards

Enable/disable with Space

Auto-Reconnect

Exponential backoff retry

Hot-Reload

Config changes auto-apply

Health Checks

Real-time monitoring

Multi-Context

All clusters in one place

Installation

Get started in seconds

Homebrew

macOS & Linux

brew install lukaszraczylo/brew-taps/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