Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help 
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 vir-
       tual 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  direc- |
       |		     | tory 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)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=podman-machine-inspect&sektion=1&manpath=FreeBSD+Ports+15.0.quarterly>

home | help