kubara

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.

Why kubara

• 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

Installation

See INSTALLATION.md for Linux, macOS, and Windows installation instructions.

Documentation

• Public docs: https://docs.kubara.io
• Local docs sources: docs/

Catalogs

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.

CLI Commands

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

Global Options

--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

Update Check

• kubara checks for newer GitHub releases on each run; disable with KUBARA_UPDATE_CHECK=0; run kubara --check-update for a live check.

Community and Support

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

Contributing

Contributions are welcome. Please read CONTRIBUTING.md before opening a pull request.

License

kubara uses dual licensing:

• Software source code: Apache 2.0
• Documentation: CC BY 4.0
• Additional notices: NOTICE.md