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 │.ID │ Network ID │
79 ├──────────────────┼───────────────────────────────┤
80 │.Name │ Network name │
81 ├──────────────────┼───────────────────────────────┤
82 │.Driver │ Network driver │
83 ├──────────────────┼───────────────────────────────┤
84 │.Labels │ Network labels │
85 ├──────────────────┼───────────────────────────────┤
86 │.Options │ Network options │
87 ├──────────────────┼───────────────────────────────┤
88 │.IPAMOptions │ Network ipam options │
89 ├──────────────────┼───────────────────────────────┤
90 │.Created │ Timestamp when the network │
91 │ │ was created │
92 ├──────────────────┼───────────────────────────────┤
93 │.Internal │ Network is internal (boolean) │
94 ├──────────────────┼───────────────────────────────┤
95 │.IPv6Enabled │ Network has ipv6 subnet │
96 │ │ (boolean) │
97 ├──────────────────┼───────────────────────────────┤
98 │.DNSEnabled │ Network has dns enabled │
99 │ │ (boolean) │
100 ├──────────────────┼───────────────────────────────┤
101 │.NetworkInterface │ Name of the network interface │
102 │ │ on the host │
103 ├──────────────────┼───────────────────────────────┤
104 │.Subnets │ List of subnets on this net‐ │
105 │ │ work │
106 └──────────────────┴───────────────────────────────┘
107
108 --no-trunc
109 Do not truncate the network ID.
110
111
112 --noheading
113 Omit the table headings from the listing of networks.
114
115
116 --quiet, -q
117 The quiet option will restrict the output to only the network names.
118
119
121 Display networks
122
123
124 $ podman network ls
125 NETWORK ID NAME DRIVER
126 88a7120ee19d podman bridge
127 6dd508dbf8cd podman6 bridge
128 8e35c2cd3bf6 podman5 macvlan
129
130
131
132 Display only network names
133
134
135 $ podman network ls -q
136 podman
137 podman2
138 outside
139 podman9
140
141
142
143 Display name of network which support bridge plugin
144
145
146 $ podman network ls --filter driver=bridge --format {{.Name}}
147 podman
148 podman2
149 podman9
150
151
152
153 List networks with their subnets
154
155
156 $ podman network ls --format "{{.Name}}: {{range .Subnets}}{{.Subnet}} {{end}}"
157 podman: 10.88.0.0/16
158 podman3: 10.89.30.0/24 fde4:f86f:4aab:e68f::/64
159 macvlan:
160
161
162
164 podman(1), podman-network(1), podman-network-inspect(1), podman-net‐
165 work-create(1)
166
167
169 August 2021, Updated with the new network format by Paul Holzinger
170 pholzing@redhat.com ⟨mailto:pholzing@redhat.com⟩
171
172
173 August 2019, Originally compiled by Brent Baude bbaude@redhat.com
174 ⟨mailto:bbaude@redhat.com⟩
175
176
177
178 podman-network-ls(1)