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 is deleted and are required to confirm un‐
22       less the option --force is used.
23
24
25       The default machine name is podman-machine-default. If a  machine  name
26       is  not  specified  as an argument, then podman-machine-default will be
27       removed.
28
29
30       Rootless only.
31
32

OPTIONS

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

EXAMPLES

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

SEE ALSO

79       podman(1), podman-machine(1)
80
81

HISTORY

83       March   2021,   Originally   compiled  by  Ashley  Cui  acui@redhat.com
84       ⟨mailto:acui@redhat.com⟩
85
86
87
88                                                          podman-machine-rm(1)