Files
podman/docs/source/markdown/podman-machine-rm.1.md
baude 7a79f708a4 Podman machine enhancements
Podman machine remove is now called `rm`.

Podman machine create now supports resizing the image to the value of
--disk-size as provided.  The default is to 10G.

Added systemd unit file on guest via ignition that sends a Ready message
to the host over a virtio-socket so that we know when the VM is booted
and ready for use.

Podman machine commands no longer require a VM name as an argument.  A
default VM name is defined and if no VM name is provided as a arg, the
default will be used.

[NO TESTS NEEDED]

Signed-off-by: baude <bbaude@redhat.com>
2021-03-27 10:08:11 -05:00

1.4 KiB

% podman-machine-rm(1)

NAME

podman-machine-rm - Remove a virtual machine

SYNOPSIS

podman machine rm [options] [name]

DESCRIPTION

Remove a virtual machine and its related files. What is actually deleted depends on the virtual machine type. For all virtual machines, the generated SSH keys and the podman system connection are deleted. The ignition files generated for that VM are also removed as is its image file on the filesystem.

Users get a display of what will be deleted and are required to confirm unless the option --force is used.

OPTIONS

--help

Print usage statement.

--force

Delete without confirmation

--save-ignition

Do not delete the generated ignition file

--save-image

Do not delete the VM image

--save-keys

Do not delete the SSH keys for the VM. The system connection is always deleted.

EXAMPLES

Remove a VM named "test1"

$ podman machine rm test1

The following files will be deleted:

/home/user/.ssh/test1
/home/user/.ssh/test1.pub
/home/user/.config/containers/podman/machine/qemu/test1.ign
/home/user/.local/share/containers/podman/machine/qemu/test1_fedora-coreos-33.20210315.1.0-qemu.x86_64.qcow2
/home/user/.config/containers/podman/machine/qemu/test1.json

Are you sure you want to continue? [y/N] y

SEE ALSO

podman-machine (1)

HISTORY

March 2021, Originally compiled by Ashley Cui acui@redhat.com