1podman-machine-ls(1)()                                  podman-machine-ls(1)()
2
3
4

NAME

6       podman-machine-list - List virtual machines
7
8

SYNOPSIS

10       podman machine list [options]
11
12
13       podman machine ls [options]
14
15

DESCRIPTION

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

OPTIONS

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

EXAMPLES

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

SEE ALSO

107       podman(1), podman-machine(1)
108
109

HISTORY

111       March  2021,  Originally  compiled  by   Ashley   Cui   acui@redhat.com
112       ⟨mailto:acui@redhat.com⟩
113
114
115
116                                                        podman-machine-ls(1)()