kubara

🤔 What is kubara?

kubara is a single binary CLI tool written in Go providing a lightweight framework for bootstrapping Kubernetes platforms with production-proven best practices very easily.

This includes infrastructure provisioning, multi-tenancy setup, GitOps onboarding, and essential third-party tooling - all in a single reusable GitOps workflow.

kubara gives you a unified, reproducible way to deploy Kubernetes platforms with minimal effort and maximum consistency whether you're running on Cloud, Edge or Hybrid Setup.

kubara provides you with a reusable, extensible structure to build and operate your Kubernetes platform - including Terraform modules, Helm charts, and secrets management - while keeping configuration simple and declarative.

⭐ Main Features

• ⚙️ Full Platform Bootstrap - From infrastructure to observability, GitOps, and secrets
• 🧱 Modular by Design - Helm and Terraform based components, easily extendable
• 🔁 Multi-cluster Support - ControlPlane + N worker clusters, with app targeting
• 🚀 Fast Setup - Ready to go in under 30 minutes
• ☁️ Cloud & Edge Ready - Use it across cloud, hybrid, or bare-metal environments
• 🔐 Built-in Best Practices - Production-grade setup used by real-world platforms

🙋 Why use kubara?

Setting up a secure, multi-cluster Kubernetes platform is hard.

kubara simplifies this with a single Go binary that:

• Generates required configuration and secrets
• Templatizes and deploys pre-vetted infrastructure components
• Bootstraps your platform using Argo CD and GitOps
• Allows easy onboarding of new clusters and workloads

All based on real-world usage at Schwarz Group and the experience of multiple engineering teams - so you don't have to reinvent the wheel.

🛠️ How does it work?

kubara takes care of:

1. 📄 Initial configuration via .env and config.yaml
2. 🧩 Rendering and deploying Terraform and Helm modules
3. 🧪 Validating schemas and environment settings
4. 🚀 Bootstrapping the ControlPlane and Argo CD
5. 📦 Managing secrets (incl. External Secrets Operator)
6. 🧱 Adding additional worker clusters and workloads

🚀 Getting Started

Follow the Bootstrap Your Platform Guide to:

• Install the CLI
• Prepare your .env and config.yaml
• Run kubara init, kubara schema (optional) and kubara generate
• Bootstrap Argo CD with kubara bootstrap <cluster-name>

You're done 🎉

🛣️ Roadmap

We're continuously improving kubara. Upcoming features:

• Extend Pipelines
• Add flavors: security, high availability, etc.
• Support more cloud providers

🎥/📝/🎙️ Multimedia

• 🎙️ Kubernetes Platform Blueprint | Co-Located Workshop with vCluster at KubeCon, 2026
• 🎥 Free Course based on kubara, 2026 | Course at Platform Engineering University
• 🎙️ How to build a Multi-Tenancy Internal Developer Platform with GitOps and vCluster | Talk at ContainerDays Hamburg, 2025
• 🎥 How to build a multi-tenancy Internal Developer Platform with GitOps and vCluster | PlatformCon 2025 | Virtual Workshop
• 🎥 Load Testing Argo CD at Scale with vCluster and GitOps | vCluster Labs | Webinar
• 🎙️The GitOps Blueprint: Multi-Tenant Kubernetes with Argo CD in 30 Minutes | Cloud X Summit 2025 | Talk
• 📝 How We Load Test Argo CD at Scale: 1,000 vClusters with GitOps on Kubernetes | Medium and ITNEXT | Blog
• 📝 How to Build a Multi-Tenant Kubernetes Platform with GitOps and vCluster | Medium and ITNEXT | Blog

🤝 Contributing

We 💙 contributions! Here's how to get started:

1. Check the Issues
2. Open a new one if your problem isn't listed
3. Want to fix something yourself? Go ahead and open a PR!
4. Follow our Commit Message Conventions

We're happy to help and review 🙌

🏷️ Versioning

kubara follows Semantic Versioning in the style v0.1.0-something. Releases are listed in the Release section.

📝 License

Documentation is licensed under CC BY 4.0. Software source code is licensed under Apache 2.0.