podman-network-ls - Man Page

Display a summary of networks

Synopsis

podman network ls  [options]

Description

Displays a list of existing podman networks.

Options

--filter, -f=filter=value

Provide filter values.

The filters argument format is of key=value. If there is more than one filter, then pass multiple OPTIONS: --filter foo=bar --filter bif=baz.

Supported filters:

FilterDescription
driverFilter by driver type.
idFilter by full or partial network ID.
labelFilter by network with (or without, in the case of label!=[...] is used) the specified labels.
nameFilter by network name (accepts regex).
untilFilter by networks created before given timestamp.
danglingFilter by networks with no containers attached.

The driver filter accepts values: bridge, macvlan, ipvlan.

The label filter accepts two formats. One is the label=key or label=key=value, which shows images with the specified labels. The other format is the label!=key or label!=key=value, which shows images without the specified labels.

The until filter can be Unix timestamps, date formatted timestamps, or Go duration strings (e.g. 10m, 1h30m) computed relative to the machine’s time.

The dangling filter accepts values true or false.

--format=format

Change the default output format.  This can be of a supported type like 'json' or a Go template. Valid placeholders for the Go template are listed below:

PlaceholderDescription
.Created ...Timestamp when the network was created
.DNSEnabledNetwork has dns enabled (boolean)
.DriverNetwork driver
.IDNetwork ID
.InternalNetwork is internal (boolean)
.IPAMOptions ...Network ipam options
.IPv6EnabledNetwork has ipv6 subnet (boolean)
.LabelsNetwork labels
.NameNetwork name
.NetworkDNSServersArray of DNS servers used in this network
.NetworkInterfaceName of the network interface on the host
.Options ...Network options
.RoutesList of static routes for this network
.SubnetsList of subnets on this network

--no-trunc

Do not truncate the network ID.

--noheading, -n

Omit the table headings from the listing.

--quiet, -q

The quiet option restricts the output to only the network names.

Example

Display networks:

$ podman network ls
NETWORK ID    NAME         DRIVER
88a7120ee19d  podman       bridge
6dd508dbf8cd  podman6  bridge
8e35c2cd3bf6  podman5  macvlan

Display only network names:

$ podman network ls -q
podman
podman2
outside
podman9

Display name of network which support bridge plugin:

$ podman network ls --filter driver=bridge --format {{.Name}}
podman
podman2
podman9

List networks with their subnets:

$ podman network ls --format "{{.Name}}: {{range .Subnets}}{{.Subnet}} {{end}}"
podman: 10.88.0.0/16
podman3: 10.89.30.0/24 fde4:f86f:4aab:e68f::/64
macvlan:

See Also

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

History

August 2021, Updated with the new network format by Paul Holzinger pholzing@redhat.com ⟨mailto:pholzing@redhat.com⟩

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

Referenced By

podman-network(1), podman-network-create(1), podman-network-inspect(1), podman-network-update(1).

The man page docker-network-ls(1) is an alias of podman-network-ls(1).