--disable-dns¶

Disables the DNS plugin for this network which if enabled, can perform container to container name resolution.

--driver, -d¶

Driver to manage the network. Currently bridge, macvlan and ipvlan are supported. Defaults to bridge. As rootless the macvlan and ipvlan driver have no access to the host network interfaces because rootless networking requires a separate network namespace.

Special considerations for the netavark backend: - The macvlan driver requires the --subnet option, DHCP is currently not supported. - The ipvlan driver is not currently supported.

--gateway¶

Define a gateway for the subnet. If you want to provide a gateway address, you must also provide a subnet option. Can be specified multiple times. The argument order of the --subnet, --gateway and --ip-range options must match.

--internal¶

Restrict external access of this network. Note when using this option, the dnsname plugin will be automatically disabled.

--ip-range¶

Allocate container IP from a range. The range must be a complete subnet and in CIDR notation. The ip-range option must be used with a subnet option. Can be specified multiple times. The argument order of the --subnet, --gateway and --ip-range options must match.

--ipam-driver=driver¶

Set the ipam driver (IP Address Management Driver) for the network. When unset podman will choose an ipam driver automatically based on the network driver. Valid values are:
- host-local: IP addresses are assigned locally.
- dhcp: IP addresses are assigned from a dhcp server on your network. This driver is not yet supported with netavark. For CNI the dhcp plugin needs to be activated before.
- none: No ip addresses are assigned to the interfaces.

You can see the driver in the podman network inspect output under the ipam_options field.

--ipv6¶

Enable IPv6 (Dual Stack) networking. If not subnets are given it will allocate a ipv4 and ipv6 subnet.

--label¶

Set metadata for a network (e.g., --label mykey=value).

--opt, -o=option¶

Set driver specific options.

All drivers accept the mtu option. The mtu option sets the Maximum Transmission Unit (MTU) and takes an integer value.

Additionally the bridge driver supports the following options: - vlan: This option assign VLAN tag and enables vlan_filtering. Defaults to none. - isolate: This option isolates networks by blocking traffic between those that have this option enabled.

The macvlan and ipvlan driver support the following options: - parent: The host device which should be used for the macvlan interface. Defaults to the default route interface. - mode: This option sets the specified ip/macvlan mode on the interface.
- Supported values for macvlan are bridge, private, vepa, passthru. Defaults to bridge.
- Supported values for ipvlan are l2, l3, l3s. Defaults to l2.

--subnet¶

The subnet in CIDR notation. Can be specified multiple times to allocate more than one subnet for this network. The argument order of the --subnet, --gateway and --ip-range options must match. This is useful to set a static ipv4 and ipv6 subnet.