Skip to main content
Version: 3.28 (latest)

Use a specific MAC address for a pod

Big picture

Choose the MAC address for a pod instead of allowing the operating system to assign one.


Some applications bind software licenses to networking interface MAC addresses.


Container MAC address

The MAC address configured by the annotation described here will be visible from within the container on the eth0 interface. Since it is isolated to the container it will not collide with any other MAC addresses assigned to other pods on the same node.

Before you begin...

Your cluster must be using Calico CNI to use this feature.

Configuring the Calico CNI Plugins

How to

Annotate the pod with set to the desired MAC address. For example:

  "": "1c:0c:0a:c0:ff:ee"

The annotation must be present when the pod is created; adding it later has no effect.