mirror of
https://github.com/podman-container-tools/podman.git
synced 2026-08-18 22:37:52 +00:00
2aa54ee55f
Clarify that auto-generated names may use underscores, that DNS-enabled networks resolve container names as given, and that container_name_as_hostname changes the UTS hostname only. Fixes: https://github.com/containers/podman/issues/28754 Signed-off-by: Jan Rodák <hony.com@seznam.cz>
53 lines
1.8 KiB
Markdown
53 lines
1.8 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 in addition to the container name. Multiple *--alias* options may be specified as input. See **DNS NOTES** in **[podman-network(1)](podman-network.1.md)**.
|
|
|
|
#### **--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.
|
|
|
|
## EXAMPLES
|
|
|
|
Connect specified container to a named network:
|
|
```
|
|
podman network connect test web
|
|
```
|
|
|
|
Connect specified container to named network with two aliases:
|
|
```
|
|
podman network connect --alias web1 --alias web2 test web
|
|
```
|
|
|
|
Connect specified container to named network with a static ip:
|
|
```
|
|
podman network connect --ip 10.89.1.13 test web
|
|
```
|
|
|
|
Connect specified container to named network with a static mac address:
|
|
```
|
|
podman network connect --mac-address 92:d0:c6:0a:29:33 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>
|