Tuning PluginΒΆ

The tuning plugin can change some system controls (sysctls) and interface attributes. It must be used as a chained plugin in conjunction with another interface-creating plugin.

The following options are used to configure the plugin:

name (string, required)

The name of the network.

type (string, required)


mac (string, optional)

Set the MAC address of the interface.

mtu (integer, optional)

Set the MTU of the interface.

promisc (bool, optional)

Set the promiscuous mode of interface.

allmulti (bool, optional)

Set the all-multicast mode of interface. If enabled, all multicast packets on the network will be received by the interface.

sysctl (object, optional)

Change sysctls in the network namespace.


The following example creates a pod with an additional bridge interface which has its MTU, MAC, promiscuous mode, allmulti mode, and ipforwarding values changed by the tuning plugin. Note the chained nature of the plugins.

kind: NetworkAttachmentDefinitionapiVersion: "k8s.cni.cncf.io/v1"
  name: bridge1
  config: '{
      "cniVersion": "0.3.1",
      "name": "bridgenet",
      "plugins": [
              "type": "bridge",
              "bridge": "mybr0",
              "ipam": {
                  "type": "host-local",
                  "subnet": ""
              "name": "brtuning",
              "type": "tuning",
              "sysctl": {
                "net.ipv4.conf.net1.forwarding": "1"
              "mtu": 9000,
              "mac": "c2:b0:57:49:47:f1",
              "promisc": true,
              "allmulti": true
apiVersion: v1
kind: Pod
  name: bridgepod1
    k8s.v1.cni.cncf.io/networks: '[
            { "name": "bridge1" }
  - name: bridge1
    image: centos/tools
    imagePullPolicy: IfNotPresent
    command: [ "/bin/bash", "-c", "--" ]
    args: [ "while true; do sleep 300000; done;" ]