podman-kube-down(1) - Man pages

podman-kube-down(1)         General Commands Manual         podman-kube-down(1)

NAME
       podman-kube-down - Remove containers and pods based on Kubernetes YAML

SYNOPSIS
       podman kube down [options] file.yml|-|https://website.io/file.yml

DESCRIPTION
       podman  kube  down  reads a specified Kubernetes YAML file, tearing down
       pods that were created by the podman kube play command via the same  Ku-
       bernetes YAML file. Any volumes that were created by the previous podman
       kube  play  command remain intact unless the --force options is used. If
       the YAML file is specified as -, podman kube down reads  the  YAML  from
       stdin.  The  input  can also be a URL that points to a YAML file such as
       https://podman.io/demo.yml.  podman kube down tears down  the  pods  and
       containers created by podman kube play via the same Kubernetes YAML from
       the  URL. However, podman kube down does not work with a URL if the YAML
       file the URL points to has been changed or altered since the creation of
       the pods and containers using podman kube play.

OPTIONS
   --force
       Tear down the volumes  linked  to  the  PersistentVolumeClaims  as  part
       --down

EXAMPLES
       Example YAML file demo.yml:

       apiVersion: v1
       kind: Pod
       metadata:
       ...
       spec:
         containers:
         - command:
           - top
           - name: container
             value: podman
           image: foobar
       ...

       Remove the pod and containers as described in the demo.yml file

       $ podman kube down demo.yml
       Pods stopped:
       52182811df2b1e73f36476003a66ec872101ea59034ac0d4d3a7b40903b955a6
       Pods removed:
       52182811df2b1e73f36476003a66ec872101ea59034ac0d4d3a7b40903b955a6

       Remove  the  pod  and  containers as described in the demo.yml file YAML
       sent to stdin

       $ cat demo.yml | podman kube play -
       Pods stopped:
       52182811df2b1e73f36476003a66ec872101ea59034ac0d4d3a7b40903b955a6
       Pods removed:
       52182811df2b1e73f36476003a66ec872101ea59034ac0d4d3a7b40903b955a6

       Remove the pods and containers as described in the  demo.yml  file  YAML
       read from a URL

       $ podman kube down https://podman.io/demo.yml
       Pods stopped:
       52182811df2b1e73f36476003a66ec872101ea59034ac0d4d3a7b40903b955a6
       Pods removed:
       52182811df2b1e73f36476003a66ec872101ea59034ac0d4d3a7b40903b955a6

       podman  kube  down  does  not  work  with a URL if the YAML file the URL
       points to has been changed or altered since it was used  to  create  the
       pods and containers.

SEE ALSO
       podman(1), podman-kube(1), podman-kube-play(1), podman-kube-generate(1),
       containers-certs.d(5)

                                                            podman-kube-down(1)

Generated by dwww version 1.16 on Tue Dec 16 06:15:40 CET 2025.