podman-machine(1) General Commands Manual podman-machine(1)
NAME
podman-machine - Manage Podman's virtual machine
SYNOPSIS
podman machine subcommand
DESCRIPTION
podman machine is a set of subcommands that manage Podman's virtual ma-
chine.
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 ma-
chine must be used to manage MacOS and Windows machines, but can be op-
tionally 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.
Podman machine behaviour can be modified via the [machine] section in
the containers.conf(5) file.
SUBCOMMANDS
┌─────────┬───────────────────────────┬───────────────────────────────┐
│ Command │ Man Page │ Description │
├─────────┼───────────────────────────┼───────────────────────────────┤
│ info │ podman-machine-info(1) │ Display machine host info │
├─────────┼───────────────────────────┼───────────────────────────────┤
│ init │ podman-machine-init(1) │ Initialize a new virtual ma- │
│ │ │ chine │
├─────────┼───────────────────────────┼───────────────────────────────┤
│ inspect │ podman-machine-inspect(1) │ Inspect one or more virtual │
│ │ │ machines │
├─────────┼───────────────────────────┼───────────────────────────────┤
│ list │ podman-machine-list(1) │ List virtual machines │
├─────────┼───────────────────────────┼───────────────────────────────┤
│ os │ podman-machine-os(1) │ Manage a Podman virtual ma- │
│ │ │ chine's OS │
├─────────┼───────────────────────────┼───────────────────────────────┤
│ reset │ podman-machine-reset(1) │ Reset Podman machines and en- │
│ │ │ vironment │
├─────────┼───────────────────────────┼───────────────────────────────┤
│ rm │ podman-machine-rm(1) │ Remove a virtual machine │
├─────────┼───────────────────────────┼───────────────────────────────┤
│ set │ podman-machine-set(1) │ Set a virtual machine setting │
├─────────┼───────────────────────────┼───────────────────────────────┤
│ ssh │ podman-machine-ssh(1) │ SSH into a virtual machine │
├─────────┼───────────────────────────┼───────────────────────────────┤
│ start │ podman-machine-start(1) │ Start a virtual machine │
├─────────┼───────────────────────────┼───────────────────────────────┤
│ stop │ podman-machine-stop(1) │ Stop a virtual machine │
└─────────┴───────────────────────────┴───────────────────────────────┘
SEE ALSO
podman(1), podman-machine-info(1), podman-machine-init(1), podman-ma-
chine-list(1), podman-machine-os(1), podman-machine-rm(1), podman-ma-
chine-ssh(1), podman-machine-start(1), podman-machine-stop(1), podman-
machine-inspect(1), podman-machine-reset(1), containers.conf(5)
Troubleshooting
See podman-troubleshooting(7) for solutions to common issues.
HISTORY
March 2021, Originally compiled by Ashley Cui acui@redhat.com
⟨mailto:acui@redhat.com⟩
podman-machine(1)
Generated by dwww version 1.16 on Tue Dec 16 06:15:46 CET 2025.