`multipass info` command

The multipass info command shows properties of the instances given as arguments, or all of the created ones if --all is given:

$ multipass info calm-squirrel
Name:           calm-squirrel
State:          RUNNING
IPv4:           10.218.69.109
Release:        Ubuntu 16.04.6 LTS
Image hash:     485bf889ca70 (Ubuntu 16.04 LTS)
CPU(s):         1
Load:           0.49, 0.70, 0.71
Disk usage:     849.4M out of 4.8G
Memory usage:   41.9M out of 992.0M
Mounts:         /home/user => Home
                    UID map: 1000:default
                    GID map: 1001:default
                /home/user/multipass => mp
                    UID map: 1000:default
                    GID map: 1001:default

The entries have the following meaning:

  • Name: Simply the name of the instance which the information pertains to.
  • State: The current state of the instance, as described here.
  • IPv4: A list of IPs through which a machine on the same network as the instance can reach the instance. Adding IP addresses besides the one automatically generated by Multipass is described here.
  • Release: The release title of the image installed on this instance.
  • Image hash: The SHA-256 hash of the aforementioned image. This can be used to verify the validity of the image.
  • CPU(s): The number of cores that the instance can use, as defined by the --cpus option of the launch command or as modified by the local.<instance-name>.cpus key of the set command. Depending on the used driver, this value can exceed the number of cpus on the host machine.
  • Load: A triplet of values describing the average number of processes running on the CPU or in queue waiting for CPU time, sampled over the last 1 minute, 5 minutes and 15 minutes respectively. The values are normalized to the number of CPU cores, so for a machine with N cores, a load average of N indicates that the CPU is utilized at maximum capacity over the respective time interval, while a value below or above N indicates that the CPU is either under-utilized or over-utilized.
  • Disk usage: The amount of disk used by the instance. The total amount is as defined by the --disk option of the launch command or as modified by the local.<instance-name>.disk key of the set command. Depending on the used driver, the total value can exceed the amount of memory available on the host machine, but the used value cannot.
  • Memory usage: The amount of memory used by the instance. The total amount is as defined by the --memory option of the launch command or as modified by the local.<instance-name>.memory key of the set command. Depending on the used driver, the total value can exceed the amount of memory available on the host machine, but the used value cannot.
  • Mounts: A list of directories from the host machine that are accessible through their respective directories from inside the instance. Each directory mapping has a list of uid and gid mappings, representing how the ownership of their respective host directories is translated the ownership of their respective instance directories. More about mounts can be found here.

The full multipass help info output explains the available options:

$ multipass help info         
Usage: multipass info [options] [<name> ...]
Display information about instances

Options:
  -h, --help         Display this help
  -v, --verbose      Increase logging verbosity, repeat up to three times for
                     more detail
  --all              Display info for all instances
  --format <format>  Output info in the requested format.
                     Valid formats are: table (default), json, csv and yaml

Arguments:
  name               Names of instances to display information about

Similar to the list command, the only option is --format, which allows you to choose how the data is presented - a human-readable table or one of JSON, CSV and YAML, for example:

$ multipass info --format yaml calm-squirrel
errors:
  - ~
calm-squirrel:
  - state: RUNNING
    image_hash: 485bf889ca70f877511705b9b82b1ab7866718128c3312549e0b6ce11bb14b20
    image_release: 16.04 LTS
    release: Ubuntu 16.04.6 LTS
    cpu_count: 1
    load:
      - 0
      - 0.01
      - 0
    disks:
      - sda1:
          used: 905637888
          total: 5136297984
    memory:
      usage: 31199232
      total: 1040195584
    ipv4:
      - 10.218.69.109
    mounts: ~

At least on Win10 I think the list command should display the local path to the virtual disk image file. I’d like to know where the file is located so I can move it to my RAID drive (I’m betting it is somewhere on my limited system C drive).

Hi @rockylhotka, there’s an issue about this in our GitHub, we’ll be working on making the data relocatable.