K3Nova

K3Nova: Simple Entry into Kubernetes with K3s and K3Nova
Kubernetes is the foundation of modern cloud infrastructures, but getting started can quickly become complicated: countless YAML files, complex CLI commands, and steep learning curves. This is where K3Nova comes in – a lightweight CLI tool that helps you quickly and conveniently build production-ready K3s clusters without needing to dive deeply into every single component.
Note: K3Nova is fully functional and production-ready. However, it is still under active development, which means you might occasionally encounter minor bugs or unfinished features. Feedback, ideas, and contributions are highly appreciated!
Join the discussion here: K3Nova Discussions
Why K3Nova?
K3Nova was developed with three main goals:
- Quick Start → Fully automated setup of a Kubernetes cluster.
- Learning-Oriented → Understand how control planes, worker nodes, ingress, and monitoring interact.
- Production-Ready → Perfect for development, testing, and small production environments.
K3s as the Foundation
K3Nova uses K3s, a CNCF-certified lightweight Kubernetes distribution developed by Rancher. It combines all essential components into a single binary, includes containerd, Flannel, CoreDNS, and Traefik out of the box, and is therefore ideal for resource-efficient environments.
How K3Nova Works
1. Installation
- Download the K3Nova binary, make it executable, and start K3Nova.
- Use the interactive menus to go through the cluster setup step by step.
- You can find an example configuration in
config/k3nova-config.json.tpl
.
2. Cluster Setup
- Manual: K3Nova can assist you with classic K3s setups by providing installation commands and prepared configuration templates.
- Automated: With just a few inputs, K3Nova handles the entire process:
- Installation of control planes and worker nodes
- Configuration of Traefik with HTTP, TCP, and UDP
- Integration of additional modules like monitoring, NFS, or a Docker registry
3. High-Availability Clusters
For production environments, K3Nova also supports HA setups with multiple control plane nodes. It sets up etcd, replicates configurations, and ensures a stable and fault-tolerant cluster operation.
Summary
Feature | Description |
---|---|
⚡ Automation | Complete setup of K3s clusters in just a few steps — including control planes, workers, storage, and monitoring. |
🧩 Extensibility | Optional features like monitoring, private Docker registry, NFS storage, Redis integration, and TLS certificates. |
🛡️ HA Support | Automatic deployment of highly available control planes with built-in load balancing and failover. |
🌐 Advanced Traefik | Native support for Traefik CRDs, IngressRoutes, IngressRouteTCP, and custom EntryPoints with Let’s Encrypt. |
📊 Observability | Integrated Prometheus and Grafana dashboards for monitoring cluster and application metrics. |
🎓 Learning Factor | Guided setup process helps you understand Kubernetes components while deploying a real cluster. |
Conclusion
With K3Nova, getting started with Kubernetes becomes easier, faster, and more transparent. Whether you’re developing locally, running production-like tests, or building a high-availability infrastructure, K3Nova takes care of the complex steps while still giving you a deep understanding of how Kubernetes works.