kubara is an opinionated CLI to bootstrap and operate Kubernetes platforms with a GitOps-first workflow. It combines platform scaffolding, environment configuration, and production-ready defaults in a single binary.
- One CLI for platform setup and lifecycle tasks
- GitOps-native structure for repeatable deployments
- Built for multi-cluster and multi-tenant environments
- Extensible with Terraform and Helm based components
See INSTALLATION.md for Linux, macOS, and Windows installation instructions.
- Public docs: https://docs.kubara.io
- Local docs sources:
docs/
kubara resolves its bootstrap foundation and default platform stack from OCI catalogs. Find the catalog source and versioned releases at kubara-io/catalogs and its releases. See Catalogs for per-cluster catalog configuration and custom catalogs.
init Initialize a new kubara directory
generate Generate Helm and Terraform artifacts from configured catalog templates.
bootstrap Bootstrap prerequisite CRDs and Argo CD onto the specified cluster
schema Generate JSON schema file for config structure
agents Scaffold an onboarding file for AI coding assistants (AGENTS.md)
catalog Manage platform catalogs
cluster Manage your kubara cluster configurations
help, h Shows a list of commands or help for one command
--kubeconfig string Path to kubeconfig file (default: "~/.kube/config")
--work-dir string, -w string Working directory (default: ".")
--config-file string, -c string Path to the configuration file (default: "config.yaml")
--env-file string Path to the .env file (default: ".env")
--test-connection Check if Kubernetes cluster can be reached. List namespaces and exit
--base64 Enable base64 encode/decode mode
--encode Base64 encode input
--decode Base64 decode input
--string string Input string for base64 operation
--file string Input file path for base64 operation
--check-update Check online for a newer kubara release
--help, -h show help
--version, -v print the version
- kubara checks for newer GitHub releases on each run; disable with
KUBARA_UPDATE_CHECK=0; runkubara --check-updatefor a live check.
Join the #kubara Slack channel to chat with other users of kubara or reach out to the maintainers directly. Use the public invite link (http://slack.k8s.io/) to get an invite for the official Kubernetes Slack space.
- Questions and bug reports: GitHub Issues
- Discussions and Q&A: GitHub Discussions
- Team and contributor guidance: CONTRIBUTING.md
- Code of conduct: CODE_OF_CONDUCT.md
Contributions are welcome. Please read CONTRIBUTING.md before opening a pull request.
kubara uses dual licensing:
- Software source code: Apache 2.0
- Documentation: CC BY 4.0
- Additional notices: NOTICE.md
