1podman-machine-list(1) General Commands Manual podman-machine-list(1)
2
3
4
6 podman-machine-list - List virtual machines
7
8
10 podman machine list [options]
11
12
13 podman machine ls [options]
14
15
17 List Podman managed virtual machines.
18
19
20 Podman on MacOS and Windows requires a virtual machine. This is because
21 containers are Linux - containers do not run on any other OS because
22 containers' core functionality are tied to the Linux kernel. Podman ma‐
23 chine must be used to manage MacOS and Windows machines, but can be op‐
24 tionally used on Linux.
25
26
27 Rootless only.
28
29
30 NOTE: The podman-machine configuration file is managed under the
31 $XDG_CONFIG_HOME/containers/podman/machine/ directory. Changing the
32 $XDG_CONFIG_HOME environment variable while the machines are running
33 can lead to unexpected behavior. (see podman(1))
34
35
37 --format=format
38 Change the default output format. This can be of a supported type like
39 'json' or a Go template. Valid placeholders for the Go template are
40 listed below:
41
42
43 ┌────────────────┬────────────────────────────────┐
44 │Placeholder │ Description │
45 ├────────────────┼────────────────────────────────┤
46 │.CPUs │ Number of CPUs │
47 ├────────────────┼────────────────────────────────┤
48 │.Created │ Time since VM creation │
49 ├────────────────┼────────────────────────────────┤
50 │.Default │ Is default machine │
51 ├────────────────┼────────────────────────────────┤
52 │.DiskSize │ Disk size of machine │
53 ├────────────────┼────────────────────────────────┤
54 │.LastUp │ Time machine was last up │
55 ├────────────────┼────────────────────────────────┤
56 │.LastUp │ Time since the VM was last run │
57 ├────────────────┼────────────────────────────────┤
58 │.Memory │ Allocated memory for machine │
59 ├────────────────┼────────────────────────────────┤
60 │.Name │ VM name │
61 ├────────────────┼────────────────────────────────┤
62 │.Running │ Is machine running │
63 ├────────────────┼────────────────────────────────┤
64 │.Stream │ Stream name │
65 ├────────────────┼────────────────────────────────┤
66 │.VMType │ VM type │
67 ├────────────────┼────────────────────────────────┤
68 │.Port │ SSH Port to use to connect to │
69 │ │ VM │
70 ├────────────────┼────────────────────────────────┤
71 │.RemoteUsername │ VM Username for rootless Pod‐ │
72 │ │ man │
73 ├────────────────┼────────────────────────────────┤
74 │.IdentityPath │ Path to ssh identity file │
75 └────────────────┴────────────────────────────────┘
76
77 --help
78 Print usage statement.
79
80
81 --noheading
82 Omit the table headings from the listing of machines
83
84
85 --quiet, -q
86 Only print the name of the machine. This also implies no table heading
87 is printed.
88
89
91 $ podman machine list
92 NAME VM TYPE CREATED LAST UP CPUS MEMORY DISK SIZE
93 podman-machine-default qemu 2 weeks ago 2 weeks ago 1 2.147GB 10.74GB
94
95 $ podman machine ls --format "table {{.Name}}\t{{.VMType}}\t{{.Created}}\t{{.LastUp}}"
96 NAME VM TYPE CREATED LAST UP
97 podman-machine-default qemu 2 weeks ago 2 weeks ago
98
99 $ podman machine ls --format json
100 [
101 {
102 "Name": "podman-machine-default",
103 "Default": false,
104 "Created": "2021-12-27T10:36:14.373347492-05:00",
105 "Running": false,
106 "LastUp": "2021-12-27T11:22:50.17333371-05:00",
107 "Stream": "default",
108 "VMType": "qemu",
109 "CPUs": 1,
110 "Memory": "2147483648",
111 "DiskSize": "10737418240"
112 }
113 ]
114
115
116
118 podman(1), podman-machine(1)
119
120
122 March 2021, Originally compiled by Ashley Cui acui@redhat.com
123 ⟨mailto:acui@redhat.com⟩
124
125
126
127 podman-machine-list(1)