Skip to content

Commit 505e177

Browse files
committed
Article integrity fixes for AI readiness
1 parent f0c5ba2 commit 505e177

1 file changed

Lines changed: 14 additions & 20 deletions

File tree

articles/storage/files/storage-files-how-to-mount-nfs-shares.md

Lines changed: 14 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -1,11 +1,11 @@
11
---
2-
title: Mount an NFS Azure file share on Linux
2+
title: Mount an NFS Azure File Share on Linux
33
description: Learn how to mount a Network File System (NFS) Azure file share on Linux, including configuring network security and mount options.
44
author: khdownie
55
ms.service: azure-file-storage
66
ms.custom: linux-related-content, references_regions
77
ms.topic: how-to
8-
ms.date: 08/01/2025
8+
ms.date: 01/15/2026
99
ms.author: kendownie
1010
# Customer intent: As a Linux system administrator, I want to mount an NFS Azure file share, so that I can securely access and manage data stored in Azure from my Linux environment.
1111
---
@@ -33,7 +33,7 @@ Azure file shares can be mounted in Linux distributions using either the Server
3333

3434
## Prerequisite: Configure network security
3535

36-
NFSv4.1 file shares (both classic and those created with Microsoft.FileShares) can only be accessed from trusted networks. We recommend securing the data by using a virtual network and other network security settings. Any other tools used to secure data, including account key authorization, Microsoft Entra security, and access control lists (ACLs) can't be used to authorize an NFSv4.1 request. To learn more about how to set up NFS 4.1 file share, virtual machine, and networking setting, see [how to create a classic file share](./create-classic-file-share.md), and [how to create a file share](./create-file-share.md) for more information.
36+
NFSv4.1 file shares (both classic file shares created with the Microsoft.Storage resource provider and file shares created with Microsoft.FileShares resource provider) can only be accessed from trusted networks. We recommend securing the data by using a virtual network and other network security settings. Microsoft Entra security and access control lists (ACLs) can't be used to authorize NFSv4.1 requests. To learn more about how to set up NFSv4.1 file shares, see [how to create a classic file share](./create-classic-file-share.md) and [how to create a file share](./create-file-share.md).
3737

3838
## Mount an NFS Azure file share
3939

@@ -45,23 +45,21 @@ You can use the `nconnect` Linux mount option to improve performance for NFS Azu
4545

4646
#### Classic NFS file share (Microsoft.Storage)
4747

48-
1. Once the file share is created, select the share and then select **Connect from Linux**.
48+
1. After you create the file share, select the share and then select **Connect from Linux**.
4949
1. Enter the mount path you'd like to use, then copy the script and run it on your client. Azure portal offers a step-by-step, ready-to-use installation script tailored to your selected Linux distribution for installing the AZNFS mount helper package and to securely mount the share using [Encryption in Transit](encryption-in-transit-for-nfs-shares.md). Only the required mount options are included in the script, but you can add other [recommended mount options](#mount-options).
5050

5151
:::image type="content" source="./media/storage-files-how-to-mount-nfs-shares/mount-file-share.png" alt-text="Screenshot showing how to connect to an NFS file share from Linux using a provided mounting script." lightbox="./media/storage-files-how-to-mount-nfs-shares/mount-file-share.png" border="true":::
5252

5353
##### Mount a classic NFS share using the NFS client mount in command line
5454

55-
You can also mount the Azure file share using NFS client mount in command line. Select the tab below for your Linux distribution to see the commands you need to run. Be sure to replace `<YourStorageAccountName>` and `<FileShareName>` with your information.
55+
You can also mount the Azure file share using NFS client mount in command line. Select the tab below for your Linux distribution to see the commands you need to run. Replace `<YourStorageAccountName>` and `<FileShareName>` with your information.
5656

5757
# [Ubuntu/Debian](#tab/Ubuntu)
5858

5959
```bash
6060
sudo apt-get -y update
6161
sudo apt-get install nfs-common
6262

63-
/mount/<YourStorageAccountName>/<FileShareName>
64-
6563
sudo mkdir -p /mount/<YourStorageAccountName>/<FileShareName>
6664
sudo mount -t nfs <YourStorageAccountName>.file.core.windows.net:/<YourStorageAccountName>/<FileShareName> /mount/<YourStorageAccountName>/<FileShareName> -o vers=4,minorversion=1,sec=sys,nconnect=4
6765
```
@@ -72,8 +70,6 @@ sudo mount -t nfs <YourStorageAccountName>.file.core.windows.net:/<YourStorageAc
7270
sudo yum update
7371
sudo yum install nfs-utils
7472

75-
/mount/<YourStorageAccountName>/<FileShareName>
76-
7773
sudo mkdir -p /mount/<YourStorageAccountName>/<FileShareName>
7874
sudo mount -t nfs <YourStorageAccountName>.file.core.windows.net:/<YourStorageAccountName>/<FileShareName> /mount/<YourStorageAccountName>/<FileShareName> -o vers=4,minorversion=1,sec=sys,nconnect=4
7975
```
@@ -84,10 +80,8 @@ sudo mount -t nfs <YourStorageAccountName>.file.core.windows.net:/<YourStorageAc
8480
sudo zypper update
8581
sudo zypper -n install nfs-client
8682

87-
/mount/<YourStorageAccountName>/<FileShareName>
88-
8983
sudo mkdir -p /mount/<YourStorageAccountName>/<FileShareName>
90-
sudo mount -t nfs <YourStorageAccountName>.core.windows.net:/<YourStorageAccountName>/<FileShareName> /mount/<YourStorageAccountName>/<FileShareName> -o vers=4,minorversion=1,sec=sys,nconnect=4
84+
sudo mount -t nfs <YourStorageAccountName>.file.core.windows.net:/<YourStorageAccountName>/<FileShareName> /mount/<YourStorageAccountName>/<FileShareName> -o vers=4,minorversion=1,sec=sys,nconnect=4
9185
```
9286

9387
---
@@ -101,7 +95,7 @@ sudo mount -t nfs <YourStorageAccountName>.core.windows.net:/<YourStorageAccount
10195

10296
##### Mount an NFS share using the NFS client mount in command line
10397

104-
You can also mount the Azure file share using NFS client mount in command line. Select the tab below for your Linux distribution to see the commands you need to run. Be sure to replace `<your-subscription-id>`, `<your-reource-group>` and `<your-file-share-name>` with your information.
98+
You can also mount the Azure file share using NFS client mount in command line. Select the tab below for your Linux distribution to see the commands you need to run. Replace `<your-subscription-id>`, `<your-resource-group>` and `<your-file-share-name>` with your information.
10599

106100
```bash
107101
# Customize these placeholders:
@@ -165,28 +159,28 @@ If the package is installed, then the message `AZNFS Mount Helper is installed!`
165159

166160
For classic file share, remember to replace `<YourStorageAccountName>` and `<FileShareName>` with your own values. For file share, remember to replace `hostName` and `shortName` with the correct values. For more information, enter the command `man fstab` from the Linux command line.
167161

168-
### Mount with Aznfs helper with encryption in transit
162+
### Mount with AZNFS Mount Helper with encryption in transit
169163

170164
The record in **/etc/fstab** should look like this if you're using the AZNFS Mount Helper and want to mount the share using encryption in transit.
171165

172166
```bash
173167
# For Microsoft.Storage file share, use:
174-
<YourStorageAccountName>.file.core.windows.net:/<YourStorageAccountName>/<FileShareName> /media/<YourStorageAccountName>/<FileShareName> aznfs defaults,sec=sys,vers=4.1,nolock,proto=tcp,nofail,_netdev   0 2
168+
<YourStorageAccountName>.file.core.windows.net:/<YourStorageAccountName>/<FileShareName> /media/<YourStorageAccountName>/<FileShareName> aznfs defaults,sec=sys,vers=4,minorversion=1,nolock,proto=tcp,nofail,_netdev   0 2
175169

176170
# For Microsoft.FileShares file share, use:
177-
$hostName:/$shortName/<FileShareName> /media/$shortName/<FileShareName> aznfs defaults,sec=sys,vers=4.1,nolock,proto=tcp,nofail,_netdev   0 2
171+
$hostName:/$shortName/<FileShareName> /media/$shortName/<FileShareName> aznfs defaults,sec=sys,vers=4,minorversion=1,nolock,proto=tcp,nofail,_netdev   0 2
178172
```
179173

180-
### Mount with Aznfs helper without encryption in transit
174+
### Mount with AZNFS Mount Helper without encryption in transit
181175

182176
If you're using the AZNFS Mount Helper but don't want to use encryption in transit, the record in **/etc/fstab** should look like this:
183177

184178
```bash
185179
# For Microsoft.Storage file share, use:
186-
<YourStorageAccountName>.file.core.windows.net:/<YourStorageAccountName>/<FileShareName> /media/<YourStorageAccountName>/<FileShareName> aznfs defaults,sec=sys,vers=4.1,nolock,proto=tcp,nofail,_netdev,notls   0 2
180+
<YourStorageAccountName>.file.core.windows.net:/<YourStorageAccountName>/<FileShareName> /media/<YourStorageAccountName>/<FileShareName> aznfs defaults,sec=sys,vers=4,minorversion=1,nolock,proto=tcp,nofail,_netdev,notls   0 2
187181

188182
# For Microsoft.FileShares file share, use:
189-
$hostName:/$shortName/<FileShareName> /media/$shortName/<FileShareName> aznfs defaults,sec=sys,vers=4.1,nolock,proto=tcp,nofail,_netdev,notls   0 2
183+
$hostName:/$shortName/<FileShareName> /media/$shortName/<FileShareName> aznfs defaults,sec=sys,vers=4,minorversion=1,nolock,proto=tcp,nofail,_netdev,notls   0 2
190184
```
191185

192186
### Mount with native mount command
@@ -208,7 +202,7 @@ The following mount options are recommended or required when mounting NFS Azure
208202
| **Mount option** | **Recommended value** | **Description** |
209203
|**\*\*\*\***\*\***\*\*\*\***|\***\*\*\*\*\***\*\*\*\***\*\*\*\*\***|**\*\*\*\***\***\*\*\*\***|
210204
| `vers` | 4 | Required. Specifies which version of the NFS protocol to use. Azure Files only supports NFSv4.1. |
211-
| `minorversion` | 1 | Required. Specifies the minor version of the NFS protocol. Some Linux distros don't recognize minor versions on the `vers` parameter. So instead of `vers=4.1`, use `vers=4,minorversion=1`. |
205+
| `minorversion` | 1 | Required. Specifies the minor version of the NFS protocol. Some Linux distros don't recognize dotted minor versions on the `vers` parameter. So instead of `vers=4.1`, use `vers=4,minorversion=1`. |
212206
| `sec` | sys | Required. Specifies the type of security to use when authenticating an NFS connection. Setting `sec=sys` uses the local UNIX UIDs and GIDs that use AUTH_SYS to authenticate NFS operations. |
213207
| `rsize` | 1048576 | Recommended. Sets the maximum number of bytes to be transferred in a single NFS read operation. Specifying the maximum level of 1,048,576 bytes usually results in the best performance. |
214208
| `wsize` | 1048576 | Recommended. Sets the maximum number of bytes to be transferred in a single NFS write operation. Specifying the maximum level of 1,048,576 bytes usually results in the best performance. |

0 commit comments

Comments
 (0)