Branch: master
Find file History
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information. fix the typo, we use the passthru in the macvlan.go Oct 17, 2018
macvlan.go plugins/* stub-out GET functions so plugins build with v0.7 Jun 15, 2018

macvlan plugin


macvlan functions like a switch that is already connected to the host interface. A host interface gets "enslaved" with the virtual interfaces sharing the physical device but having distinct MAC addresses. Since each macvlan interface has its own MAC address, it makes it easy to use with existing DHCP servers already present on the network.

Example configuration

	"name": "mynet",
	"type": "macvlan",
	"master": "eth0",
	"ipam": {
		"type": "dhcp"

Network configuration reference

  • name (string, required): the name of the network
  • type (string, required): "macvlan"
  • master (string, required): name of the host interface to enslave
  • mode (string, optional): one of "bridge", "private", "vepa", "passthru". Defaults to "bridge".
  • mtu (integer, optional): explicitly set MTU to the specified value. Defaults to the value chosen by the kernel.
  • ipam (dictionary, required): IPAM configuration to be used for this network.


  • If are testing on a laptop, please remember that most wireless cards do not support being enslaved by macvlan.
  • A single master interface can not be enslaved by both macvlan and ipvlan.