Skip to main content
Version: 3.28 (latest)

Create multiple IP pools

Understanding multiple IP pools

By default when you install Calico, a single IPv4 pool is created. This IP pool is used for allocating IP addresses to pods and, if needed, tunnels within your cluster.

Sometimes you may want to configure additional IP pools. For example:

Create multiple IP pools when installing Calico

You can edit the Installation resource within custom-resources.yaml to include multiple unique IP pools. The following example creates two IP pools assigned to different sets of nodes.

apiVersion: operator.tigera.io/v1
kind: Installation
metadata:
name: default
spec:
ipPools:
- name: pool-zone-1
cidr: 192.168.0.0/24
encapsulation: VXLAN
nodeSelector: "zone == 'zone-1'"
- name: pool-zone-2
cidr: 192.168.1.0/24
encapsulation: VXLAN
nodeSelector: "zone == 'zone-2'"

After installing Calico, you can confirm the IP pools were created by using the following command:

kubectl get ippools

Prevent the operator from managing IP pools

In some cases, you may want to disable IP pool management within the operator and instead use calicoctl or kubectl to create and delete IP pools. To do this, you can edit the Installation resource with custom-resources.yaml to specify an empty list of IP pools.

apiVersion: operator.tigera.io/v1
kind: Installation
metadata:
name: default
spec:
ipPools: []

With this configuration, the operator will wait for you to create IP pools before installing Calico components.