> ## Documentation Index
> Fetch the complete documentation index at: https://docs.siderolabs.com/llms.txt
> Use this file to discover all available pages before exploring further.

> ExternalVolumeConfig is an external disk mount configuration document. External volumes allow to mount volumes that were created outside of Talos, over the network or API. Volume will be mounted under `/var/mnt/<name>`. The external volume config name should not conflict with user volume names.

# ExternalVolumeConfig

```yaml theme={null}
apiVersion: v1alpha1
kind: ExternalVolumeConfig
name: mount1 # Name of the mount.
filesystemType: virtiofs # Filesystem type.
# The mount describes additional mount options.
mount:
    # Virtiofs mount options.
    virtiofs:
        tag: Data # Selector tag for the Virtiofs mount.
```

<table>
  <thead>
    <tr>
      <th>Field</th>
      <th>Type</th>
      <th>Description</th>
      <th>Value(s)</th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>`name`</td>
      <td>string</td>
      <td>Name of the mount.<br /><br />Name might be between 1 and 34 characters long and can only contain:<br />lowercase and uppercase ASCII letters, digits, and hyphens.</td>

      <td />
    </tr>

    <tr>
      <td>`filesystemType`</td>
      <td>FilesystemType</td>
      <td>Filesystem type.</td>
      <td>`virtiofs`<br /></td>
    </tr>

    <tr>
      <td>`mount`</td>
      <td><a href="#mount">ExternalMountSpec</a></td>
      <td>The mount describes additional mount options.</td>

      <td />
    </tr>
  </tbody>
</table>

## mount

ExternalMountSpec describes how the external volume is mounted.

<table>
  <thead>
    <tr>
      <th>Field</th>
      <th>Type</th>
      <th>Description</th>
      <th>Value(s)</th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>`readOnly`</td>
      <td>bool</td>
      <td>Mount the volume read-only.</td>

      <td />
    </tr>

    <tr>
      <td>`disableAccessTime`</td>
      <td>bool</td>
      <td>If true, disable file access time updates.</td>

      <td />
    </tr>

    <tr>
      <td>`secure`</td>
      <td>bool</td>
      <td>Enable secure mount options (nosuid, nodev).<br /><br />Defaults to true for better security.</td>

      <td />
    </tr>

    <tr>
      <td>`virtiofs`</td>
      <td><a href="#virtiofs">VirtiofsMountSpec</a></td>
      <td>Virtiofs mount options.</td>

      <td />
    </tr>
  </tbody>
</table>

### virtiofs

VirtiofsMountSpec describes Virtiofs mount options.

<table>
  <thead>
    <tr>
      <th>Field</th>
      <th>Type</th>
      <th>Description</th>
      <th>Value(s)</th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>`tag`</td>
      <td>string</td>
      <td>Selector tag for the Virtiofs mount.</td>

      <td />
    </tr>
  </tbody>
</table>