NAME

podman-network-ls - Display a summary of CNI networks

SYNOPSIS

podman network ls [options]

DESCRIPTION

Displays a list of existing podman networks.

OPTIONS

--filter, -f

Filter output based on conditions given. Multiple filters can be given with multiple uses of the --filter option. Filters with the same key work inclusive with the only exception being label which is exclusive. Filters with different keys always work exclusive.

Valid filters are listed below:

Filter Description
name [Name] Network name (accepts regex)
id [ID] Full or partial network ID
label [Key] or [Key=Value] Label assigned to a network
plugin [Plugin] CNI plugins included in a network (e.g bridge,portmap,firewall,tuning,dnsname,macvlan)
driver [Driver] Only bridge is supported

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

Placeholder Description
.ID Network ID
.Name Network name
.Plugins Network Plugins
.Labels Network labels
.Version CNI Version of the config file

--noheading

Omit the table headings from the listing of networks.

--no-trunc

Do not truncate the network ID. The network ID is not displayed by default and must be specified with --format.

--quiet, -q

The quiet option will restrict the output to only the network names.

EXAMPLE

Display networks

# podman network ls
NAME      VERSION   PLUGINS
podman    0.3.0     bridge,portmap
podman2   0.3.0     bridge,portmap
outside   0.3.0     bridge
podman9   0.3.0     bridge,portmap

Display only network names

# podman network ls -q
podman
podman2
outside
podman9

Display name of network which support bridge plugin

# podman network ls --filter plugin=portmap --format {{.Name}}
podman
podman2
podman9

SEE ALSO

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

HISTORY

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