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

FreeBSD Manual Pages

  
 
  

home | help
podman-machine-list(1)	    General Commands Manual	podman-machine-list(1)

NAME
       podman-machine-list - List virtual machines

SYNOPSIS
       podman machine list [options]

       podman machine ls [options]

DESCRIPTION
       List Podman managed virtual machines.

       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.

       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.	 (see podman(1))

OPTIONS
   --all-providers
       Show machines from all providers

   --format=format
       Change the default output format.  This can be of a supported type like
       'json'  or  a  Go template.  Valid placeholders for the Go template are
       listed below:

       +---------------------+--------------------------------+
       | Placeholder	     | Description		      |
       +---------------------+--------------------------------+
       | .CPUs		     | Number of CPUs		      |
       +---------------------+--------------------------------+
       | .Created	     | Time since VM creation	      |
       +---------------------+--------------------------------+
       | .Default	     | Is default machine	      |
       +---------------------+--------------------------------+
       | .DiskSize	     | Disk size of machine	      |
       +---------------------+--------------------------------+
       | .IdentityPath	     | Path to ssh identity file      |
       +---------------------+--------------------------------+
       | .LastUp	     | Time since the VM was last run |
       +---------------------+--------------------------------+
       | .Memory	     | Allocated memory	for machine   |
       +---------------------+--------------------------------+
       | .Name		     | VM name			      |
       +---------------------+--------------------------------+
       | .Port		     | SSH Port	to use to connect  to |
       |		     | VM			      |
       +---------------------+--------------------------------+
       | .RemoteUsername     | VM  Username for	rootless Pod- |
       |		     | man			      |
       +---------------------+--------------------------------+
       | .Running	     | Is machine running	      |
       +---------------------+--------------------------------+
       | .Stream	     | Stream name		      |
       +---------------------+--------------------------------+
       | .UserModeNetworking | Whether machine uses user-mode |
       |		     | networking		      |
       +---------------------+--------------------------------+
       | .VMType	     | VM type			      |
       +---------------------+--------------------------------+

   --help
       Print usage statement.

   --noheading,	-n
       Omit the	table headings from the	listing.

   --quiet, -q
       Only print the name of the machine. This	also implies no	table  heading
       is printed.

EXAMPLES
       List all	Podman machines.

       $ podman	machine	list
       NAME		       VM TYPE	   CREATED	LAST UP	     CPUS	 MEMORY	     DISK SIZE
       podman-machine-default  qemu	   2 weeks ago	2 weeks	ago  1		 2.147GB     10.74GB

       List all	Podman machines	using the specified table format.

       $ podman	machine	ls --format "table {{.Name}}\t{{.VMType}}\t{{.Created}}\t{{.LastUp}}"
       NAME		       VM TYPE	   CREATED	LAST UP
       podman-machine-default  qemu	   2 weeks ago	2 weeks	ago

       List all	Podman machines	in json	format.

       $ podman	machine	ls --format json
       [
	   {
	       "Name": "podman-machine-default",
	       "Default": false,
	       "Created": "2021-12-27T10:36:14.373347492-05:00",
	       "Running": false,
	       "LastUp": "2021-12-27T11:22:50.17333371-05:00",
	       "Stream": "default",
	       "VMType": "qemu",
	       "CPUs": 1,
	       "Memory": "2147483648",
	       "DiskSize": "10737418240"
	   }
       ]

SEE ALSO
       podman(1), podman-machine(1)

HISTORY
       March   2021,   Originally   compiled  by  Ashley  Cui  acui@redhat.com
       <mailto:acui@redhat.com>

							podman-machine-list(1)

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

home | help