2015-09-29 01:57:03 +00:00
|
|
|
<!--[metadata]>
|
|
|
|
+++
|
|
|
|
title = "network rm"
|
|
|
|
description = "the network rm command description and usage"
|
2015-09-30 20:11:36 +00:00
|
|
|
keywords = ["network, rm, user-defined"]
|
2015-09-29 01:57:03 +00:00
|
|
|
[menu.main]
|
|
|
|
parent = "smn_cli"
|
|
|
|
+++
|
|
|
|
<![end-metadata]-->
|
|
|
|
|
|
|
|
# network rm
|
|
|
|
|
2015-10-29 16:10:20 +00:00
|
|
|
Usage: docker network rm [OPTIONS] NETWORK [NETWORK...]
|
2015-09-29 01:57:03 +00:00
|
|
|
|
2015-10-29 16:10:20 +00:00
|
|
|
Deletes one or more networks
|
2015-09-29 01:57:03 +00:00
|
|
|
|
|
|
|
--help=false Print usage
|
|
|
|
|
2015-10-29 16:10:20 +00:00
|
|
|
Removes one or more networks by name or identifier. To remove a network,
|
|
|
|
you must first disconnect any containers connected to it.
|
|
|
|
To remove the network named 'my-network':
|
2015-09-29 01:57:03 +00:00
|
|
|
|
2015-10-18 23:47:32 +00:00
|
|
|
```bash
|
2015-09-29 01:57:03 +00:00
|
|
|
$ docker network rm my-network
|
|
|
|
```
|
2015-10-18 23:47:32 +00:00
|
|
|
|
2015-10-29 16:10:20 +00:00
|
|
|
To delete multiple networks in a single `docker network rm` command, provide
|
|
|
|
multiple network names or id's. The following example deletes a network with id
|
|
|
|
`3695c422697f` and a network named `my-network`:
|
|
|
|
|
|
|
|
```bash
|
|
|
|
$ docker network rm 3695c422697f my-network
|
|
|
|
```
|
|
|
|
|
|
|
|
When you specify multiple networks, the command attempts to delete each in turn.
|
|
|
|
If the deletion of one network fails, the command continues to the next on the
|
|
|
|
list and tries to delete that. The command reports success or failure for each
|
|
|
|
deletion.
|
|
|
|
|
2015-10-18 23:47:32 +00:00
|
|
|
## Related information
|
|
|
|
|
|
|
|
* [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)
|
|
|
|
* [Understand Docker container networks](../../userguide/networking/dockernetworks.md)
|