
1. Run gitops-bootstrap-tui
2. Choose your k8s components from the templates
3. Let Flux deploy your choices to k8s for you!
Note: You can find your gitops repo at ~/my-gitops-repo folder locally and my-gitops-repo in the git server after you bootstrap it with the TUI
| Component | What it does | Access |
|---|---|---|
| soft-serve | Self-hosted git server (Docker) | ssh git@localhost — port 23231, also drops you into its TUI |
| my-gitops-repo | Your default repo, branch main | git@localhost:my-gitops-repo.git |
| gitops-bootstrap-tui | Scaffolds a GitOps repo from templates, inits git, bootstraps Flux | Run gitops-bootstrap-tui |
| k3s | The Kubernetes cluster Flux reconciles against | kubectl get nodes |
| Flux | Watches the repo over SSH and syncs cluster state to match | kubectl get gitrepository -n flux-system |
gitops-bootstrap-tui generates your repo from flux-templates, which lays things out like this:
.
├── bases/
│ ├── repositories/ # Centralized HelmRepository definitions
│ ├── infrastructure/ # Core platform controllers, networking, security
│ ├── databases/ # Data stores and caching solutions
│ └── apps/ # Example applications and workloads
└── clusters/
└── <your-cluster>/ # Generated, flat Kustomize build for your cluster
The TUI picks components out of bases/, resolves dependencies and conflicts via bases/rules.yaml (e.g. auto-selecting a DB's operator, blocking Grafana if Victoria Metrics is chosen instead), dedupes shared namespaces/HelmRepository defs, and writes the result into clusters/<your-cluster>/ as a flat, monolithic Kustomize build. Flux is then pointed at that path.
| Category | Options |
|---|---|
| Databases | ClickHouse, CockroachDB, Elasticsearch, Kafka, MongoDB, PostgreSQL, Redis |
| Networking | Cilium, Consul, Istio |
| Observability | Prometheus, Alertmanager, Grafana, Loki, Promtail, Mimir, Tempo, Jaeger, Victoria Metrics, Kube-Prometheus-Stack, ELK (Elasticsearch/Filebeat/Kibana/Logstash), OpenTelemetry Collector/OBI |
| Security | Cert-Manager, Vault, Tetragon |
| Storage | Rook-Ceph |
| Autoscaling | KEDA |
| UI & Dashboards | Backstage, Headlamp, KExp, Redpanda Console |
| Example apps | Grafana Quickpizza, OpenTelemetry Demo |
Ready? Run gitops-bootstrap-tui and dive in!