(reference-settings-local-instance-name-disk)=

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.