The instance configuration consists of different categories:
- Instance properties
Instance properties are specified when the instance is created. They include, for example, the instance name and architecture. Some of the properties are read-only and cannot be changed after creation, while others can be updated by setting their property value or editing the full instance configuration.
In the YAML configuration, properties are on the top level.
See Instance properties for a reference of available instance properties.
- Instance options
Instance options are configuration options that are related directly to the instance. They include, for example, startup options, security settings, hardware limits, kernel modules, snapshots and user keys. These options can be specified as key/value pairs during instance creation (through the
--config key=valueflag). After creation, they can be configured with the
incus config setand
incus config unsetcommands.
In the YAML configuration, options are located under the
- Instance devices
Instance devices are attached to an instance. They include, for example, network interfaces, mount points, USB and GPU devices. Devices are usually added after an instance is created with the
incus config device addcommand, but they can also be added to a profile or a YAML configuration file that is used to create an instance.
Each type of device has its own specific set of options, referred to as instance device options.
In the YAML configuration, devices are located under the