'\" t
.nh
.TH podman-machine 1
.SH NAME
.PP
podman-machine - Manage Podman's virtual machine

.SH SYNOPSIS
.PP
\fBpodman machine\fP \fIsubcommand\fP

.SH DESCRIPTION
.PP
\fBpodman machine\fR is a set of subcommands that manage Podman's virtual machine.

.PP
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.

.PP
All \fBpodman machine\fR commands are rootless only.

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

.SH SUBCOMMANDS
.TS
allbox;
l l l 
l l l .
\fBCommand\fP	\fBMan Page\fP	\fBDescription\fP
info	podman-machine-info(1)	Display machine host info
init	podman-machine-init(1)	T{
Initialize a new virtual machine
T}
inspect	podman-machine-inspect(1)	T{
Inspect one or more virtual machines
T}
list	podman-machine-list(1)	List virtual machines
os	podman-machine-os(1)	T{
Manage a Podman virtual machine's OS
T}
reset	podman-machine-reset(1)	T{
Reset Podman machines and environment
T}
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
.TE

.SH SEE ALSO
.PP
\fBpodman(1)\fP, \fBpodman-machine-info(1)\fP, \fBpodman-machine-init(1)\fP, \fBpodman-machine-list(1)\fP, \fBpodman-machine-os(1)\fP, \fBpodman-machine-rm(1)\fP, \fBpodman-machine-ssh(1)\fP, \fBpodman-machine-start(1)\fP, \fBpodman-machine-stop(1)\fP, \fBpodman-machine-inspect(1)\fP, \fBpodman-machine-reset(1)\fP

.SH HISTORY
.PP
March 2021, Originally compiled by Ashley Cui acui@redhat.com
\[la]mailto:acui@redhat.com\[ra]