1podman-machine-list(1)      General Commands Manual     podman-machine-list(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 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

OPTIONS

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

EXAMPLES

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

SEE ALSO

118       podman(1), podman-machine(1)
119
120

HISTORY

122       March   2021,   Originally   compiled  by  Ashley  Cui  acui@redhat.com
123       ⟨mailto:acui@redhat.com⟩
124
125
126
127                                                        podman-machine-list(1)