KTube Documentation

Welcome to KTube - the open-source Kubernetes Tunnel Operator that unifies multiple tunnel providers into a single, Kubernetes-native interface.

What is KTube?

KTube is a Kubernetes operator that simplifies exposing your services to the internet through tunnel providers like Cloudflare Tunnel, ngrok, and Microsoft Dev Tunnels.

Instead of managing different CLIs, configuration formats, and dashboards for each provider, KTube gives you:

One CRD format that works with any provider
One dashboard to manage all tunnels
One CLI to install and operate
GitOps compatibility out of the box

Quick Example

apiVersion: ktube.dev/v1alpha1
kind: Tunnel
metadata:
  name: my-app
spec:
  providerRef:
    name: cloudflare-provider  # Just change this to switch providers
  target:
    service: my-app-service
    port: 8080

Get Started

Getting Started

5-minute guide to your first tunnel

Installation

CLI, Helm, or kubectl options

Providers

Cloudflare, ngrok, Dev Tunnels

CLI Reference

All CLI commands explained

Key Features

🔌

Multi-Provider Support

Built-in support for Cloudflare, ngrok, and Dev Tunnels. Switch without changing your app.

🎨

Beautiful Dashboard

Modern web UI to visualize and manage all your tunnels in one place.

🛠️

Zero-Dependency CLI

Single binary with embedded Helm and Kind. No external tools required.

📦

GitOps Ready

Works with ArgoCD, Flux, and any GitOps workflow out of the box.

Architecture Overview

┌─────────────────────────────────────────────────────────────┐
│                    Kubernetes Cluster                        │
│  ┌─────────────────────────────────────────────────────────┐│
│  │                   KTube Operator                         ││
│  │  ┌─────────────┐ ┌─────────────┐ ┌─────────────────┐    ││
│  │  │ Cloudflare  │ │   ngrok     │ │   Dev Tunnels   │    ││
│  │  │ Controller  │ │ Controller  │ │   Controller    │    ││
│  │  └──────┬──────┘ └──────┬──────┘ └───────┬─────────┘    ││
│  │         └───────────────┼────────────────┘              ││
│  │                         ▼                                ││
│  │              Reconciliation Loop                         ││
│  └─────────────────────────┬───────────────────────────────┘│
│                            ▼                                 │
│  ┌─────────────────────────────────────────────────────────┐│
│  │              Your Kubernetes Services                    ││
│  └─────────────────────────────────────────────────────────┘│
└─────────────────────────────────────────────────────────────┘
                             │
                             ▼
              ┌──────────────────────────┐
              │        Internet          │
              │  (via tunnel providers)  │
              └──────────────────────────┘

Community

GitHub - Star us, report issues, contribute
Discord - Chat with the community
Twitter - Follow for updates