FreeBSD Manual Pages
podman-machine-list(1) General Commands Manual podman-machine-list(1) NAME podman-machine-list - List virtual machines SYNOPSIS podman machine list [options] podman machine ls [options] DESCRIPTION List Podman managed virtual machines. Podman on MacOS and Windows requires a virtual machine. This is because containers are Linux - containers do not run on any other OS because con- tainers' core functionality are tied to the Linux kernel. Podman machine must be used to manage MacOS and Windows machines, but can be optionally used on Linux. Rootless only. NOTE: The podman-machine configuration file is managed under the $XDG_CON- FIG_HOME/containers/podman/machine/ directory. Changing the $XDG_CON- FIG_HOME environment variable while the machines are running can lead to unexpected behavior. (see podman(1)) OPTIONS --all-providers Show machines from all providers --format=format Change the default output format. This can be of a supported type like 'json' or a Go template. Valid placeholders for the Go template are listed below: +---------------------+--------------------------------+ | Placeholder | Description | +---------------------+--------------------------------+ | .CPUs | Number of CPUs | +---------------------+--------------------------------+ | .Created | Time since VM creation | +---------------------+--------------------------------+ | .Default | Is default machine | +---------------------+--------------------------------+ | .DiskSize | Disk size of machine | +---------------------+--------------------------------+ | .IdentityPath | Path to ssh identity file | +---------------------+--------------------------------+ | .LastUp | Time since the VM was last run | +---------------------+--------------------------------+ | .Memory | Allocated memory for machine | +---------------------+--------------------------------+ | .Name | VM name | +---------------------+--------------------------------+ | .Port | SSH Port to use to connect to | | | VM | +---------------------+--------------------------------+ | .RemoteUsername | VM Username for rootless Pod- | | | man | +---------------------+--------------------------------+ | .Running | Is machine running | +---------------------+--------------------------------+ | .Stream | Stream name | +---------------------+--------------------------------+ | .Swap | Allocated swap for machine | +---------------------+--------------------------------+ | .UserModeNetworking | Whether machine uses user-mode | | | networking | +---------------------+--------------------------------+ | .VMType | VM type | +---------------------+--------------------------------+ --help Print usage statement. --noheading, -n Omit the table headings from the listing. --quiet, -q Only print the name of the machine. This also implies no table heading is printed. EXAMPLES List all Podman machines. $ podman machine list NAME VM TYPE CREATED LAST UP CPUS MEMORY DISK SIZE podman-machine-default qemu 2 weeks ago 2 weeks ago 1 2.147GB 10.74GB List all Podman machines using the specified table format. $ podman machine ls --format "table {{.Name}}\t{{.VMType}}\t{{.Created}}\t{{.LastUp}}" NAME VM TYPE CREATED LAST UP podman-machine-default qemu 2 weeks ago 2 weeks ago List all Podman machines in json format. $ podman machine ls --format json [ { "Name": "podman-machine-default", "Default": false, "Created": "2021-12-27T10:36:14.373347492-05:00", "Running": false, "LastUp": "2021-12-27T11:22:50.17333371-05:00", "Stream": "default", "VMType": "qemu", "CPUs": 1, "Memory": "2147483648", "DiskSize": "10737418240" } ] SEE ALSO podman(1), podman-machine(1) HISTORY March 2021, Originally compiled by Ashley Cui acui@redhat.com <mailto:acui@redhat.com> podman-machine-list(1)
NAME | SYNOPSIS | DESCRIPTION | OPTIONS | EXAMPLES | SEE ALSO | HISTORY
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=podman-machine-list&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>