ExistingVolumeConfig

ExistingVolumeConfig is an existing volume configuration document. Existing volumes allow to mount partitions (or whole disks) that were created outside of Talos. Volume will be mounted under /var/mnt/<name>. The existing volume config name should not conflict with user volume names.

apiVersion: v1alpha1
kind: ExistingVolumeConfig
name: my-existing-volume # Name of the volume.
# The discovery describes how to find a volume.
discovery:
    # The volume selector expression.
    volumeSelector:
        match: volume.partition_label == "MY-DATA" # The Common Expression Language (CEL) expression to match the volume.

Field	Type	Description
`name`	string	Name of the volume. Name can only contain: lowercase and uppercase ASCII letters, digits, and hyphens.
`discovery`	VolumeDiscoverySpec	The discovery describes how to find a volume.
`mount`	MountSpec	The mount describes additional mount options.

discovery

VolumeDiscoverySpec describes how the volume is discovered.

Field	Type	Description	Value(s)
`volumeSelector`	VolumeSelector	The volume selector expression.

volumeSelector

VolumeSelector selects an existing volume.

Field	Type	Description	Value(s)
`match`	Expression	The Common Expression Language (CEL) expression to match the volume. Show example(s) `match: volume.partition_label == "MY-DATA"` `match: volume.name == "xfs" && disk.serial == "SERIAL123"`

mount

MountSpec describes how the volume is mounted.

Field	Type	Description	Value(s)
`readOnly`	bool	Mount the volume read-only.

Last modified July 15, 2025: feat: implement ExistingVolumeConfig (cb7ca17bb)