mirror of https://github.com/containers/podman.git
51 lines
1.7 KiB
Markdown
51 lines
1.7 KiB
Markdown
% podman-network-connect 1
|
|
|
|
## NAME
|
|
podman\-network\-connect - Connect a container to a network
|
|
|
|
## SYNOPSIS
|
|
**podman network connect** [*options*] network container
|
|
|
|
## DESCRIPTION
|
|
Connects a container to a network. A container can be connected to a network by name or by ID.
|
|
Once connected, the container can communicate with other containers in the same network.
|
|
|
|
## OPTIONS
|
|
#### **--alias**=*name*
|
|
Add network-scoped alias for the container. If the network has DNS enabled (`podman network inspect -f {{.DNSEnabled}} <NAME>`),
|
|
these aliases can be used for name resolution on the given network. Multiple *--alias* options may be specified as input.
|
|
NOTE: When using CNI, a container only has access to aliases on the first network that it joins. This limitation does
|
|
not exist with netavark/aardvark-dns.
|
|
|
|
#### **--ip**=*address*
|
|
Set a static ipv4 address for this container on this network.
|
|
|
|
#### **--ip6**=*address*
|
|
Set a static ipv6 address for this container on this network.
|
|
|
|
#### **--mac-address**=*address*
|
|
Set a static mac address for this container on this network.
|
|
|
|
## EXAMPLE
|
|
|
|
Connect a container named *web* to a network named *test*
|
|
```
|
|
podman network connect test web
|
|
```
|
|
|
|
Connect a container name *web* to a network named *test* with two aliases: web1 and web2
|
|
```
|
|
podman network connect --alias web1 --alias web2 test web
|
|
```
|
|
|
|
Connect a container name *web* to a network named *test* with a static ip.
|
|
```
|
|
podman network connect --ip 10.89.1.13 test web
|
|
```
|
|
|
|
## SEE ALSO
|
|
**[podman(1)](podman.1.md)**, **[podman-network(1)](podman-network.1.md)**, **[podman-network-inspect(1)](podman-network-inspect.1.md)**, **[podman-network-disconnect(1)](podman-network-disconnect.1.md)**
|
|
|
|
## HISTORY
|
|
November 2020, Originally compiled by Brent Baude <bbaude@redhat.com>
|