`local.<instance-name>.disk`

See also: get, set, launch

Key

local.<instance-name>.disk

where <instance-name> is the name of a Multipass instance.

Description

The size of the instance’s disk.

The disk size can only be increased.
Decreasing the disk size is not permitted since it could cause data loss and the VM might break.

Allowed values

A size no smaller than the current disk size. This size can be specified with a positive integer or decimal number, optionally followed by a unit. Any case variations of the following suffixes are accepted as units:

  • B, to designate one byte.
  • KiB, KB, or K, to designate 1024 bytes.
  • MiB, MB, or M, to designate 1024 x 1024 = 1048576 bytes
  • GiB, GB, or G, to designate 1024 x 1024 x 1024 = 1073741824 bytes

Decimal bytes (e.g. 1.1B) are refused, unless specified with larger units (>= KiB), in which case the amount is floored (e.g. 1.2KiB is interpreted as 1228B, even though 1.2 x 1024 = 1228.8).

Examples

multipass set local.handsome-ling.disk=7.5G

Default value

The size of the disk that the instance was launched with.


Errors or typos? Topics missing? Hard to read? Let us know or open an issue on GitHub.

Just reporting a minor typo on the nav bar. The left navigation bar has two entries for local.<instance-name>.memory, where the first one correctly links to this disk documentation page.
Thank you for this great tool!
Nav bar screenshot

1 Like

Well spotted @maubuz, thanks!

1 Like

Thank you @maubuz , fixed!

1 Like