KSail

[GitHub Stars] [Latest Release] [License] [Go Reference] [CI - KSail]

🛥️🐳 KSail

[KSail command-line interface]

KSail brings Kubernetes cluster setup, application deployment and everyday operations into one tool. Create local clusters with Docker, or work with supported cloud providers and existing Kubernetes clusters. Use it from your terminal, VS Code or an AI assistant.

📖 Documentation · Quickstart · Support

What you get

See features and the support matrix for supported platforms and combinations. KWOK simulates clusters; it does not run applications. Cloud providers need their own setup and incur charges.

Quick install

On Linux or an Apple Silicon Mac, with curl, tar and sha256sum or shasum available:

curl -fsSL https://github.com/devantler-tech/ksail/releases/latest/download/install.sh | sh

The installer verifies the download and prints where it installed KSail. Follow its PATH instruction if needed. Prefer Homebrew or a Windows download? See installation options.

Quick start

Create a project in a new directory:

mkdir my-appcd my-appksail project init --name my-app --distribution Vanilla --provider Docker

This creates your project files without needing Docker or a cloud account. With Docker Engine or Docker Desktop running, start and explore a local cluster:

ksail cluster createksail cluster connect

This creates a local Kubernetes cluster and opens K9s to explore it. Enter :quit to leave K9s. When finished, delete the trial cluster and its applications:

ksail cluster delete --name my-app --provider Docker

Review the cluster name and confirm deletion when prompted. Project files remain for reuse.

Continue with the quickstart guide to deploy an application. The reader reference covers local setup details, cloud providers and optional AI assistant plugins.

Community & support

• 💬 Discussions — questions and ideas.
• 🐛 Issues — bugs and feature requests.
• 🎓 Resources — presentations and tutorials.
• 🛠️ Contributing — make your first contribution.

License

KSail is source-available under PolyForm Shield 1.0.0, with use, redistribution and noncompetition terms. See the licensing guide and full license before reusing it.