podman-network-connect(1)

podman-network-connect1

Connect a container to a network

Usage

podman network connect [options] network container

Overview

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

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

Releases

4 releases since Debian 11 (Bullseye); the text changed 3 times.

  1. 11
  2. 12
  3. 13
  4. Arch

History

November 2020, Originally compiled by Brent Baude [email protected] ⟨mailto:[email protected]⟩

From podman 6.1.4-1 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.