% podman-network-create(1)


podman-network-create - Create a Podman CNI network


podman network create [options] name


Create a CNI-network configuration for use with Podman. By default, Podman creates a bridge connection. A Macvlan connection can be created with the macvlan option. In the case of Macvlan connections, the CNI dhcp plugin needs to be activated or the container image must have a DHCP client to interact with the host network’s DHCP server.

If no options are provided, Podman will assign a free subnet and name for your network.

Upon completion of creating the network, Podman will display the path to the newly added network file.



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

-d, –driver

Driver to manage the network (default “bridge”). Currently only bridge is supported.


Define a gateway for the subnet. If you want to provide a gateway address, you must also provide a subnet option.


Restrict external access of this network


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.


Create a Macvlan based connection rather than a classic bridge. You must pass an interface name from the host for the Macvlan connection.


The subnet in CIDR notation.


Create a network with no options

# podman network create

Create a network named newnet that uses for its subnet.

# podman network create --subnet newnet

Create a network named newnet that uses and defines a gateway as

# podman network create --subnet --gateway newnet

Create a network that uses a* subnet and has an IP address range of -

# podman network create --subnet --ip-range

Create a Macvlan based network using the host interface eth0

# podman network create --macvlan eth0 newnet


podman(1), podman-network(1), podman-network-inspect(1)


August 2019, Originally compiled by Brent Baude bbaude@redhat.com