1podman-machine-ls(1)() podman-machine-ls(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 requires a virtual machine. This is because containers
21 are Linux - containers do not run on any other OS because containers'
22 core functionality is tied to the Linux kernel.
23
24
26 --format=format
27 Change the default output format. This can be of a supported type like
28 'json' or a Go template. Valid placeholders for the Go template are
29 listed below:
30
31
32 ┌────────────────┬────────────────────────────────┐
33 │Placeholder │ Description │
34 ├────────────────┼────────────────────────────────┤
35 │.CPUs │ Number of CPUs │
36 ├────────────────┼────────────────────────────────┤
37 │.Created │ Time since VM creation │
38 ├────────────────┼────────────────────────────────┤
39 │.Default │ Is default machine │
40 ├────────────────┼────────────────────────────────┤
41 │.DiskSize │ Disk size of machine │
42 ├────────────────┼────────────────────────────────┤
43 │.LastUp │ Time machine was last up │
44 ├────────────────┼────────────────────────────────┤
45 │.LastUp │ Time since the VM was last run │
46 ├────────────────┼────────────────────────────────┤
47 │.Memory │ Allocated memory for machine │
48 ├────────────────┼────────────────────────────────┤
49 │.Name │ VM name │
50 ├────────────────┼────────────────────────────────┤
51 │.Running │ Is machine running │
52 ├────────────────┼────────────────────────────────┤
53 │.Stream │ Stream name │
54 ├────────────────┼────────────────────────────────┤
55 │.VMType │ VM type │
56 ├────────────────┼────────────────────────────────┤
57 │.Port │ SSH Port to use to connect to │
58 │ │ VM │
59 ├────────────────┼────────────────────────────────┤
60 │.RemoteUsername │ VM Username for rootless Pod‐ │
61 │ │ man │
62 ├────────────────┼────────────────────────────────┤
63 │.IdentityPath │ Path to ssh identity file │
64 └────────────────┴────────────────────────────────┘
65
66 --help
67 Print usage statement.
68
69
70 --noheading
71 Omit the table headings from the listing of machines
72
73
74 --quiet, -q
75 Only print the name of the machine. This also implies no table heading
76 is printed.
77
78
80 $ podman machine list
81 NAME VM TYPE CREATED LAST UP CPUS MEMORY DISK SIZE
82 podman-machine-default qemu 2 weeks ago 2 weeks ago 1 2.147GB 10.74GB
83
84 $ podman machine ls --format "table {{.Name}}\t{{.VMType}}\t{{.Created}}\t{{.LastUp}}"
85 NAME VM TYPE CREATED LAST UP
86 podman-machine-default qemu 2 weeks ago 2 weeks ago
87
88 $ podman machine ls --format json
89 [
90 {
91 "Name": "podman-machine-default",
92 "Default": false,
93 "Created": "2021-12-27T10:36:14.373347492-05:00",
94 "Running": false,
95 "LastUp": "2021-12-27T11:22:50.17333371-05:00",
96 "Stream": "default",
97 "VMType": "qemu",
98 "CPUs": 1,
99 "Memory": "2147483648",
100 "DiskSize": "10737418240"
101 }
102 ]
103
104
105
107 podman(1), podman-machine(1)
108
109
111 March 2021, Originally compiled by Ashley Cui acui@redhat.com
112 ⟨mailto:acui@redhat.com⟩
113
114
115
116 podman-machine-ls(1)()