logo
Free, unlimited AI code reviews that run on commit
git-lrc git-lrc GitHub Install Now We'd appreciate a star git-lrc - Free, unlimited AI code reviews that run on commit | Product Hunt git-lrc - Free, unlimited AI code reviews that run on commit | Product Hunt

podman-machine-list - List virtual machines

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 containers' 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_CONFIG_HOME/containers/podman/machine/ directory. Changing the $XDG_CONFIG_HOME environment variable
       while the machines are running can lead to unexpected behavior.  (see podman(1))

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"
           }
       ]

History

       March 2021, Originally compiled by Ashley Cui acui@redhat.commailto:acui@redhat.compodman-machine-list(1)

Name

       podman-machine-list - List virtual machines

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:

       ┌─────────────────────┬───────────────────────────────────────┐
       │ PlaceholderDescription                           │
       ├─────────────────────┼───────────────────────────────────────┤
       │ .CPUsNumberofCPUs                        │
       ├─────────────────────┼───────────────────────────────────────┤
       │ .CreatedTimesinceVMcreation                │
       ├─────────────────────┼───────────────────────────────────────┤
       │ .DefaultIsdefaultmachine                    │
       ├─────────────────────┼───────────────────────────────────────┤
       │ .DiskSizeDisksizeofmachine                  │
       ├─────────────────────┼───────────────────────────────────────┤
       │ .IdentityPathPathtosshidentityfile             │
       ├─────────────────────┼───────────────────────────────────────┤
       │ .LastUpTimesincetheVMwaslastrun        │
       ├─────────────────────┼───────────────────────────────────────┤
       │ .MemoryAllocatedmemoryformachine          │
       ├─────────────────────┼───────────────────────────────────────┤
       │ .NameVMname                               │
       ├─────────────────────┼───────────────────────────────────────┤
       │ .Port               │ SSH Port to use to connect to VM      │
       ├─────────────────────┼───────────────────────────────────────┤
       │ .RemoteUsername     │ VM Username for rootless Podman       │
       ├─────────────────────┼───────────────────────────────────────┤
       │ .RunningIsmachinerunning                    │
       ├─────────────────────┼───────────────────────────────────────┤
       │ .StreamStreamname                           │
       ├─────────────────────┼───────────────────────────────────────┤
       │ .UserModeNetworking │ Whether   machine   uses    user-mode │
       │                     │ networking                            │
       ├─────────────────────┼───────────────────────────────────────┤
       │ .VMTypeVMtype                               │
       └─────────────────────┴───────────────────────────────────────┘

   --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.

See Also

podman(1), podman-machine(1)

Synopsis

podmanmachinelist [options]

       podmanmachinels [options]

See Also