Shares#
Shares can be created to provide NFS and/or CIFS access to a NAS Volume.
Multiple Shares can be created for a single volume to provide varying security or different access for separate sets of users. {.is-success}
Create an NFS Share#
- From the Cloud Dashboard, select NAS from the left menu.
- Select Volumes from the left menu.
- Select NFS Shares from the left menu.
- Select New from the left menu.
- Enter a Name for the New NFS Share (required).
- Enter a Share Path (or leave blank to share the entire volume).
- Enter a Description for the Share (optional).
- The Allow Everyone checkbox can be selected to allow all Hosts
-
Specify one or more Allowed Hosts to grant access only from particular machines. Hosts can be specified by IP address or FQDN; wildcards can be used to allow entire domains, example: *.companyabc.com.
-
Optionally, a Filesystem ID can be specified.
- Select desired Data Access from the dropdown list (Read Only or Read and Write).
- Select User/Group Squashing option
- No Squashing (default)
- Squash Root
- Squash All
User/Root Squashing is a security feature that denies special access rights based on UID of the user on the client machine; e.g. user id on the client (connecting) computer does not dictate permissions on the share. {.is-info}
- Specify Anonymous User ID (optional). Anonymously-connected users are given permission level of ID assigned here.
- Specify Anonymous Group ID (optional). Anonymously-connected users operate as if they were in Group assigned here.
- The Asynchronous option can be selected to improve performance. However, in the event of an unclean server restart, there is a risk of data corruption/loss when the Asynchronous option is enabled.
- Optionally, the No ACLs option can be selected to disable ACLs (access-control lists).
- Click Submit to save the settings and create the new NFS Share.
Create a CIFS Share#
- From the Cloud Dashboard, select NAS from the left menu.
- Select Volumes from the left menu.
- Select CIFS Shares from the left menu.
- Select New from the left menu.
- Enter a Name for the New CIFS Share (required).
- Enter a Share Path (or leave blank to share the entire volume).
- Optionally, a Description can be entered for the Share.
- Enter a Comment for the Share (optional).
- Specify a Valid Users list (optional). List one User per line.
- Specify a Valid Groups list (optional). List one Group per line.
- Specify an Allowed Hosts list (optional). One Host per line. Hostname, IP address, domain name, netgroup, and subnet are all valid entries.
- Specify a Denied Hosts list (optional). One Host per line. Hostname, IP address, domain name, netgroup, and subnet are all valid entries.
- The Read Only option can be selected to deny any write operations via this Share.
- The Browseable option can be selected to make the share visible in lists of available shares. This option is disabled by default.
- Specify a list of Admin Users (optional).
- A Force User Option / Force Group Option can be specified to define a user or group that will be used for all file operations performed via this Share (regardless of the user account used to connect).
- Advanced Configuration Options (advanced samba share options) can be specified to handle special-case scenarios. (Advanced Use only; please consult with VergeOS Support for assistance.)
- Click Submit to save the settings and create the new CIFS Share.