Under Construction
This documentation is a work in progress. Visit regularly to see the improvements we're making.
Install MDAI
Prerequisites
- Install Docker.
- Install Kubernetes (k8s).
- Install kubectl and kind.
- Install Helm.
- (Optional) Install k9s.
Other Tools and Infrastructure Used in Installation
Bring Up the MDAI Cluster
Make sure Docker is running.
Use kind to create a new cluster.
kind create cluster --name mdai
Use kubectl to install cert-manager. Wait a few moments for cert-manager to finish installing.
kubectl apply -f https://github.com/cert-manager/cert-manager/releases/download/v1.17.0/cert-manager.yaml
Install
mdai
helm repo and ensure it’s up to date.helm repo add mdai https://decisiveai.github.io/mdai-helm-charts
Update the repo.
helm repo update
Create the mdai namespace.
helm upgrade --install --create-namespace --namespace mdai --cleanup-on-fail --wait-for-jobs mdai mdai/mdai-hub --devel
Note
If running this command returns an error telling you to run
helm repo update
, then try again.Verify that the cluster’s pods are running.
kubectl get pods -n mdai
If the cluster is running, you’ll see output similar to the following.
NAME READY STATUS RESTARTS AGE
alertmanager-kube-prometheus-stack-alertmanager-0 2/2 Running 0 50s
event-handler-webservice-57d9d88c5f-r6kgf 1/1 Running 0 59s
kube-prometheus-stack-operator-6cfdc788d4-pgrx2 1/1 Running 0 59s
mdai-grafana-68d9c9474c-gh6ff 3/3 Running 0 59s
mdai-kube-state-metrics-6cd9fd8458-cn9bq 1/1 Running 0 59s
mdai-operator-controller-manager-66f9696ff7-7s9j6 1/1 Running 0 59s
mdai-prometheus-node-exporter-6wvll 1/1 Running 0 59s
mdai-valkey-primary-0 1/1 Running 0 59s
opentelemetry-operator-6d8ddbdc4d-pcwrb 1/1 Running 0 59s
prometheus-kube-prometheus-stack-prometheus-0 2/2 Running 0 50s
Set Up the MDAI Hub
From the MDAI Example Config repo, copy the
mdaihub_config.yaml
file into your working directory.Apply the configuration to the hub resource.
kubectl apply -f mdaihub_config.yaml
Verify the hub is applied by running
kubectl get customresourcedefinitions mdaihubs.hub.mydecisive.ai
Your output should be similar to the following.
NAME CREATED AT
mdaihubs.hub.mydecisive.ai 2025-03-24T20:02:19Z
Success
You’re ready to start using mdai.