mirror of
https://github.com/docker/cli.git
synced 2025-08-31 23:02:07 +03:00
these markdown files are not consumed directly in the docs, but only their content is included through the YAML does, so there's no need to have these comments in them Signed-off-by: Sebastiaan van Stijn <github@gone.nl>
60 lines
1.4 KiB
Markdown
60 lines
1.4 KiB
Markdown
---
|
|
title: "network rm"
|
|
description: "the network rm command description and usage"
|
|
keywords: "network, rm, user-defined"
|
|
---
|
|
|
|
# network rm
|
|
|
|
```markdown
|
|
Usage: docker network rm NETWORK [NETWORK...]
|
|
|
|
Remove one or more networks
|
|
|
|
Aliases:
|
|
rm, remove
|
|
|
|
Options:
|
|
--help Print usage
|
|
```
|
|
|
|
## Description
|
|
|
|
Removes one or more networks by name or identifier. To remove a network,
|
|
you must first disconnect any containers connected to it.
|
|
|
|
## Examples
|
|
|
|
### Remove a network
|
|
|
|
To remove the network named 'my-network':
|
|
|
|
```bash
|
|
$ docker network rm my-network
|
|
```
|
|
|
|
### Remove multiple networks
|
|
|
|
To delete multiple networks in a single `docker network rm` command, provide
|
|
multiple network names or ids. 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.
|
|
|
|
## Related commands
|
|
|
|
* [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 prune](network_prune.md)
|
|
* [Understand Docker container networks](https://docs.docker.com/engine/userguide/networking/)
|