podman/docs/source/markdown/podman-machine-inspect.1.md

% podman-machine-inspect 1

NAME

podman-machine-inspect - Inspect one or more virtual machines

SYNOPSIS

podman machine inspect [options] [name] ...

DESCRIPTION

Inspect one or more virtual machines

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

The default machine name is podman-machine-default. If a machine name is not specified as an argument, then podman-machine-default will be inspected.

Rootless only.

OPTIONS

--format

Print results with a Go template.

Placeholder	Description
.ConfigDir ...	Machine configuration directory location
.ConnectionInfo ...	Machine connection information
.Created ...	Machine creation time (string, ISO3601)
.LastUp ...	Time when machine was last booted
.Name	Name of the machine
.Resources ...	Resources used by the machine
.Rootful	Whether the machine prefers rootful or rootless container execution
.Rosetta	Whether this machine uses Rosetta
.SSHConfig ...	SSH configuration info for communicating with machine
.State	Machine state
.UserModeNetworking	Whether this machine uses user-mode networking

--help

Print usage statement.

EXAMPLES

Inspect the specified Podman machine.

$ 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
     }
]

Show machine name and state:

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

Show machine resource information:

$ 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

Show machine configuration details:

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

Show machine uptime information:

$ 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

Show connection information:

$ 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>}

SEE ALSO

podman(1), podman-machine(1)

HISTORY

April 2022, Originally compiled by Brent Baude bbaude@redhat.com