kubeshare

Share kubeconfig via QR code for KubePocket.

Quick Start

# Share kubeconfig (same WiFi)
kubeshare

# VPN cluster proxy (same WiFi)
kubeshare proxy

That's it! Just run and scan the QR code.

Usage

kubeshare [kubeconfig]           # Normal mode
kubeshare proxy [kubeconfig]     # Proxy mode for VPN clusters

Options (only when needed)

| Option | When to use | |--------|-------------| | -t, --tunnel | Phone not on same WiFi | | -o, --one-time | Extra security (link expires after download) | | --secure | Proxy mode: verify TLS certs (rarely needed) |

Examples

kubeshare                    # Share ~/.kube/config on local network
kubeshare proxy              # Proxy mode on local network
kubeshare -t                 # Share via public tunnel (remote access)
kubeshare proxy -t           # Proxy via public tunnel
kubeshare ~/other-config     # Share specific kubeconfig

Defaults

| Setting | Default | Override | |---------|---------|----------| | Network | Local (same WiFi) | -t for tunnel | | TLS verify | Disabled | --secure to enable | | Download | Unlimited | -o for one-time | | Kubeconfig | ~/.kube/config | Pass path as argument |

When to use Proxy Mode

Use kubeshare proxy when:

• Cluster is behind VPN
• Phone can't directly reach K8s API
• Your computer has access but phone doesn't

How it works:

Phone → kubeshare (your computer) → VPN → K8s API

Security

• All URLs include unique security token
• Optional one-time download with -o
• Keep terminal open only while sharing

Requirements

• Node.js 14+
• KubePocket app on iOS
• Same WiFi (or use -t for remote)

License

MIT