NAME

       podman-network-create - Create a Podman CNI network

SYNOPSIS

       podman network create  [options] name

DESCRIPTION

       Create  a  CNI-network configuration for use with Podman. By default, Podman creates a bridge connection.
       A Macvlan connection can be created with the -d macvlan option.  A  parent  device  for  macvlan  can  be
       designated  with  the  -o parent=<device> 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.

OPTIONS

   --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 and macvlan is supported. Defaults to bridge.  As rootless
       the macvlan driver has no access to the host network interfaces because rootless  networking  requires  a
       separate network namespace.

   --opt=option, -o
       Set driver specific options.

       For the bridge driver the following options are supported: mtu and vlan.  The mtu option sets the Maximum
       Transmission  Unit  (MTU)  and  takes  an  integer  value.   The  vlan option assign VLAN tag and enables
       vlan_filtering. Defaults to none.

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

   --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.

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

   --subnet
       The subnet in CIDR notation.

   --ipv6
       Enable IPv6 (Dual Stack) networking. You must pass a IPv6 subnet. The subnet option must be used with the
       ipv6 option.

EXAMPLE

       Create a network with no options

              # podman network create
              /etc/cni/net.d/cni-podman-4.conflist

       Create a network named newnet that uses 192.5.0.0/16 for its subnet.

              # podman network create --subnet 192.5.0.0/16 newnet
              /etc/cni/net.d/newnet.conflist

       Create an IPv6 network named newnetv6, you must specify  the  subnet  for  this  network,  otherwise  the
       command will fail.  For this example, we use 2001:db8::/64 for its subnet.

              # podman network create --subnet 2001:db8::/64 --ipv6 newnetv6
              /etc/cni/net.d/newnetv6.conflist

       Create a network named newnet that uses 192.168.33.0/24 and defines a gateway as 192.168.133.3

              # podman network create --subnet 192.168.33.0/24 --gateway 192.168.33.3 newnet
              /etc/cni/net.d/newnet.conflist

       Create  a  network  that uses a *192.168.55.0/24** subnet and has an IP address range of 192.168.55.129 -
       192.168.55.254.

              # podman network create --subnet 192.168.55.0/24 --ip-range 192.168.55.128/25
              /etc/cni/net.d/cni-podman-5.conflist

       Create a Macvlan based network using the host interface eth0

              # podman network create -d macvlan -o parent=eth0 newnet
              /etc/cni/net.d/newnet.conflist

SEE ALSO

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

HISTORY

       August 2019, Originally compiled by Brent Baude bbaude@redhat.com ⟨mailto:bbaude@redhat.com⟩

                                                                                      podman-network-create(1)()