PTKublet Docs

Overview

PTKublet is a Tauri 2 desktop app with a Rust sidecar and React UI. Dashboards, YAML editing, logs, exec, port-forward, and WebSocket watches live in one native workspace (macOS).

Authentication is kubeconfig + cluster context — no separate login screen.

Screenshots

Shot	File	Shows
Hero	`dashboard.jpg`	Cluster health / node cards
Workloads	`workloads.jpg`	Workload overview charts
Deployments	`deployments.jpg`	Deployments + YAML editor
Pods	`pod-exec.jpg`	Pods list + exec terminal
Nodes	`nodes.jpg`	Nodes with resource bars
Cluster	`cluster.jpg`	Cluster-wide kubelet metrics

Quick start

git clone https://github.com/pertisktech/pertisk-kube-app.git
cd pertisk-kube-app

# Prerequisites: Rust 1.70+, Node 18+, a Kubernetes cluster
make run-desktop
# or: make run

On startup, pick a kubeconfig and context (persisted; switch later from the top bar).

macOS DMG

make build-desktop      # .app bundle
make build-macos-dmg    # PTKublet_*.dmg (embeds backend sidecar)

If you see Backend configuration error, set the backend binary path under Config → Desktop Settings (or PERTISK_BACKEND_BIN).

Core workflows

Watch — single WebSocket (/ws) for live add/update/delete on workloads, nodes, config, network, storage, RBAC, CRDs
Inspect — pod logs (REST), exec terminal (/api/exec), port-forward from the UI
Edit — YAML get/put with validation; scale and rollout restart for Deployments
Nodes — cordon, uncordon, drain; capacity and metrics
Backup — S3-compatible destination, schedules, inventory, restore

Permissions

PTKublet uses your kubeconfig credentials and cluster RBAC. Denied API calls surface as UI errors — the app does not escalate privileges.

Full documentation

Feature matrix, WebSocket coverage, and sidecar search order:

README