KSail bundles common Kubernetes tooling into a single binary. Spin up local clusters, deploy workloads, and operate cloud-native stacks across distributions and providers through a CLI, VS Code extension, AI chat TUI, or MCP server — with only Docker required.
📖 Full documentation: https://ksail.devantler.tech
# macOS / Linux (Homebrew)
brew install --cask devantler-tech/tap/ksail
# Go (1.26.1+)
go install github.com/devantler-tech/ksail/v7@latestSee the Installation Guide for binary downloads and more options.
Install the ksail plugin for GitHub Copilot CLI or Claude Code to auto-register ksail's MCP server and a ksail expertise skill.
Copilot CLI:
copilot plugin marketplace add devantler-tech/ksail
copilot plugin install ksailClaude Code:
/plugin marketplace add devantler-tech/ksail
/plugin install ksail@ksail
Requires ksail on PATH.
ksail cluster init --name my-app # scaffold project + native configs
ksail cluster create # spin up the cluster (Docker only)
ksail cluster connect # open K9sContinue with the Getting Started guide for GitOps, workloads, and multi-tenancy.
| Category | Built-in Capabilities |
|---|---|
| Cluster Provisioning | Kind, K3d, Talos, VCluster (Vind), KWOK (kwokctl), EKS |
| Container Orchestration | kubectl, Helm, Kustomize |
| GitOps Engines | Flux, ArgoCD |
| Secrets Management | SOPS with Age encryption |
| Manifest Validation | Kubeconform |
| Cluster Operations | K9s, backup & restore, multi-tenancy (ksail tenant) |
| AI Integration | Chat assistant (Copilot SDK), MCP server, VS Code extension |
| Infrastructure Providers | Docker (local), Hetzner Cloud, Sidero Omni, AWS |
See the feature overview and architecture guide for details.
| OS | Architecture |
|---|---|
| 🐧 Linux | amd64, arm64 |
| 🍎 macOS | arm64 |
| ⊞ Windows (native untested; WSL2 recommended) | amd64, arm64 |
| Provider | Vanilla | K3s | Talos | VCluster | KWOK | EKS |
|---|---|---|---|---|---|---|
| Docker | ✅ (Kind) | ✅ (K3d) | ✅ | ✅ (Vind) | ✅ (kwokctl) | — |
| Hetzner | — | — | ✅ | — | — | — |
| Omni | — | — | ✅ | — | — | — |
| AWS | — | — | — | — | — | 🚧 |
- 💬 GitHub Discussions — questions, ideas, and community
- 🐛 Issue Tracker — bugs and feature requests
- 📖 Documentation — guides, CLI reference, architecture
- 🎓 Resources — presentations, blog posts, tutorials
- ⭐ Star the repo — help others discover KSail
Contributions are welcome! See CONTRIBUTING.md for the development process, coding standards, and PR guidelines. Start with issues labeled good first issue.
| Project | Description | Type |
|---|---|---|
| devantler-tech/platform | My personal homelab | Platform |
Using KSail in your project? Open a PR to add it here.