Bug: Olares install fails on macOS + Minikube because PatchOs expects Calico FelixConfiguration, but cluster uses kindnet

[YLDevs]

Environment

• Olares version: 1.12.5

• Host OS: macOS 26.2 (arm64)

• Minikube version: v1.38.1

• Driver: docker

• Container runtime: containerd

• Minikube start args:

  • --driver=docker
  • --container-runtime=containerd
  • --cpus=4
  • --memory=8192
  • --extra-config=apiserver.service-node-port-range=1-32767

What happened

The installation proceeds successfully through image preload and system deployment, but fails during PatchOs.

The installer runs:

kubectl patch felixconfiguration default -p '{"spec":{"featureDetectOverride":"SNATFullyRandom=false,MASQFullyRandom=false"}}' --type='merge'

Kubernetes returns:

error: the server doesn't have a resource type "felixconfiguration"

What I verified

kubectl api-resources | grep -i felix
# no output

kubectl get crd | grep -i felix
# no output

kubectl get pods -n kube-system
# shows kindnet, not calico

kubectl get ds -A
# no calico daemonsets

kube-system pods

coredns-...
etcd-olares-0
kindnet-...
kube-apiserver-olares-0
kube-controller-manager-olares-0
kube-proxy-...
kube-scheduler-olares-0
storage-provisioner

My understanding

It looks like the installer assumes Calico/Felix exists, but this Minikube environment uses kindnet, so PatchOs fails.

Expected behavior

The installer should either:

1. detect that FelixConfiguration/Calico is not available and skip this patch, or
2. ensure the required Calico resources are installed before patching.

Additional notes

I previously also had to work around:

• image preload/runtime mismatch by switching Minikube to containerd
• NodePort 445 issue by adding --extra-config=apiserver.service-node-port-range=1-32767

If needed, I can provide the full installation logs.

[HouShiqi]

I have the same issue.

[dkeven]

Hi @YLDevs @HouShiqi , could you share the full steps you take to install Olares on Mac? Normally users don't need to tweak anything with Minikube, the install script of Olares takes the whole process, from creating a Minikube cluster to install Calico CNI, and finally install the core Olares components. And there're certain presumptions about the Minikube cluster (e.g., the Calico CNI, the version and config of Containerd/K8s, etc.), so a self-provisioned Minikube cluster may not be eligible for installing Olares.

Also, we've previously tested on MacOs with the latest Minikube version, and we do not see this problem. A full installation log archive of the $HOME/.olares/logs directory will also be helpful.