1podman-network-ls(1) General Commands Manual podman-network-ls(1)
2
3
4
6 podman-network-ls - Display a summary of networks
7
8
10 podman network ls [options]
11
12
14 Displays a list of existing podman networks.
15
16
18 --filter, -f=filter=value
19 Provide filter values.
20
21
22 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
25
26 Supported filters:
27
28
29 ┌─────────┬────────────────────────────┐
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
52 The driver filter accepts values: bridge, macvlan, ipvlan.
53
54
55 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
60
61 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
65
66 The dangling filter accepts values true or false.
67
68
69 --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
74
75 ┌───────────────────┬───────────────────────────────┐
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
114 --no-trunc
115 Do not truncate the network ID.
116
117
118 --noheading, -n
119 Omit the table headings from the listing.
120
121
122 --quiet, -q
123 The quiet option restricts the output to only the network names.
124
125
127 Display networks
128
129
130 $ podman network ls
131 NETWORK ID NAME DRIVER
132 88a7120ee19d podman bridge
133 6dd508dbf8cd podman6 bridge
134 8e35c2cd3bf6 podman5 macvlan
135
136
137
138 Display only network names
139
140
141 $ podman network ls -q
142 podman
143 podman2
144 outside
145 podman9
146
147
148
149 Display name of network which support bridge plugin
150
151
152 $ podman network ls --filter driver=bridge --format {{.Name}}
153 podman
154 podman2
155 podman9
156
157
158
159 List networks with their subnets
160
161
162 $ podman network ls --format "{{.Name}}: {{range .Subnets}}{{.Subnet}} {{end}}"
163 podman: 10.88.0.0/16
164 podman3: 10.89.30.0/24 fde4:f86f:4aab:e68f::/64
165 macvlan:
166
167
168
170 podman(1), podman-network(1), podman-network-inspect(1), podman-net‐
171 work-create(1)
172
173
175 August 2021, Updated with the new network format by Paul Holzinger
176 pholzing@redhat.com ⟨mailto:pholzing@redhat.com⟩
177
178
179 August 2019, Originally compiled by Brent Baude bbaude@redhat.com
180 ⟨mailto:bbaude@redhat.com⟩
181
182
183
184 podman-network-ls(1)