Files
podman/docs/source/markdown/podman-machine-rm.1.md
Jake Correnti b01a330d37 Use single persistent ssh key for all machines
Changes SSH key behavior such that there is a single persisted key for all
machines across all providers. If there is no key that is located at
`.local/share/containers/podman/machine/` then it is created. The keys are
not deleted when the last machine on the host is removed.

The main motivation for this change is it leads to fewer files created on the
host as a result of vm configuration. Having `n` machines on your system doesn't
result in `2n` machine-related files in `.ssh` on your system anymore.

As a result of ssh keys being persisted by default, the `--save-keys` flag
on `podman machine rm` will no longer be supported.

Signed-off-by: Jake Correnti <jakecorrenti+github@proton.me>
2024-01-04 23:47:49 -05:00

1.5 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 podman system connections 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 is deleted and are required to confirm unless the option --force is used.

The default machine name is podman-machine-default. If a machine name is not specified as an argument, then podman-machine-default will be removed.

Rootless only.

OPTIONS

--force, -f

Stop and delete without confirmation.

--help

Print usage statement.

--save-ignition

Do not delete the generated ignition file.

--save-image

Do not delete the VM image.

EXAMPLES

Remove a VM named "test1":

$ podman machine rm test1

The following files will be deleted:

/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
$ podman machine rm -f test1
$

SEE ALSO

podman(1), podman-machine(1)

HISTORY

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