1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
|
(profiles)=
# How to use profiles
Profiles store a set of configuration options.
They can contain instance options, devices and device options.
You can apply any number of profiles to an instance.
They are applied in the order they are specified, so the last profile to specify a specific key takes precedence.
However, instance-specific configuration always overrides the configuration coming from the profiles.
```{note}
Profiles can be applied to containers and virtual machines.
Therefore, they might contain options and devices that are valid for either type.
When applying a profile that contains configuration that is not suitable for the instance type, this configuration is ignored and does not result in an error.
```
If you don't specify any profiles when launching a new instance, the `default` profile is applied automatically.
This profile defines a network interface and a root disk.
The `default` profile cannot be renamed or removed.
## View profiles
Enter the following command to display a list of all available profiles:
incus profile list
Enter the following command to display the contents of a profile:
incus profile show <profile_name>
## Create an empty profile
Enter the following command to create an empty profile:
incus profile create <profile_name>
(profiles-edit)=
## Edit a profile
You can either set specific configuration options for a profile or edit the full profile in YAML format.
### Set specific options for a profile
To set an instance option for a profile, use the [`incus profile set`](incus_profile_set.md) command.
Specify the profile name and the key and value of the instance option:
incus profile set <profile_name> <option_key>=<option_value> <option_key>=<option_value> ...
To add and configure an instance device for your profile, use the [`incus profile device add`](incus_profile_device_add.md) command.
Specify the profile name, a device name, the device type and maybe device options (depending on the {ref}`device type <devices>`):
incus profile device add <profile_name> <device_name> <device_type> <device_option_key>=<device_option_value> <device_option_key>=<device_option_value> ...
To configure instance device options for a device that you have added to the profile earlier, use the [`incus profile device set`](incus_profile_device_set.md) command:
incus profile device set <profile_name> <device_name> <device_option_key>=<device_option_value> <device_option_key>=<device_option_value> ...
### Edit the full profile
Instead of setting each configuration option separately, you can provide all options at once in YAML format.
Check the contents of an existing profile or instance configuration for the required markup.
For example, the `default` profile might look like this:
config: {}
description: Default Incus profile
devices:
eth0:
name: eth0
network: incusbr0
type: nic
root:
path: /
pool: default
type: disk
name: default
used_by:
Instance options are provided as an array under `config`.
Instance devices and instance device options are provided under `devices`.
To edit a profile using your standard terminal editor, enter the following command:
incus profile edit <profile_name>
Alternatively, you can create a YAML file (for example, `profile.yaml`) with the configuration and write the configuration to the profile with the following command:
incus profile edit <profile_name> < profile.yaml
## Apply a profile to an instance
Enter the following command to apply a profile to an instance:
incus profile add <instance_name> <profile_name>
```{tip}
Check the configuration after adding the profile: [`incus config show <instance_name>`](incus_config_show.md)
You will see that your profile is now listed under `profiles`.
However, the configuration options from the profile are not shown under `config` (unless you add the `--expanded` flag).
The reason for this behavior is that these options are taken from the profile and not the configuration of the instance.
This means that if you edit a profile, the changes are automatically applied to all instances that use the profile.
```
You can also specify profiles when launching an instance by adding the `--profile` flag:
incus launch <image> <instance_name> --profile <profile> --profile <profile> ...
## Remove a profile from an instance
Enter the following command to remove a profile from an instance:
incus profile remove <instance_name> <profile_name>
|
