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

SUBCOMMANDS

       ┌────────┬───────────────────────────┬────────────────────────────────┐
       │Command │ Man Page                  │ Description                    │
       ├────────┼───────────────────────────┼────────────────────────────────┤
       │info    │ podman-machine-info(1)    │ Display machine host info      │
       ├────────┼───────────────────────────┼────────────────────────────────┤
       │init    │ podman-machine-init(1)    │ Initialize   a   new   virtual │
       │        │                           │ machine                        │
       ├────────┼───────────────────────────┼────────────────────────────────┤
       │inspect │ podman-machine-inspect(1) │ Inspect  one  or  more virtual │
       │        │                           │ machines                       │
       ├────────┼───────────────────────────┼────────────────────────────────┤
       │list    │ podman-machine-list(1)    │ List virtual machines          │
       ├────────┼───────────────────────────┼────────────────────────────────┤
       │rm      │ podman-machine-rm(1)      │ Remove a virtual machine       │
       ├────────┼───────────────────────────┼────────────────────────────────┤
       │set     │ podman-machine-set(1)     │ Sets 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-machine-list(1), podman-
       machine-rm(1),   podman-machine-ssh(1),  podman-machine-start(1),  podman-machine-stop(1),
       podman-machine-inspect(1)

HISTORY

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

                                                                                podman-machine(1)