1podman-network-ls(1) General Commands Manual podman-network-ls(1)
2
6 podman-network-ls - Display a summary of networks
7
10 podman network ls [options]
11
14 Displays a list of existing podman networks.
15
18 --filter, -f=filter=value
19 Provide filter values.
20 The filters argument format is of key=value. If there is more than one
23 filter, then pass multiple OPTIONS: --filter foo=bar --filter bif=baz.
24 Supported filters:
27 ┌─────────┬────────────────────────────┐
30 │Filter │ Description │
31 ├─────────┼────────────────────────────┤
32 │driver │ Filter by driver type. │
33 ├─────────┼────────────────────────────┤
34 │id │ Filter by full or partial │
35 │ │ network ID. │
36 ├─────────┼────────────────────────────┤
37 │label │ Filter by network with (or │
38 │ │ without, in the case of │
39 │ │ label!=[...] is used) the │
40 │ │ specified labels. │
41 ├─────────┼────────────────────────────┤
42 │name │ Filter by network name │
43 │ │ (accepts regex). │
44 ├─────────┼────────────────────────────┤
45 │until │ Filter by networks created │
46 │ │ before given timestamp. │
47 ├─────────┼────────────────────────────┤
48 │dangling │ Filter by networks with no │
49 │ │ containers attached. │
50 └─────────┴────────────────────────────┘
51 The driver filter accepts values: bridge, macvlan, ipvlan.
53 The label filter accepts two formats. One is the label=key or la‐
56 bel=key=value, which shows images with the specified labels. The other
57 format is the label!=key or label!=key=value, which shows images with‐
58 out the specified labels.
59 The until filter can be Unix timestamps, date formatted timestamps, or
62 Go duration strings (e.g. 10m, 1h30m) computed relative to the ma‐
63 chine’s time.
64 The dangling filter accepts values true or false.
67 --format=format
70 Change the default output format. This can be of a supported type like
71 'json' or a Go template. Valid placeholders for the Go template are
72 listed below:
73 ┌───────────────────┬───────────────────────────────┐
76 │Placeholder │ Description │
77 ├───────────────────┼───────────────────────────────┤
78 │.Created │ Timestamp when the network │
79 │ │ was created │
80 ├───────────────────┼───────────────────────────────┤
81 │.DNSEnabled │ Network has dns enabled │
82 │ │ (boolean) │
83 ├───────────────────┼───────────────────────────────┤
84 │.Driver │ Network driver │
85 ├───────────────────┼───────────────────────────────┤
86 │.ID │ Network ID │
87 ├───────────────────┼───────────────────────────────┤
88 │.Internal │ Network is internal (boolean) │
89 ├───────────────────┼───────────────────────────────┤
90 │.IPAMOptions │ Network ipam options │
91 ├───────────────────┼───────────────────────────────┤
92 │.IPv6Enabled │ Network has ipv6 subnet │
93 │ │ (boolean) │
94 ├───────────────────┼───────────────────────────────┤
95 │.Labels │ Network labels │
96 ├───────────────────┼───────────────────────────────┤
97 │.Name │ Network name │
98 ├───────────────────┼───────────────────────────────┤
99 │.NetworkDNSServers │ Array of DNS servers used in │
100 │ │ this network │
101 ├───────────────────┼───────────────────────────────┤
102 │.NetworkInterface │ Name of the network interface │
103 │ │ on the host │
104 ├───────────────────┼───────────────────────────────┤
105 │.Options │ Network options │
106 ├───────────────────┼───────────────────────────────┤
107 │.Routes │ List of static routes for │
108 │ │ this network │
109 ├───────────────────┼───────────────────────────────┤
110 │.Subnets │ List of subnets on this net‐ │
111 │ │ work │
112 └───────────────────┴───────────────────────────────┘
113 --no-trunc
115 Do not truncate the network ID.
116 --noheading, -n
119 Omit the table headings from the listing.
120 --quiet, -q
123 The quiet option restricts the output to only the network names.
124
127 Display networks
128 $ podman network ls
130 NETWORK ID NAME DRIVER
131 88a7120ee19d podman bridge
132 6dd508dbf8cd podman6 bridge
133 8e35c2cd3bf6 podman5 macvlan
134 Display only network names
138 $ podman network ls -q
140 podman
141 podman2
142 outside
143 podman9
144 Display name of network which support bridge plugin
148 $ podman network ls --filter driver=bridge --format {{.Name}}
150 podman
151 podman2
152 podman9
153 List networks with their subnets
157 $ podman network ls --format "{{.Name}}: {{range .Subnets}}{{.Subnet}} {{end}}"
159 podman: 10.88.0.0/16
160 podman3: 10.89.30.0/24 fde4:f86f:4aab:e68f::/64
161 macvlan:
162
166 podman(1), podman-network(1), podman-network-inspect(1), podman-net‐
167 work-create(1)
168
171 August 2021, Updated with the new network format by Paul Holzinger
172 pholzing@redhat.com ⟨mailto:pholzing@redhat.com⟩
173 August 2019, Originally compiled by Brent Baude bbaude@redhat.com
176 ⟨mailto:bbaude@redhat.com⟩
177 podman-network-ls(1)