How to change kind-cluster IP network range in bootstrap VM
search cancel

How to change kind-cluster IP network range in bootstrap VM


Article ID: 345699


Updated On:




This KB provides how to change the docker default network after failing the bootstrap of TKG.

Docker's default network range is  

If the existing external network includes, the bootstrap VM can't forward the packet to external network  As a result, TKG bootstrap is failed.


VMware Tanzu Kubernetes Grid 1.x


Depending on the customer environment, Docker's default network range conflicts with the existing external network because is vast.


Change the default docker network configuration.
# SSH to bootstrap VM
ssh root@${BOOTSTRAP_VM}

# Stop all running docker containers
docker ps
docker stop $CONTAINER_ID

# Check current IP address list
ip a

# Delete target bridge which was generated by kind
ip link set dev br-xxxx down
ip link del dev br-xxxx

# Delete the target bridge which was generated by kind
docker network ls
docker network rm kind

# Set non conflict network range
cat > /etc/docker/daemon.json <<EOF

# Restart docker
systemctl restart docker
systemctl status docker

# Check IP address on docker0
ip a show dev docker0
#> inet brd scope global docker0

# Check: routing table
ip route

# Test (install "kind" in advance)
kind create cluster -n test

# Check new created bridge IP address
ip a show | grep br- | grep -B1 inet
#>13: br-d1811fcbec05: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 1500 qdisc noqueue state UP 
#>    inet brd scope global br-d1811fcbec05

Additional Information

TKG bootstrap process is failed.