Skip to content

Commit fb2261a

Browse files
authored
docs: add kind note for podman and macos or windows users (guacsec#70)
Signed-off-by: Ruben Romero Montes <rromerom@redhat.com>
1 parent cc2530a commit fb2261a

File tree

1 file changed

+40
-0
lines changed

1 file changed

+40
-0
lines changed

README.md

Lines changed: 40 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -77,6 +77,46 @@ The rest works like the `minikube` approach. The `APP_DOMAIN` is different thoug
7777
APP_DOMAIN=.$(kubectl get node kind-control-plane -o jsonpath='{.status.addresses[?(@.type == "InternalIP")].address}' | awk '// { print $1 }').nip.io
7878
```
7979

80+
#### Important Note for Kind + Podman Users (macOS/Windows)
81+
82+
When using Kind with Podman (instead of Docker Desktop), the Kind cluster runs inside a VM managed by Podman. This creates a networking scenario where:
83+
84+
- **Pod's localhost** = the pod itself (not the VM, not the host)
85+
- **VM localhost** = the VM (not the host)
86+
- **Host localhost** = your actual machine
87+
88+
For proper networking, you need to use `APP_DOMAIN=.127.0.0.1.nip.io` and patch the CoreDNS configuration:
89+
90+
1. **Get the ingress controller ClusterIP:**
91+
```bash
92+
kubectl -n ingress-nginx get svc ingress-nginx-controller -o jsonpath='{.spec.clusterIP}'
93+
```
94+
95+
2. **Patch the CoreDNS configuration:**
96+
```bash
97+
kubectl -n kube-system get configmap coredns -o yaml > coredns-config.yaml
98+
```
99+
100+
Edit the `coredns-config.yaml` file and add the following to the `Corefile` section:
101+
```yaml
102+
hosts {
103+
10.96.75.197 sso.127.0.0.1.nip.io # Replace 10.96.75.197 with your actual ClusterIP
104+
fallthrough
105+
}
106+
```
107+
108+
Apply the updated configuration:
109+
```bash
110+
kubectl -n kube-system apply -f coredns-config.yaml
111+
```
112+
113+
3. **Restart CoreDNS:**
114+
```bash
115+
kubectl -n kube-system rollout restart deployment coredns
116+
```
117+
118+
This ensures that DNS resolution works correctly within the Kind cluster when using Podman.
119+
80120
### CRC
81121

82122
Create a new cluster:

0 commit comments

Comments
 (0)