Configuring MTU

Depending on the environment Calico is being deployed into it may be helpful or even necessary to configure the MTU of the veth (or TAP) that is attached to each workload and the tunnel devices if IP-in-IP is enabled.

Selecting MTU size

Typically the MTU for your workload interfaces should match the network MTU. If you need IP-in-IP then the MTU size for both the workload and tunnel interfaces should be 20 bytes less than the network MTU for your network. This is due to the extra 20 byte header that the tunnel will add to each packet.

Common MTU sizes

Network MTU Calico MTU Calico MTU with IP-in-IP Calico MTU with VXLAN (IPv4)
1500 1500 1480 1450
9000 9000 8980 8950
1460 (GCE) 1460 1440 1410
9001 (AWS Jumbo) 9001 8981 8951

Default MTU sizes

The default MTU for workload interfaces is 1500, this is to match the most common network MTU size. The default MTU for the IP-in-IP tunnel device is 1440 to match the value needed in GCE.

Setting MTU for workload network interfaces

It is the job of the network plugin to create new interfaces, the current major plugins are CNI and libnetwork. Currently Docker and the Mesos Docker Containerizer integration use libnetwork which does not support setting MTU. CNI which is used by Kubernetes and the Mesos Unified Containerizer support configuring the MTU through the CNI configuration file.

MTU configuration with CNI

To set the MTU when using CNI the line "mtu": <MTU size> must be added to the CNI configuration file.

Example CNI configuration

    "name": "any_name",
    "cniVersion": "0.1.0",
    "type": "calico",
    "mtu": 1480,
    "ipam": {
        "type": "calico-ipam"

Note: The MTU on existing workloads will not be updated with this change. To have all workloads use the new MTU then they must be restarted.

Setting MTU for tunnel network interfaces

If IP-in-IP is enabled and the MTU needs to be modifed then this must be configured by setting a Felix environment variable or using calicoctl to set the proper configuration variable. Felix will set the tunnel interfaces to the specified MTU.

Setting MTU through Felix Environment variable

Passing in the environment variable FELIX_IPINIPMTU when running the calico/node container will set the MTU for Felix to use.

Setting the MTU with calicoctl

To set the IP-in-IP MTU value for all calico nodes in your cluster, use the following command to set the global config value.

calicoctl config set --raw=felix IpInIpMtu 1480

Note: Setting the IpInIpMtu config option will result in an immediate update the tunnel interface MTU on all of the active nodes in your cluster.