git404hub

what is ktunnel fr?

fieldju/ktunnel — explained in plain English

Analysis updated 2026-07-17 · repo last pushed 2020-02-16

Audience · developerComplexity · 3/5DormantSetup · moderate

tl;dr

A CLI tool that creates a reverse tunnel so pods in a Kubernetes cluster can reach services running on your local machine.

vibe map

mindmap
  root((ktunnel))
    What it does
      Reverse tunnel to cluster
      Exposes local service
      Injects into deployments
    Tech stack
      Kubernetes
      Homebrew
    Use cases
      Local development iteration
      Debugging cluster interactions
      Testing local databases
    Audience
      Developers
      Ops and DevOps teams

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Let pods in a Kubernetes cluster call a web server running locally on your laptop.

VIBE 2

Debug how a cluster app interacts with a local database without deploying it.

VIBE 3

Inject a tunnel into an existing deployment so it can reach your local machine.

VIBE 4

Speed up iteration by skipping build-and-deploy cycles during development.

what's the stack?

KubernetesGoHomebrew

how it stacks up fr

fieldju/ktunnel0verflowme/alarm-clock0xhassaan/nn-from-scratch
Stars0
LanguageCSSPython
Last pushed2020-02-162022-10-03
MaintenanceDormantDormant
Setup difficultymoderateeasymoderate
Complexity3/52/54/5
Audiencedevelopervibe coderdeveloper

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · moderate time til it works · 30min

Requires an existing Kubernetes cluster and kubectl access.

in plain english

Ktunnel is a tool that creates a secure tunnel between your local machine and a Kubernetes cluster, letting applications running in the cluster access services on your computer. If you're developing an app locally and need pods or services in Kubernetes to talk to it, this tool bridges that gap without exposing your machine to the internet or requiring complex networking setup. Here's how it works in practice. You run a simple command on your laptop, and it establishes a reverse tunnel, think of it like a private bridge, between your local machine and the Kubernetes cluster. On one side, your local app is listening (say, a web server on port 8000). On the other side, the cluster sees it as a service it can call just like any other internal service. There are two main ways to use it: you can expose your local machine as a named service that any pod in the cluster can reach, or you can inject a tunnel directly into an existing deployment so that deployment can access your local machine. The typical user is a developer working on a feature or debugging an issue. Instead of deploying your incomplete code to the cluster and waiting for it to build and run, you keep it running on your laptop and let the cluster's services communicate with it directly. This speeds up iteration and makes debugging easier. You could also use it if you're testing how a Kubernetes application interacts with a local database, API, or microservice running on your development machine. The tool is fairly lightweight and can be installed via Homebrew or built from source. It's specifically designed for the Kubernetes use case but the README notes it can also work as a general reverse tunnel tool for other systems if needed.

prompts (copy fr)

prompt 1
Show me how to use ktunnel to expose my local web server on port 8000 to a Kubernetes cluster.
prompt 2
Explain how ktunnel's inject mode differs from exposing a named service.
prompt 3
Help me install ktunnel via Homebrew and set up a basic reverse tunnel.
prompt 4
How would I use ktunnel to let a cluster pod talk to a local database during development?

Frequently asked questions

what is ktunnel fr?

A CLI tool that creates a reverse tunnel so pods in a Kubernetes cluster can reach services running on your local machine.

Is ktunnel actively maintained?

Dormant — no commits in 2+ years (last push 2020-02-16).

How hard is ktunnel to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is ktunnel for?

Mainly developer.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.