podman-machine-inspect(1)

✨ podman-machine-inspect(1) ✨

okay bestie, welcome to the General Commands Manual entry for podman-machine-inspect — yes, the one and only. sit down, hydrate, and let's get into it 💖

---

🌸 NAME 🌸

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

---

🦋 SYNOPSIS 🦋

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

---

💅 DESCRIPTION 💅

Inspect one or more virtual machines.

Like, you want the greater detail tea on your Podman virtual machines? This is the command. And the best part? You can inspect more than one virtual machine at once — no need to run it a million times, we're not doing that to ourselves 🙈

The default machine name is podman-machine-default. So if you don't pass a machine name as an argument, podman-machine-default is what gets inspected. no cap.

Rootless only. that's the vibe check, don't fight it.

---

🎀 OPTIONS 🎀

💖 --format

Print results with a Go template. (Yes queen, Go templates. We're fancy now 👑)

Here's every placeholder you can reach for, and what each one gives you:

• .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. the classic. 🫶

---

✨ 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)

go read those too, iykyk 📚

---

👑 HISTORY 👑

April 2022, Originally compiled by Brent Baude bbaude@redhat.com ⟨mailto:bbaude@redhat.com⟩

---

and that's the whole page bestie, we ate and left no crumbs 💅✨ this was podman-machine-inspect(1) straight outta the General Commands Manual — sending you love from your favorite manpage 🎀🦋💖