docker network rm

Description

Remove one or more networks

API 1.21+  The client and daemon API must both be at least 1.21 to use this command. Use the docker version command on the client to check your client and daemon API versions.

Usage

docker network rm NETWORK [NETWORK...]

Extended description

Removes one or more networks by name or identifier. To remove a network, you must first disconnect any containers connected to it.

For example uses of this command, refer to the examples section below.

Examples

Remove a network

To remove the network named ‘my-network’:

  $ 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:

  $ 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.

Parent command

Command Description
docker network Manage networks
Command Description
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