github.com/hanks177/podman/v4@v4.1.3-0.20220613032544-16d90015bc83/docs/source/markdown/podman-machine-rm.1.md (about)

     1  % podman-machine-rm(1)
     2  
     3  ## NAME
     4  podman\-machine\-rm - Remove a virtual machine
     5  
     6  ## SYNOPSIS
     7  **podman machine rm** [*options*] [*name*]
     8  
     9  ## DESCRIPTION
    10  
    11  Remove a virtual machine and its related files.  What is actually deleted
    12  depends on the virtual machine type.  For all virtual machines, the generated
    13  SSH keys and the podman system connection are deleted.  The ignition files
    14  generated for that VM are also removed as is its image file on the filesystem.
    15  
    16  Users get a display of what will be deleted and are required to confirm unless the option `--force`
    17  is used.
    18  
    19  
    20  ## OPTIONS
    21  
    22  #### **--force**, **-f**
    23  
    24  Stop and delete without confirmation.
    25  
    26  #### **--help**
    27  
    28  Print usage statement.
    29  
    30  #### **--save-ignition**
    31  
    32  Do not delete the generated ignition file.
    33  
    34  #### **--save-image**
    35  
    36  Do not delete the VM image.
    37  
    38  #### **--save-keys**
    39  
    40  Do not delete the SSH keys for the VM.  The system connection is always
    41  deleted.
    42  
    43  ## EXAMPLES
    44  
    45  Remove a VM named "test1":
    46  
    47  ```
    48  $ podman machine rm test1
    49  
    50  The following files will be deleted:
    51  
    52  /home/user/.ssh/test1
    53  /home/user/.ssh/test1.pub
    54  /home/user/.config/containers/podman/machine/qemu/test1.ign
    55  /home/user/.local/share/containers/podman/machine/qemu/test1_fedora-coreos-33.20210315.1.0-qemu.x86_64.qcow2
    56  /home/user/.config/containers/podman/machine/qemu/test1.json
    57  
    58  Are you sure you want to continue? [y/N] y
    59  ```
    60  
    61  ```
    62  $ podman machine rm -f test1
    63  $
    64  ```
    65  ## SEE ALSO
    66  **[podman(1)](podman.1.md)**, **[podman-machine(1)](podman-machine.1.md)**
    67  
    68  ## HISTORY
    69  March 2021, Originally compiled by Ashley Cui <acui@redhat.com>