Installation
How to install Kuberise.io on your Kubernetes cluster.
Steps
1. Fork and Clone
Fork kuberise/kuberise.io to your GitHub account, then clone it:
git clone https://github.com/<your-username>/kuberise.io.git
cd kuberise.io
2. Run the Install Script
./scripts/install.sh [CONTEXT] [NAME] [REPO_URL] [REVISION] [DOMAIN] [TOKEN]
| Parameter | Description |
|---|---|
CONTEXT | Kubernetes context name (kubectl config current-context) |
NAME | Cluster name — must match a values-<NAME>.yaml file and a values/<NAME>/ folder |
REPO_URL | URL of your forked repository |
REVISION | Branch, tag, or commit SHA (e.g. main) |
DOMAIN | Base domain for services (e.g. onprem.kuberise.dev) |
TOKEN | Git token for private repos (optional) |
3. Example
./scripts/install.sh minikube onprem \
https://github.com/<your-username>/kuberise.io.git \
main onprem.kuberise.dev
The script will:
- Validate required CLI tools
- Create namespaces and secrets
- Install ArgoCD
- Create the root app-of-apps ArgoCD Application
Post-Installation
After installation, access dashboards via subdomains of your domain:
- ArgoCD:
https://argocd.<DOMAIN> - Grafana:
https://grafana.<DOMAIN>
The install script is idempotent — you can run it multiple times safely. Re-run it when you change ArgoCD Helm values or the install script itself.
Uninstall
./scripts/uninstall.sh <CONTEXT> <NAME>