Docker Desktop Guide
Run KubeBolt with Docker Desktop's built-in Kubernetes.
The Problem
Docker Desktop K8s uses 127.0.0.1:6443 as the API server address. This works from your host machine, but not from inside a container (which has its own localhost).
The Solution
Use the helper script to rewrite the kubeconfig to use kubernetes.docker.internal instead:
# 1. Enable Kubernetes in Docker Desktop → Settings → Kubernetes → Enable
# 2. Switch context
kubectl config use-context docker-desktop
# 3. Generate container-compatible kubeconfig
./deploy/docker-kubeconfig.sh
# 4. Start
cd deploy && docker compose up -dMetrics Server
Docker Desktop doesn’t include Metrics Server. Install it manually:
kubectl apply -f https://github.com/kubernetes-sigs/metrics-server/releases/latest/download/components.yaml