docker network pruneEstimated reading time: 3 minutes
Edge only: This is the CLI reference for Docker CE Edge versions. Some of these options may not be available to Docker CE stable or Docker EE. You can view the stable version of this CLI reference or learn about Docker CE Edge.
Remove all unused networks
The client and daemon API must both be at least
to use this command. Use the
docker version command on the client to check
your client and daemon API versions.
docker network prune [OPTIONS]
||Provide filter values (e.g. ‘until=
||Do not prompt for confirmation|
|docker network||Manage networks|
|docker network connect||Connect a container to a network|
|docker network create||Create a network|
|docker network disconnect||Disconnect a container from a network|
|docker network inspect||Display detailed information on one or more networks|
|docker network ls||List networks|
|docker network prune||Remove all unused networks|
|docker network rm||Remove one or more networks|
Remove all unused networks. Unused networks are those which are not referenced by any containers.
$ docker network prune WARNING! This will remove all networks not used by at least one container. Are you sure you want to continue? [y/N] y Deleted Networks: n1 n2
The filtering flag (
--filter) format is of “key=value”. If there is more
than one filter, then pass multiple flags (e.g.,
--filter "foo=bar" --filter "bif=baz")
The currently supported filters are:
- until (
<timestamp>) - only remove networks created before given timestamp
- label (
label!=<key>=<value>) - only remove networks with (or without, in case
label!=...is used) the specified labels.
until filter can be Unix timestamps, date formatted
timestamps, or Go duration strings (e.g.
relative to the daemon machine’s time. Supported formats for date
formatted time stamps include RFC3339Nano, RFC3339,
2006-01-02. The local
timezone on the daemon will be used if you do not provide either a
Z or a
+-00:00 timezone offset at the end of the timestamp. When providing Unix
timestamps enter seconds[.nanoseconds], where seconds is the number of seconds
that have elapsed since January 1, 1970 (midnight UTC/GMT), not counting leap
seconds (aka Unix epoch or Unix time), and the optional .nanoseconds field is a
fraction of a second no more than nine digits long.
label filter accepts two formats. One is the
which removes networks with the specified labels. The other
format is the
label!=<key>=<value>), which removes
networks without the specified labels.
The following removes networks created more than 5 minutes ago. Note that
system networks such as
none will never be pruned:
$ docker network ls NETWORK ID NAME DRIVER SCOPE 7430df902d7a bridge bridge local ea92373fd499 foo-1-day-ago bridge local ab53663ed3c7 foo-1-min-ago bridge local 97b91972bc3b host host local f949d337b1f5 none null local $ docker network prune --force --filter until=5m Deleted Networks: foo-1-day-ago $ docker network ls NETWORK ID NAME DRIVER SCOPE 7430df902d7a bridge bridge local ab53663ed3c7 foo-1-min-ago bridge local 97b91972bc3b host host local f949d337b1f5 none null local