Your company here — click to reach over 10,000 unique daily visitors

podman-machine - Man Page

Manage Podman's virtual machine

Examples (TL;DR)


podman machine subcommand


podman machine is a set of subcommands that manage Podman's virtual machine.

Podman on MacOS and Windows requires a virtual machine. This is because containers are Linux - containers do not run on any other OS because containers' core functionality are tied to the Linux kernel. Podman machine must be used to manage MacOS and Windows machines, but can be optionally used on Linux.

All podman machine commands are rootless only.

NOTE: The podman-machine configuration file is managed under the $XDG_CONFIG_HOME/containers/podman/machine/ directory. Changing the $XDG_CONFIG_HOME environment variable while the machines are running can lead to unexpected behavior.


CommandMan PageDescription
infopodman-machine-info(1)Display machine host info
initpodman-machine-init(1)Initialize a new virtual machine
inspectpodman-machine-inspect(1)Inspect one or more virtual machines
listpodman-machine-list(1)List virtual machines
ospodman-machine-os(1)Manage a Podman virtual machine's OS
resetpodman-machine-reset(1)Reset Podman machines and environment
rmpodman-machine-rm(1)Remove a virtual machine
setpodman-machine-set(1)Set a virtual machine setting
sshpodman-machine-ssh(1)SSH into a virtual machine
startpodman-machine-start(1)Start a virtual machine
stoppodman-machine-stop(1)Stop a virtual machine

See Also

podman(1), podman-machine-info(1), podman-machine-init(1), podman-machine-list(1), podman-machine-os(1), podman-machine-rm(1), podman-machine-ssh(1), podman-machine-start(1), podman-machine-stop(1), podman-machine-inspect(1), podman-machine-reset(1)


March 2021, Originally compiled by Ashley Cui acui@redhat.com ⟨mailto:acui@redhat.com⟩

Referenced By

podman(1), podman-machine-info(1), podman-machine-init(1), podman-machine-inspect(1), podman-machine-list(1), podman-machine-os(1), podman-machine-os-apply(1), podman-machine-reset(1), podman-machine-rm(1), podman-machine-set(1), podman-machine-ssh(1), podman-machine-start(1), podman-machine-stop(1).

The man page docker-machine(1) is an alias of podman-machine(1).