Getting started with CloudGrange
CloudGrange is a local control plane that discovers your existing clusters and virtual machines and lets you manage workloads safely. It installs on-premises, on your own Kubernetes, and on Azure.
CloudGrange is in preview, not a GA or certified production release. Every install page downloads the latest release. See current product and release status.
Choose an installation path
CloudGrange runs on Kubernetes and is deployed by Helm, with one exception. Every path below except Container Apps ends at the same Helm chart, differing only in how much of the stack beneath it the installer builds for you. Container Apps has its own deployment schema and cannot run Kubernetes manifests at all, so there the same platform is described by a Bicep template instead.
| Path | When to use it | Guide |
|---|---|---|
| Helm | You already run Kubernetes — microk8s, RKE2, EKS, AKS, GKE. Installs the chart only. | Helm install |
| Native Linux | An existing Ubuntu/Debian server. Installs K3s on it, then the chart. | Native Linux install |
| Online | Windows + Hyper-V. Creates a Linux VM, installs K3s, deploys the chart. | Online install |
| Bundled | Windows + Hyper-V, fully offline from a transferred bundle. | Bundled install |
| Appliance | Windows + Hyper-V. Imports a VHDX with K3s, the chart and all images pre-baked. | Appliance install |
| Azure Container Apps | Azure owns the host, the runtime and the database. No VM, no Kubernetes, no Helm. | Container Apps install |
Where no cluster exists, the installers deploy K3s, a single-binary CNCF-conformant Kubernetes distribution. Online, Native Linux and Helm pull images from GHCR at install time; Appliance carries them for offline installation. (Bundled is offline and currently runs the legacy Compose engine — see its guide.)
Start with the on-premises installation overview, or select one of the guides above and follow its download, verification, installation, and first-run steps.
Then connect your hosts
After the control plane is up, connect the machines you want to manage:
- Install the Relay — one per site, routes jobs to your hosts.
- Install the Agent — a Windows service on each Hyper-V host.