podman-machine-inspect(1)   General Commands Manual  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
       <mailto:bbaude@redhat.com>

                                                     podman-machine-inspect(1)