Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
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 con-
     tainers' 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_CON-
     FIG_HOME/containers/podman/machine/   directory.	Changing  the  $XDG_CON-
     FIG_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		   |
     +---------+---------------------------+-------------------------------+
     | cp      | podman-machine-cp(1)	   | Securely  copy  contents  be- |
     |	       |			   | tween  the  host and the vir- |
     |	       |			   | tual machine		   |
     +---------+---------------------------+-------------------------------+
     | 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-cp(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),	contain-
     ers.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)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=podman-machine&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help