podman-machine-ls

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 machine must be used to manage MacOS and Windows machines, but can be optionally 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 Podman           
   
    .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)