Quickstart
A local setup guide for running k8s locally, and installing with helm
Requirements
- Docker installed (install Docker)
- Docker Compose installed (install Docker Compose)
- A terminal with network access
Setup
- Install Minikube
You can install Minikube by following the official instructions:
https://minikube.sigs.k8s.io/docs/start/
Or just run this if on linux:
curl -LO https://github.com/kubernetes/minikube/releases/latest/download/minikube-linux-amd64
sudo install minikube-linux-amd64 /usr/local/bin/minikube && rm minikube-linux-amd64
- Install Helm
Run:
curl https://raw.githubusercontent.com/helm/helm/main/scripts/get-helm-3 | bash
- Start Minikube
minikube start
This will create a local Kubernetes cluster.
Deploy CogStack with Helm
Run this command to install the MedCAT service Helm chart:
helm install my-medcat oci://registry-1.docker.io/cogstacksystems/medcat-service-helm --wait --timeout 10m0s
The --wait flag makes Helm wait until all resources are ready, and --timeout sets a maximum wait time.
Verify deployment
Check that the pods are running:
helm test medcat-service --logs
You’re now running CogStack locally on Kubernetes! For more detailed usage, see the Helm tutorial.