podman-network-ls - Man Page

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

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

PlaceholderDescription
.IDNetwork ID
.NameNetwork name
.PluginsNetwork Plugins
.LabelsNetwork labels
.VersionCNI Version of the config file

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

Referenced By

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