Skip to main content

Your submission was sent successfully! Close

Thank you for signing up for our newsletter!
In these regular emails you will find the latest updates from Canonical and upcoming events where you can meet our team.Close

Thank you for contacting us. A member of our team will be in touch shortly. Close

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

Last updated 2 months ago. Help improve this document in the forum.