2016-10-18 04:36:52 +00:00
---
title: "network prune"
description: "Remove unused networks"
2016-11-03 22:48:30 +00:00
keywords: "network, prune, delete"
2016-10-18 04:36:52 +00:00
---
# network prune
```markdown
Usage: docker network prune [OPTIONS]
Remove all unused networks
Options:
2016-12-07 22:02:13 +00:00
--filter filter Provide filter values (e.g. 'until=< timestamp > ')
-f, --force Do not prompt for confirmation
--help Print usage
2016-10-18 04:36:52 +00:00
```
2017-02-07 23:42:48 +00:00
## Description
2016-10-18 04:36:52 +00:00
2017-02-07 23:42:48 +00:00
Remove all unused networks. Unused networks are those which are not referenced
by any containers.
## Examples
2016-10-18 04:36:52 +00:00
```bash
$ docker network prune
2017-02-07 23:42:48 +00:00
2016-10-18 04:36:52 +00:00
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
```
2017-02-07 23:42:48 +00:00
### Filtering
2016-12-07 22:02:13 +00:00
The filtering flag (`-f` or `--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
2017-04-10 18:08:40 +00:00
* label (`label=< key > `, `label=<key>=<value>` , `label!=<key>` , or `label!=<key>=<value>` ) - only remove networks with (or without, in case `label!=...` is used) the specified labels.
2016-12-07 22:02:13 +00:00
The `until` filter can be Unix timestamps, date formatted
timestamps, or Go duration strings (e.g. `10m` , `1h30m` ) computed
relative to the daemon machine’ s time. Supported formats for date
formatted time stamps include RFC3339Nano, RFC3339, `2006-01-02T15:04:05` ,
`2006-01-02T15:04:05.999999999` , `2006-01-02Z07:00` , and `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.
2017-04-10 18:08:40 +00:00
The `label` filter accepts two formats. One is the `label=...` (`label=< key > ` or `label=<key>=<value>` ),
which removes networks with the specified labels. The other
format is the `label!=...` (`label!=< key > ` or `label!=<key>=<value>` ), which removes
networks without the specified labels.
2016-12-07 22:02:13 +00:00
The following removes networks created more than 5 minutes ago. Note that
system networks such as `bridge` , `host` , and `none` will never be pruned:
2017-02-07 23:42:48 +00:00
```none
2016-12-07 22:02:13 +00:00
$ docker network ls
2017-02-07 23:42:48 +00:00
2016-12-07 22:02:13 +00:00
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
2017-02-07 23:42:48 +00:00
2016-12-07 22:02:13 +00:00
Deleted Networks:
foo-1-day-ago
$ docker network ls
2017-02-07 23:42:48 +00:00
2016-12-07 22:02:13 +00:00
NETWORK ID NAME DRIVER SCOPE
7430df902d7a bridge bridge local
ab53663ed3c7 foo-1-min-ago bridge local
97b91972bc3b host host local
f949d337b1f5 none null local
```
2017-02-07 23:42:48 +00:00
## Related commands
2016-10-18 04:36:52 +00:00
* [network disconnect ](network_disconnect.md )
* [network connect ](network_connect.md )
* [network create ](network_create.md )
* [network ls ](network_ls.md )
* [network inspect ](network_inspect.md )
* [network rm ](network_rm.md )
2016-10-27 08:24:55 +00:00
* [Understand Docker container networks ](https://docs.docker.com/engine/userguide/networking/ )
2016-10-18 04:36:52 +00:00
* [system df ](system_df.md )
* [container prune ](container_prune.md )
* [image prune ](image_prune.md )
* [volume prune ](volume_prune.md )
* [system prune ](system_prune.md )