Use mountOptions settings in Azure Files

This article discusses the useful and recommended mounting options when you configure the storage class object on Azure Files. These mounting options help you to provision storage on your Kubernetes cluster.

Recommended settings

The following mountOptions field settings are recommended for the Kubernetes version and the file and directory mode (permissions):

Setting	Recommended value
Kubernetes version	1.12.2 or later
file_mode and dir_mode value	0777

The following configuration file is an example of how to set the file and directory permissions:

kind: StorageClass
apiVersion: storage.k8s.io/v1
metadata:
  name: azurefile
provisioner: kubernetes.io/azure-file
mountOptions:
  - dir_mode=0777
  - file_mode=0777
  - uid=1000
  - gid=1000
  - mfsymlinks
  - nobrl
  - cache=none
parameters:
  skuName: Standard_LRS

Other useful settings

You might also find the following mountOptions settings useful:

Setting	Description
mfsymlinks	This setting forces the Azure Files mount (Common Internet File System, or cifs) to support symbolic links.
nobrl	This setting prevents sending byte range lock requests to the server. It's necessary for certain applications that break with cifs-style mandatory byte range locks. Most cifs servers don't yet support requesting advisory byte range locks. If an application doesn't use this setting and breaks with cifs-style mandatory byte range locks, error messages such as Error: SQLITE_BUSY: database is locked might occur.

Contact us for help

If you have questions or need help, create a support request, or ask Azure community support. You can also submit product feedback to Azure feedback community.