1podman-machine-rm(1)        General Commands Manual       podman-machine-rm(1)
2
3
4

NAME

6       podman-machine-rm - Remove a virtual machine
7
8

SYNOPSIS

10       podman machine rm [options] [name]
11
12

DESCRIPTION

14       Remove  a  virtual  machine  and  its  related files.  What is actually
15       deleted depends on the virtual machine type.  For all virtual machines,
16       the  generated  SSH  keys and the podman system connection are deleted.
17       The ignition files generated for that VM are also removed as is its im‐
18       age file on the filesystem.
19
20
21       Users get a display of what will be deleted and are required to confirm
22       unless the option --force is used.
23
24
25       Rootless only.
26
27

OPTIONS

29   --force, -f
30       Stop and delete without confirmation.
31
32
33   --help
34       Print usage statement.
35
36
37   --save-ignition
38       Do not delete the generated ignition file.
39
40
41   --save-image
42       Do not delete the VM image.
43
44
45   --save-keys
46       Do not delete the SSH keys for the VM.  The system connection is always
47       deleted.
48
49

EXAMPLES

51       Remove a VM named "test1":
52
53
54              $ podman machine rm test1
55
56              The following files will be deleted:
57
58              /home/user/.ssh/test1
59              /home/user/.ssh/test1.pub
60              /home/user/.config/containers/podman/machine/qemu/test1.ign
61              /home/user/.local/share/containers/podman/machine/qemu/test1_fedora-coreos-33.20210315.1.0-qemu.x86_64.qcow2
62              /home/user/.config/containers/podman/machine/qemu/test1.json
63
64              Are you sure you want to continue? [y/N] y
65
66
67
68              $ podman machine rm -f test1
69              $
70
71
72

SEE ALSO

74       podman(1), podman-machine(1)
75
76

HISTORY

78       March   2021,   Originally   compiled  by  Ashley  Cui  acui@redhat.com
79       ⟨mailto:acui@redhat.com⟩
80
81
82
83                                                          podman-machine-rm(1)