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       $ podman machine rm test1
59
60       The following files will be deleted:
61
62       /home/user/.ssh/test1
63       /home/user/.ssh/test1.pub
64       /home/user/.config/containers/podman/machine/qemu/test1.ign
65       /home/user/.local/share/containers/podman/machine/qemu/test1_fedora-coreos-33.20210315.1.0-qemu.x86_64.qcow2
66       /home/user/.config/containers/podman/machine/qemu/test1.json
67
68       Are you sure you want to continue? [y/N] y
69
70
71       $ podman machine rm -f test1
72       $
73
74
75

SEE ALSO

77       podman(1), podman-machine(1)
78
79

HISTORY

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