mirror of
https://github.com/containers/podman.git
synced 2025-06-22 18:08:11 +08:00
52a8694705
Change the docs markdown so that flag names will be h4 headers. Sphinx will automatically add anchors to headers. Add css to make sure the flag names are not to big compared to the text. The man pages also still renders fine but it looks a bit different. Signed-off-by: Paul Holzinger <paul.holzinger@web.de>
100 lines
2.9 KiB
Markdown
100 lines
2.9 KiB
Markdown
% podman-network-create(1)
|
|
|
|
## 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 *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.
|
|
|
|
## OPTIONS
|
|
#### **--disable-dns**
|
|
|
|
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.
|
|
|
|
#### **--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
|
|
|
|
#### **--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.
|
|
|
|
#### **--macvlan**
|
|
|
|
Create a *Macvlan* based connection rather than a classic bridge. You must pass an interface name from the host for the
|
|
Macvlan connection.
|
|
|
|
#### **--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 --macvlan 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>
|