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
|
(projects-create)=
# How to create and configure projects
You can configure projects at creation time or later.
However, note that it is not possible to modify the features that are enabled for a project when the project contains instances.
## Create a project
To create a project, use the [`incus project create`](incus_project_create.md) command.
For example, to create a project called `my-project`, enter the following command:
incus project create my-project
You can specify configuration options by using the `--config` flag.
See {ref}`ref-projects` for the available configuration options.
For example, to create a project called `my-project-shared-images` that isolates instances but allows access to the default project's images, enter the following command:
incus project create my-project-shared-images --config features.images=false
To create a project called `my-restricted-project` that blocks access to security-sensitive features (for example, container nesting) but allows backups, enter the following command:
incus project create my-restricted-project --config restricted=true --config restricted.backups=allow
```{tip}
When you create a project without specifying configuration options, {config:option}`project-features:features.profiles` is set to `true`, which means that profiles are isolated in the project.
Consequently, the new project does not have access to the `default` profile of the `default` project and therefore misses required configuration for creating instances (like the root disk).
To fix this, use the [`incus profile device add`](incus_profile_device_add.md) command to add a root disk device to the project's `default` profile.
```
(projects-configure)=
## Configure a project
To configure a project, you can either set a specific configuration option or edit the full project.
Some configuration options can only be set for projects that do not contain any instances.
### Set specific configuration options
To set a specific configuration option, use the [`incus project set`](incus_project_set.md) command.
For example, to limit the number of containers that can be created in `my-project` to five, enter the following command:
incus project set my-project limits.containers=5
To unset a specific configuration option, use the [`incus project unset`](incus_project_unset.md) command.
```{note}
If you unset a configuration option, it is set to its default value.
This default value might differ from the initial value that is set when the project is created.
```
### Edit the project
To edit the full project configuration, use the [`incus project edit`](incus_project_edit.md) command.
For example:
incus project edit my-project
|
