blob: 7f39c09ad790a6a9e651878d05a0e1f66b67469d (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
|
% podman-rm(1)
## NAME
podman\-container\-rm (podman\-rm) - Remove one or more containers
## SYNOPSIS
**podman container rm** [*options*] *container*
**podman rm** [*options*] *container*
## DESCRIPTION
**podman rm** will remove one or more containers from the host. The container name or ID can be used. This does not remove images. Running containers will not be removed without the `-f` option
## OPTIONS
**--all**, **-a**
Remove all containers. Can be used in conjunction with -f as well.
**--force**, **-f**
Force the removal of running and paused containers. Forcing a containers removal also
removes containers from container storage even if the container is not known to podman.
Containers could have been created by a different container engine.
**--latest**, **-l**
Instead of providing the container name or ID, use the last created container. If you use methods other than Podman
to run containers such as CRI-O, the last started container could be from either of those methods.
The latest option is not supported on the remote client.
**--storage**
Remove the container from the storage library only.
This is only possible with containers that are not present in libpod (cannot be seen by `podman ps`).
It is used to remove containers from `podman build` and `buildah`, and orphan containers which were only partially removed by `podman rm`.
The storage option conflicts with the **--all**, **--latest**, and **--volumes** options.
**--volumes**, **-v**
Remove the volumes associated with the container.
## EXAMPLE
Remove a container by its name *mywebserver*
```
podman rm mywebserver
```
Remove several containers by name and container id.
```
podman rm mywebserver myflaskserver 860a4b23
```
Forcibly remove a container by container ID.
```
podman rm -f 860a4b23
```
Remove all containers regardless of its run state.
```
podman rm -f -a
```
Forcibly remove the latest container created.
```
podman rm -f --latest
```
## Exit Status
**_0_** if all specified containers removed
**_1_** if one of the specified containers did not exist, and no other failures
**_2_** if one of the specified containers is paused or running
**_125_** if the command fails for a reason other than container did not exist or is paused/running
## SEE ALSO
podman(1), podman-image-rm(1)
## HISTORY
August 2017, Originally compiled by Ryan Cole <rycole@redhat.com>
|
