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       │.IdentityPath       │ Path to ssh identity file      │
55       ├────────────────────┼────────────────────────────────┤
56       │.LastUp             │ Time since the VM was last run │
57       ├────────────────────┼────────────────────────────────┤
58       │.Memory             │ Allocated memory for machine   │
59       ├────────────────────┼────────────────────────────────┤
60       │.Name               │ VM name                        │
61       ├────────────────────┼────────────────────────────────┤
62       │.Port               │ SSH Port to use to connect  to │
63       │                    │ VM                             │
64       ├────────────────────┼────────────────────────────────┤
65       │.RemoteUsername     │ VM  Username for rootless Pod‐ │
66       │                    │ man                            │
67       ├────────────────────┼────────────────────────────────┤
68       │.Running            │ Is machine running             │
69       ├────────────────────┼────────────────────────────────┤
70       │.Stream             │ Stream name                    │
71       ├────────────────────┼────────────────────────────────┤
72       │.UserModeNetworking │ Whether machine uses user-mode │
73       │                    │ networking                     │
74       ├────────────────────┼────────────────────────────────┤
75       │.VMType             │ VM type                        │
76       └────────────────────┴────────────────────────────────┘
77
78   --help
79       Print usage statement.
80
81
82   --noheading, -n
83       Omit the table headings from the listing.
84
85
86   --quiet, -q
87       Only  print the name of the machine. This also implies no table heading
88       is printed.
89
90

EXAMPLES

92       $ podman machine list
93       NAME                    VM TYPE     CREATED      LAST UP      CPUS        MEMORY      DISK SIZE
94       podman-machine-default  qemu        2 weeks ago  2 weeks ago  1           2.147GB     10.74GB
95
96       $ podman machine ls --format "table {{.Name}}\t{{.VMType}}\t{{.Created}}\t{{.LastUp}}"
97       NAME                    VM TYPE     CREATED      LAST UP
98       podman-machine-default  qemu        2 weeks ago  2 weeks ago
99
100       $ podman machine ls --format json
101       [
102           {
103               "Name": "podman-machine-default",
104               "Default": false,
105               "Created": "2021-12-27T10:36:14.373347492-05:00",
106               "Running": false,
107               "LastUp": "2021-12-27T11:22:50.17333371-05:00",
108               "Stream": "default",
109               "VMType": "qemu",
110               "CPUs": 1,
111               "Memory": "2147483648",
112               "DiskSize": "10737418240"
113           }
114       ]
115
116
117

SEE ALSO

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

HISTORY

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