'\" t
.nh
.TH podman-machine-inspect 1
.SH NAME
podman-machine-inspect \- Inspect one or more virtual machines

.SH SYNOPSIS
\fBpodman machine inspect\fP [\fIoptions\fP] [\fIname\fP] ...

.SH DESCRIPTION
Inspect one or more virtual machines

.PP
Obtain greater detail about Podman virtual machines. More than one virtual machine can be
inspected at once.

.PP
The default machine name is \fBpodman-machine-default\fR\&. If a machine name is not specified as an argument,
then \fBpodman-machine-default\fR will be inspected.

.PP
Rootless only.

.SH OPTIONS
.SS \fB--format\fP
Print results with a Go template.

.TS
allbox;
l l 
l l .
\fB\fBPlaceholder\fP\fP	\fB\fBDescription\fP\fP
\&.ConfigDir ...	T{
Machine configuration directory location
T}
\&.ConnectionInfo ...	Machine connection information
\&.Created ...	T{
Machine creation time (string, ISO3601)
T}
\&.LastUp ...	T{
Time when machine was last booted
T}
\&.Name	Name of the machine
\&.Resources ...	Resources used by the machine
\&.Rootful	T{
Whether the machine prefers rootful or rootless container execution
T}
\&.Rosetta	T{
Whether this machine uses Rosetta
T}
\&.SSHConfig ...	T{
SSH configuration info for communicating with machine
T}
\&.State	Machine state
\&.UserModeNetworking	T{
Whether this machine uses user-mode networking
T}
.TE

.SS \fB--help\fP
Print usage statement.

.SH EXAMPLES
Inspect the specified Podman machine.

.EX
$ podman machine inspect podman-machine-default
[
     {
          "ConfigDir": {
               "Path": "/Users/jacksparrow/.config/containers/podman/machine/applehv"
          },
          "ConnectionInfo": {
               "PodmanSocket": {
                    "Path": "/var/folders/9r/n3056v597wv2cq8s2j80bdnw0000gn/T/podman/podman-machine-default-api.sock"
               },
               "PodmanPipe": null
          },
          "Created": "2025-02-11T14:12:48.231836+05:30",
          "LastUp": "2025-08-12T19:31:19.391294+05:30",
          "Name": "podman-machine-default",
          "Resources": {
               "CPUs": 6,
               "DiskSize": 100,
               "Memory": 6144,
               "USBs": []
          },
          "SSHConfig": {
               "IdentityPath": "/Users/jacksparrow/.local/share/containers/podman/machine/machine",
               "Port": 53298,
               "RemoteUsername": "core"
          },
          "State": "running",
          "UserModeNetworking": true,
          "Rootful": false,
          "Rosetta": true
     }
]
.EE

.PP
Show machine name and state:

.EX
$ podman machine inspect --format "{{.Name}}\\t{{.State}}"
podman-machine-default running
.EE

.PP
Show machine resource information:

.EX
$ podman machine inspect --format "Machine: {{.Name}}\\nCPUs: {{.Resources.CPUs}}\\nMemory: {{.Resources.Memory}} bytes\\nDisk: {{.Resources.DiskSize}} bytes"
Machine: podman-machine-default
CPUs: 6
Memory: 6144 bytes
Disk: 100 bytes
.EE

.PP
Show machine configuration details:

.EX
$ podman machine inspect --format "{{.Name}}: {{.State}} (Rootful: {{.Rootful}}, User Networking: {{.UserModeNetworking}})"
podman-machine-default: running (Rootful: false, User Networking: true)
.EE

.PP
Show machine uptime information:

.EX
$ podman machine inspect --format "Created: {{.Created}}\\nLast Up: {{.LastUp}}\\nState: {{.State}}"
Created: 2025-02-11 14:12:48.231836 +0000 UTC
Last Up: 2025-08-12 19:31:19.391294 +0000 UTC
State: running
.EE

.PP
Show connection information:

.EX
$ podman machine inspect --format "Socket: {{.ConnectionInfo.PodmanSocket}}\\nConfig Dir: {{.ConfigDir}}"
Socket: {/var/folders/9r/n3056v597wv2cq8s2j80bdnw0000gn/T/podman/podman-machine-default-api.sock <nil>}
Config Dir: {/Users/jacksparrow/.config/containers/podman/machine/applehv <nil>}
.EE

.SH SEE ALSO
\fBpodman(1)\fP, \fBpodman-machine(1)\fP

.SH HISTORY
April 2022, Originally compiled by Brent Baude bbaude@redhat.com
\[la]mailto:bbaude@redhat.com\[ra]