summaryrefslogtreecommitdiff
path: root/docs/podman-pod-rm.1.md
blob: 725702714d42987e2c5b0346bea25a2602b2e747 (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
% podman-pod-rm "1"

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

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

## 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 then removes them before removing the pod. Without the -f option, a pod cannot be removed if it has attached containers.

## OPTIONS

**--force, f**

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

**--all, a**

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

## 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
August 2017, Originally compiled by Ryan Cole <rycole@redhat.com>
July 2018, Adapted from podman rm man page by Peter Hunt <pehunt@redhat.com>