NAME

       podman-pod-stop - Stop one or more pods

SYNOPSIS

       podman pod stop [options] pod ...

DESCRIPTION

       Stop containers in one or more pods.  You may use pod IDs or names as input.

OPTIONS

   --all, -a
       Stops all pods

   --ignore, -i
       Ignore  errors  when  specified  pods  are  not in the container store.  A user might have
       decided to manually remove a pod which leads to a failure during the ExecStop directive of
       a systemd service referencing that pod.

   --latest, -l
       Instead of providing the pod name or ID, use the last created pod.  Note: the last started
       pod can be from other users of Podman on the host machine.  (This option is not  available
       with the remote Podman client, including Mac and Windows (excluding WSL2) machines)

   --pod-id-file=file
       Read pod ID from the specified file and stop the pod. Can be specified multiple times.

   --time, -t=seconds
       Seconds  to  wait  before forcibly stopping running containers within the pod.  Use -1 for
       infinite wait.

EXAMPLE

       Stop pod with a given name.

       $ podman pod stop mywebserverpod
       cc8f0bea67b1a1a11aec1ecd38102a1be4b145577f21fc843c7c83b77fc28907

       Stop multiple pods with given IDs.

       $ podman pod stop 490eb 3557fb
       490eb241aaf704d4dd2629904410fe4aa31965d9310a735f8755267f4ded1de5
       3557fbea6ad61569de0506fe037479bd9896603c31d3069a6677f23833916fab

       Stop the last created pod. (This option is not available with the  remote  Podman  client,
       including Mac and Windows (excluding WSL2) machines)

       $ podman pod stop --latest
       3557fbea6ad61569de0506fe037479bd9896603c31d3069a6677f23833916fab

       Stop all pods.

       $ podman pod stop --all
       19456b4cd557eaf9629825113a552681a6013f8c8cad258e36ab825ef536e818
       3557fbea6ad61569de0506fe037479bd9896603c31d3069a6677f23833916fab
       490eb241aaf704d4dd2629904410fe4aa31965d9310a735f8755267f4ded1de5
       70c358daecf71ef9be8f62404f926080ca0133277ef7ce4f6aa2d5af6bb2d3e9
       cc8f0bea67b1a1a11aec1ecd38102a1be4b145577f21fc843c7c83b77fc28907

       Stop two pods via --pod-id-file.

       $ podman pod stop --pod-id-file file1 --pod-id-file file2
       19456b4cd557eaf9629825113a552681a6013f8c8cad258e36ab825ef536e818
       cc8f0bea67b1a1a11aec1ecd38102a1be4b145577f21fc843c7c83b77fc28907

       Stop all pods with a timeout of 1 second.

       $ podman pod stop -a -t 1
       3557fbea6ad61569de0506fe037479bd9896603c31d3069a6677f23833916fab
       490eb241aaf704d4dd2629904410fe4aa31965d9310a735f8755267f4ded1de5
       70c358daecf71ef9be8f62404f926080ca0133277ef7ce4f6aa2d5af6bb2d3e9

SEE ALSO

       podman(1), podman-pod(1), podman-pod-start(1)

HISTORY

       July 2018, Originally compiled by Peter Hunt pehunt@redhat.com ⟨mailto:pehunt@redhat.com⟩

                                                                               podman-pod-stop(1)