1podman-network-ls(1)() 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 The driver filter accepts values: bridge, macvlan, ipvlan.
50 The label filter accepts two formats. One is the label=key or la‐
53 bel=key=value, which shows images with the specified labels. The other
54 format is the label!=key or label!=key=value, which shows images with‐
55 out the specified labels.
56 The until filter can be Unix timestamps, date formatted timestamps, or
59 Go duration strings (e.g. 10m, 1h30m) computed relative to the ma‐
60 chine’s time.
61 --format=format
64 Change the default output format. This can be of a supported type like
65 'json' or a Go template. Valid placeholders for the Go template are
66 listed below:
67 ┌──────────────────┬───────────────────────────────┐
70 │Placeholder │ Description │
71 ├──────────────────┼───────────────────────────────┤
72 │.ID │ Network ID │
73 ├──────────────────┼───────────────────────────────┤
74 │.Name │ Network name │
75 ├──────────────────┼───────────────────────────────┤
76 │.Driver │ Network driver │
77 ├──────────────────┼───────────────────────────────┤
78 │.Labels │ Network labels │
79 ├──────────────────┼───────────────────────────────┤
80 │.Options │ Network options │
81 ├──────────────────┼───────────────────────────────┤
82 │.IPAMOptions │ Network ipam options │
83 ├──────────────────┼───────────────────────────────┤
84 │.Created │ Timestamp when the network │
85 │ │ was created │
86 ├──────────────────┼───────────────────────────────┤
87 │.Internal │ Network is internal (boolean) │
88 ├──────────────────┼───────────────────────────────┤
89 │.IPv6Enabled │ Network has ipv6 subnet │
90 │ │ (boolean) │
91 ├──────────────────┼───────────────────────────────┤
92 │.DNSEnabled │ Network has dns enabled │
93 │ │ (boolean) │
94 ├──────────────────┼───────────────────────────────┤
95 │.NetworkInterface │ Name of the network interface │
96 │ │ on the host │
97 ├──────────────────┼───────────────────────────────┤
98 │.Subnets │ List of subnets on this net‐ │
99 │ │ work │
100 └──────────────────┴───────────────────────────────┘
101 --no-trunc
103 Do not truncate the network ID.
104 --noheading
107 Omit the table headings from the listing of networks.
108 --quiet, -q
111 The quiet option will restrict the output to only the network names.
112
115 Display networks
116 $ podman network ls
119 NETWORK ID NAME DRIVER
120 88a7120ee19d podman bridge
121 6dd508dbf8cd cni-podman6 bridge
122 8e35c2cd3bf6 cni-podman5 macvlan
123 Display only network names
127 $ podman network ls -q
130 podman
131 podman2
132 outside
133 podman9
134 Display name of network which support bridge plugin
138 $ podman network ls --filter driver=bridge --format {{.Name}}
141 podman
142 podman2
143 podman9
144 List networks with their subnets
148 $ podman network ls --format "{{.Name}}: {{range .Subnets}}{{.Subnet}} {{end}}"
151 podman: 10.88.0.0/16
152 cni-podman3: 10.89.30.0/24 fde4:f86f:4aab:e68f::/64
153 macvlan:
154
158 podman(1), podman-network(1), podman-network-inspect(1), podman-net‐
159 work-create(1)
160
163 August 2021, Updated with the new network format by Paul Holzinger
164 pholzing@redhat.com ⟨mailto:pholzing@redhat.com⟩
165 August 2019, Originally compiled by Brent Baude bbaude@redhat.com
168 ⟨mailto:bbaude@redhat.com⟩
169 podman-network-ls(1)()