Skip to content

Local Volumes#

Local volumes are file systems stored within VergeOS, consuming storage in the VergeOS vSAN. Each local volume can have different sharing, syncing, tiering, and permission settings.

A NAS Service must be in place before creating volumes. See the NAS Service page for instructions. {.is-success}


Create a Local Volume#

  1. From the Main Dashboard, select NAS from the left menu.
  2. Select Volumes from the left menu.
  3. Select New from the left menu.
  4. Select the appropriate NAS Service from the dropdown list.
  5. Enter a Name for the volume (required). Note: spaces are not permitted.
  6. Enter a Description for the volume (optional).
  7. In the Filesystem Type dropdown list, select Local Volume (EXT4).
  8. The Encrypt Volume option can be selected to encrypt the entire volume (AES-XTS).

Encryption Considerations:
- Encryption selection is only available during creation creating; a volume cannot be changed from encrypted to unencrypted or vice-versa after creation.
- Minor to moderate performance implications are involved with enabling volume encryption {.is-info}


  • When encryption is selected, Encryption Key is also required.

The original encryption key (defined when creating the volume) is needed for the lifetime of the volume; this encryption key must be entered each time the volume is brought online (e.g. after disabling/enabling a volume or after its NAS service is rebooted, etc.) Without the encryption key, it will not be possible to bring the volume back online! {.is-warning}

  1. Specify a Max Size for the volume, by entering an integer and selecting the unit (B/KB/MB/GB/TB). (When Max size is reached, the volume will show out of space and will continue to be readable, but will not allow further writes.)
  2. The Discard option is enabled by default. When Discard enabled: as data is deleted from the volume, that space is reclaimed back to the vSAN.
  3. The volume can optionally be set to Read Only.
  4. The Automatically Mount Snapshots option can be selected to make snapshots readily available for browsing/file restores.
  5. Specify Owner for the volume directory (optional).
  6. Specify a Group for volume directory (optional).
  7. Select a Snapshot Profile for the volume (optional). See Snapshot Profiles (Snapshot Scheduling) for information regarding Snapshot Profiles.
  8. Select Preferred Tier for storing this volume. Preferred tier is the tier first attempted. See Preferred Tiers for more information.
  9. Click Submit to save the settings and create the local volume.
  10. The Dashboard for the new local volume is displayed. It may take a few minutes for the new Volume to come online. If the Volume Status does not become Online, refer to the logs section (bottom of Dashboard) to view error messages for troubleshooting.
  11. Files in the online volume can be viewed using the Browse option from the left menu.
  12. To expose the local volume, create CIFS and/or NFS Share(s).


Get vergeOS license keys