podman-network-rm1
Remove one or more networks
Usage
podman network
rm
[options]
[network ...]
Overview
Delete one or more Podman networks.
Options
--force, -f
The force option removes all containers that use the named network. If the container is running, the container is stopped and removed.
--ignore, -i
Ignore the error when a specified network does not exist. Other failures, including a network being in use, are still returned.
--time, -t=seconds
Seconds to wait before forcibly stopping the running containers that are using the specified network. The --force option must be specified to use the --time option. Use -1 for infinite wait.
Examples
Delete specified network:
# podman network rm podman9 podman9
Delete specified network and all containers associated with the network:
# podman network rm -f fred fred
Delete specified network and all containers associated with the network after waiting up to 15 seconds:
# podman network rm --force --time 15 fred fred
Exit status
0 All specified networks removed
1 One of the specified networks did not exist, and no other failures
2 The network is in use by a container or a Pod
125 The command fails for any other reason
Releases
4 releases since Debian 11 (Bullseye); the text changed 3 times.