This file has been truncated. show original
# Storage configuration
LXD supports creating and managing storage pools and storage volumes.
General keys are top-level. Driver specific keys are namespaced by driver name.
Volume keys apply to any volume created in the pool unless the value is
overridden on a per-volume basis.
## Storage pool configuration
Key | Type | Condition | Default | API Extension | Description
:-- | :--- | :-------- | :------ | :------------ | :----------
size | string | appropriate driver and source | 0 | storage | Size of the storage pool in bytes (suffixes supported). (Currently valid for loop based pools and zfs.)
source | string | - | - | storage | Path to block device or loop file or filesystem entry
btrfs.mount\_options | string | btrfs driver | user\_subvol\_rm\_allowed | storage\_btrfs\_mount\_options | Mount options for block devices
ceph.cluster\_name | string | ceph driver | ceph | storage\_driver\_ceph | Name of the ceph cluster in which to create new storage pools.
ceph.osd.force\_reuse | bool | ceph driver | false | storage\_ceph\_force\_osd\_reuse | Force using an osd storage pool that is already in use by another LXD instance.
ceph.osd.pg\_num | string | ceph driver | 32 | storage\_driver\_ceph | Number of placement groups for the osd storage pool.
ceph.osd.pool\_name | string | ceph driver | name of the pool | storage\_driver\_ceph | Name of the osd storage pool.
ceph.rbd.clone\_copy | string | ceph driver | true | storage\_driver\_ceph | Whether to use RBD lightweight clones rather than full dataset copies.
ceph.user.name | string | ceph driver | admin | storage\_ceph\_user\_name | The ceph user to use when creating storage pools and volumes.
lvm.thinpool\_name | string | lvm driver | LXDThinPool | storage | Thin pool where images and containers are created.
lvm.use\_thinpool | bool | lvm driver | true | storage\_lvm\_use\_thinpool | Whether the storage pool uses a thinpool for logical volumes.