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)