2016-10-14 18:30:36 -04:00
|
|
|
---
|
|
|
|
title: "network rm"
|
|
|
|
description: "the network rm command description and usage"
|
2016-11-03 18:48:30 -04:00
|
|
|
keywords: "network, rm, user-defined"
|
2016-10-14 18:30:36 -04:00
|
|
|
---
|
2015-09-28 21:57:03 -04:00
|
|
|
|
2017-07-28 13:28:23 -04:00
|
|
|
<!-- This file is maintained within the docker/cli Github
|
|
|
|
repository at https://github.com/docker/cli/. Make all
|
2016-10-19 13:25:45 -04:00
|
|
|
pull requests against that repo. If you see this file in
|
|
|
|
another repository, consider it read-only there, as it will
|
|
|
|
periodically be overwritten by the definitive file. Pull
|
|
|
|
requests which include edits to this file in other repositories
|
|
|
|
will be rejected.
|
|
|
|
-->
|
|
|
|
|
2015-09-28 21:57:03 -04:00
|
|
|
# network rm
|
|
|
|
|
2016-07-07 14:43:18 -04:00
|
|
|
```markdown
|
2016-07-29 13:41:52 -04:00
|
|
|
Usage: docker network rm NETWORK [NETWORK...]
|
2015-09-28 21:57:03 -04:00
|
|
|
|
2016-07-29 13:41:52 -04:00
|
|
|
Remove one or more networks
|
2015-09-28 21:57:03 -04:00
|
|
|
|
2016-07-07 14:43:18 -04:00
|
|
|
Aliases:
|
|
|
|
rm, remove
|
|
|
|
|
|
|
|
Options:
|
|
|
|
--help Print usage
|
|
|
|
```
|
2015-09-28 21:57:03 -04:00
|
|
|
|
2017-02-07 18:42:48 -05:00
|
|
|
## Description
|
|
|
|
|
2015-10-29 12:10:20 -04:00
|
|
|
Removes one or more networks by name or identifier. To remove a network,
|
|
|
|
you must first disconnect any containers connected to it.
|
2017-02-07 18:42:48 -05:00
|
|
|
|
|
|
|
## Examples
|
|
|
|
|
|
|
|
### Remove a network
|
|
|
|
|
2015-10-29 12:10:20 -04:00
|
|
|
To remove the network named 'my-network':
|
2015-09-28 21:57:03 -04:00
|
|
|
|
2015-10-18 19:47:32 -04:00
|
|
|
```bash
|
2015-09-28 21:57:03 -04:00
|
|
|
$ docker network rm my-network
|
|
|
|
```
|
2015-10-18 19:47:32 -04:00
|
|
|
|
2017-02-07 18:42:48 -05:00
|
|
|
### Remove multiple networks
|
|
|
|
|
2015-10-29 12:10:20 -04:00
|
|
|
To delete multiple networks in a single `docker network rm` command, provide
|
2016-02-16 22:54:45 -05:00
|
|
|
multiple network names or ids. The following example deletes a network with id
|
2015-10-29 12:10:20 -04:00
|
|
|
`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.
|
|
|
|
|
2017-02-07 18:42:48 -05:00
|
|
|
## Related commands
|
2015-10-18 19:47:32 -04: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)
|
2016-10-18 00:36:52 -04:00
|
|
|
* [network prune](network_prune.md)
|
2016-10-20 23:24:28 -04:00
|
|
|
* [Understand Docker container networks](https://docs.docker.com/engine/userguide/networking/)
|