summaryrefslogtreecommitdiff
path: root/docs/source/man/podman-pod-rm.1.md
blob: 6659534b499bf484d55ddaa406cf067350045ec4 (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
% podman-pod-rm(1)

## NAME
podman\-pod\-rm - Remove one or more pods

## SYNOPSIS
**podman pod rm** [*options*] *pod*

## DESCRIPTION
**podman pod rm** will remove one or more pods from the host.  The pod name or ID can be used. The \-f option stops all containers and then removes them before removing the pod. Without the \-f option, a pod cannot be removed if it has associated containers.

## OPTIONS

**--all**, **-a**

Remove all pods.  Can be used in conjunction with \-f as well.

**--latest**, **-l**

Instead of providing the pod name or ID, remove the last created pod.

The latest option is not supported on the remote client.

**--force**, **-f**

Stop running containers and delete all stopped containers before removal of pod.

## EXAMPLE

podman pod rm mywebserverpod

podman pod rm mywebserverpod myflaskserverpod 860a4b23

podman pod rm -f 860a4b23

podman pod rm -f -a

podman pod rm -fa

## SEE ALSO
podman-pod(1)

## HISTORY
July 2018, Originally compiled by Peter Hunt <pehunt@redhat.com>