plucky (1) podman-network-ls.1.gz
NAME
podman-network-ls - 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:
┌─────────┬───────────────────────────────────────┐
│Filter │ Description │
├─────────┼───────────────────────────────────────┤
│driver │ Filter by driver type. │
├─────────┼───────────────────────────────────────┤
│id │ Filter by full or partial network ID. │
├─────────┼───────────────────────────────────────┤
│label │ Filter by network with (or without, │
│ │ in the case of label!=[...] is used) │
│ │ the specified labels. │
├─────────┼───────────────────────────────────────┤
│name │ Filter by network name (accepts │
│ │ regex). │
├─────────┼───────────────────────────────────────┤
│until │ Filter by networks created before │
│ │ given timestamp. │
├─────────┼───────────────────────────────────────┤
│dangling │ Filter 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:
┌───────────────────┬───────────────────────────────────────┐
│Placeholder │ Description │
├───────────────────┼───────────────────────────────────────┤
│.Created ... │ Timestamp when the network was │
│ │ created │
├───────────────────┼───────────────────────────────────────┤
│.DNSEnabled │ Network has dns enabled (boolean) │
├───────────────────┼───────────────────────────────────────┤
│.Driver │ Network driver │
├───────────────────┼───────────────────────────────────────┤
│.ID │ Network ID │
├───────────────────┼───────────────────────────────────────┤
│.Internal │ Network is internal (boolean) │
├───────────────────┼───────────────────────────────────────┤
│.IPAMOptions ... │ Network ipam options │
├───────────────────┼───────────────────────────────────────┤
│.IPv6Enabled │ Network has ipv6 subnet (boolean) │
├───────────────────┼───────────────────────────────────────┤
│.Labels │ Network labels │
├───────────────────┼───────────────────────────────────────┤
│.Name │ Network name │
├───────────────────┼───────────────────────────────────────┤
│.NetworkDNSServers │ Array of DNS servers used in this │
│ │ network │
├───────────────────┼───────────────────────────────────────┤
│.NetworkInterface │ Name of the network interface on the │
│ │ host │
├───────────────────┼───────────────────────────────────────┤
│.Options ... │ Network options │
├───────────────────┼───────────────────────────────────────┤
│.Routes │ List of static routes for this │
│ │ network │
├───────────────────┼───────────────────────────────────────┤
│.Subnets │ List 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⟩ podman-network-ls(1)