|
| 1 | +--- |
| 2 | +title: "Guided Open Cluster Management Install with KubeStellar Console" |
| 3 | +date: 2026-03-18 |
| 4 | +authors: |
| 5 | + - Andy Anderson |
| 6 | +toc_hide: true |
| 7 | +--- |
| 8 | + |
| 9 | +Installing Open Cluster Management (OCM) involves multiple steps — adding Helm repos, installing the control plane, registering managed clusters, and verifying everything works. [KubeStellar Console](https://console.kubestellar.io?utm_source=ocm-blog&utm_medium=blog&utm_campaign=cncf_outreach&utm_term=open-cluster-management) now includes a guided install mission that walks you through the entire process step-by-step, with built-in validation and troubleshooting. |
| 10 | + |
| 11 | +## What is KubeStellar Console? |
| 12 | + |
| 13 | +KubeStellar Console is a standalone, open-source Kubernetes dashboard with 30+ dashboards and 150+ monitoring cards. It connects to your clusters via kubeconfig and includes an AI-powered mission system that provides guided workflows for installing and managing CNCF projects. |
| 14 | + |
| 15 | +> **Note:** KubeStellar Console is unrelated to the KubeStellar multi-cluster orchestration project — they share a name but have zero shared code. |
| 16 | +
|
| 17 | +## The OCM Install Mission |
| 18 | + |
| 19 | +The [OCM install mission](https://console.kubestellar.io/missions/install-open-cluster-management?utm_source=ocm-blog&utm_medium=blog&utm_campaign=cncf_outreach&utm_term=open-cluster-management) runs against your live cluster. Each step includes: |
| 20 | + |
| 21 | +- **Pre-flight checks** — verifies prerequisites (Kubernetes >=1.24, Helm, kubectl) |
| 22 | +- **Exact commands** — shows the `helm install` and `kubectl apply` commands with flags explained. Copy-paste or run directly from the console |
| 23 | +- **Validation** — after each step, queries your cluster to verify success (pod phase, CRD registration, service endpoints) |
| 24 | +- **Troubleshooting** — on failure, reads pod logs, events, and resource status and suggests fixes |
| 25 | +- **Rollback** — each step includes the corresponding `helm uninstall` / `kubectl delete` to undo |
| 26 | + |
| 27 | +It also works as read-only documentation — no cluster connection required to browse the steps. |
| 28 | + |
| 29 | +## Try It |
| 30 | + |
| 31 | +### Option 1: Browse Online |
| 32 | + |
| 33 | +Open the mission directly at: |
| 34 | + |
| 35 | +**[console.kubestellar.io/missions/install-open-cluster-management](https://console.kubestellar.io/missions/install-open-cluster-management?utm_source=ocm-blog&utm_medium=blog&utm_campaign=cncf_outreach&utm_term=open-cluster-management)** |
| 36 | + |
| 37 | +### Option 2: Run Locally |
| 38 | + |
| 39 | +Install KubeStellar Console locally (connects to your current kubeconfig context): |
| 40 | + |
| 41 | +```bash |
| 42 | +curl -sSL https://raw.githubusercontent.com/kubestellar/console/main/start.sh | bash |
| 43 | +``` |
| 44 | + |
| 45 | +Then navigate to the OCM install mission from the Missions page. |
| 46 | + |
| 47 | +## Contributing |
| 48 | + |
| 49 | +The mission definition is open source at [console-kb](https://github.com/kubestellar/console-kb/blob/master/solutions/cncf-install/install-open-cluster-management.json). PRs to improve the OCM install steps are welcome. |
| 50 | + |
| 51 | +KubeStellar Console currently has 180+ install missions covering CNCF projects across the landscape. If you'd like to see missions for other OCM-related projects or have suggestions for improving the OCM mission, open an issue on [kubestellar/console-kb](https://github.com/kubestellar/console-kb/issues). |
0 commit comments