podman-machine-list - List virtual machines
Contents
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))
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"
}
]
History
March 2021, Originally compiled by Ashley Cui acui@redhat.com ⟨mailto:acui@redhat.com⟩
podman-machine-list(1)
Name
podman-machine-list - List virtual machines
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 │ NumberofCPUs │
├─────────────────────┼───────────────────────────────────────┤
│ .Created │ TimesinceVMcreation │
├─────────────────────┼───────────────────────────────────────┤
│ .Default │ Isdefaultmachine │
├─────────────────────┼───────────────────────────────────────┤
│ .DiskSize │ Disksizeofmachine │
├─────────────────────┼───────────────────────────────────────┤
│ .IdentityPath │ Pathtosshidentityfile │
├─────────────────────┼───────────────────────────────────────┤
│ .LastUp │ TimesincetheVMwaslastrun │
├─────────────────────┼───────────────────────────────────────┤
│ .Memory │ Allocatedmemoryformachine │
├─────────────────────┼───────────────────────────────────────┤
│ .Name │ VMname │
├─────────────────────┼───────────────────────────────────────┤
│ .Port │ SSH Port to use to connect to VM │
├─────────────────────┼───────────────────────────────────────┤
│ .RemoteUsername │ VM Username for rootless Podman │
├─────────────────────┼───────────────────────────────────────┤
│ .Running │ Ismachinerunning │
├─────────────────────┼───────────────────────────────────────┤
│ .Stream │ Streamname │
├─────────────────────┼───────────────────────────────────────┤
│ .UserModeNetworking │ Whether machine uses user-mode │
│ │ networking │
├─────────────────────┼───────────────────────────────────────┤
│ .VMType │ VMtype │
└─────────────────────┴───────────────────────────────────────┘
--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.
See Also
podman(1), podman-machine(1)
Synopsis
podmanmachinelist [options]
podmanmachinels [options]
