🛥️🐳 KSail

KSail is a tool that bundles common Kubernetes tooling into a single binary. It provides a VSCode Extension, CLI, AI-Enabled Chat TUI or MCP interface to create clusters, deploy workloads, and operate cloud-native stacks across different distributions and providers.

Quick Install

# macOS / Linux (Homebrew)
brew install --cask devantler-tech/tap/ksail

# Go (1.26.1+)
go install github.com/devantler-tech/ksail/v5@latest

See the Installation Guide for binary downloads and more options.

Quick Start

# 1. Create a project and spin up a cluster (only requires Docker)
ksail cluster init --name my-app
ksail cluster create

# 2. Connect to your cluster with K9s
ksail cluster connect

That's it — zero to a running cluster in under a minute.

What KSail Replaces

Most Kubernetes workflows require juggling multiple tools:

kind + k3d + kubectl + helm + kustomize + flux + argocd + sops + k9s + kubeconform + ...

KSail bundles these into one binary:

| Category | Built-in Capabilities | |--------------------------|------------------------------------------------------------| | Cluster Provisioning | Kind, K3d, Talos, VCluster (Vind) | | Container Orchestration | kubectl, Helm, Kustomize | | GitOps Engines | Flux, ArgoCD | | Secrets Management | SOPS with Age encryption | | Manifest Validation | Kubeconform | | Cluster Operations | K9s, backup & restore | | AI Integration | Chat assistant (Copilot SDK), MCP server, VSCode extension | | Infrastructure Providers | Docker (local), Hetzner Cloud, Sidero Omni |

Only Docker is required — no other tools to install, configure, or keep in sync.

Why KSail?

Setting up and operating Kubernetes clusters often requires juggling multiple CLI tools, writing bespoke scripts, and dealing with inconsistent workflows. KSail removes the tooling overhead so you can focus on your workloads.

Key Features

• 📦 One Binary — Embeds cluster provisioning, GitOps engines, and deployment tooling. No tool sprawl.
• ☸️ Simple Clusters — Spin up Vanilla, K3s, Talos, or VCluster clusters with one command. Same workflow across distributions.
• 🔓 No Lock-In — Uses native configs (kind.yaml, k3d.yaml, Talos patches, vcluster.yaml). Run clusters with or without KSail.
• 📥 Mirror Registries — Avoid rate limits, and store images once. Same mirrors used by different clusters.
• 📄 Everything as Code — Cluster settings, distribution configs, and workloads in version-controlled files.
• 🔄

... View full README on GitHub