Skip to content

Commit 614f52c

Browse files
authored
Update storage-how-to-use-files-linux.md
1 parent 9859d8a commit 614f52c

File tree

1 file changed

+8
-7
lines changed

1 file changed

+8
-7
lines changed

articles/storage/files/storage-how-to-use-files-linux.md

Lines changed: 8 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -5,14 +5,16 @@ author: khdownie
55
ms.service: azure-file-storage
66
ms.custom: linux-related-content, devx-track-azurecli
77
ms.topic: how-to
8-
ms.date: 02/21/2025
8+
ms.date: 02/26/2025
99
ms.author: kendownie
1010
---
1111

1212
# Mount SMB Azure file shares on Linux clients
1313

1414
Azure file shares can be mounted in Linux distributions using the [SMB kernel client](https://wiki.samba.org/index.php/LinuxCIFS).
1515

16+
This article shows how to mount an SMB Azure file share using NTLMv2 authentication (storage account key). Using identity-based authentication is preferred for security reasons. See [Enable Active Directory authentication over SMB for Linux clients accessing Azure Files](storage-files-identity-auth-linux-kerberos-enable.md).
17+
1618
## Applies to
1719

1820
| File share type | SMB | NFS |
@@ -23,7 +25,7 @@ Azure file shares can be mounted in Linux distributions using the [SMB kernel cl
2325

2426
## Protocols
2527

26-
The recommended way to mount an Azure file share on Linux is using SMB 3.1.1. By default, Azure Files requires encryption in transit, which is supported by SMB 3.0+. Azure Files also supports SMB 2.1, which doesn't support encryption in transit, but you can't mount Azure file shares with SMB 2.1 from another Azure region or on-premises for security reasons. Unless your application specifically requires SMB 2.1, use SMB 3.1.1. SMB 2.1 support was added to Linux kernel version 3.7, so if you're using a version of the Linux kernel after 3.7, it should support SMB 2.1.
28+
We recommend using SMB 3.1.1. By default, Azure Files requires encryption in transit, which is supported by SMB 3.0+. Azure Files also supports SMB 2.1, which doesn't support encryption in transit, but you can't mount Azure file shares with SMB 2.1 from another Azure region or on-premises for security reasons. Unless your application specifically requires SMB 2.1, use SMB 3.1.1. SMB 2.1 support was added to Linux kernel version 3.7, so if you're using a version of the Linux kernel after 3.7, it should support SMB 2.1.
2729

2830
| Distribution | SMB 3.1.1 (Recommended) | SMB 3.0 |
2931
|-|-----------|---------|
@@ -33,7 +35,7 @@ The recommended way to mount an Azure file share on Linux is using SMB 3.1.1. By
3335
| [Debian](https://www.debian.org/releases/) | Basic: 10+ | AES-128-CCM encryption: 10+ |
3436
| [SUSE Linux Enterprise Server](https://www.suse.com/support/kb/doc/?id=000019587) | AES-128-GCM encryption: 15 SP2+ | AES-128-CCM encryption: 12 SP2+ |
3537

36-
If your Linux distribution isn't listed in the above table, you can check the Linux kernel version with the `uname` command:
38+
If your Linux distribution isn't listed in the table, you can check the Linux kernel version with the `uname` command:
3739

3840
```bash
3941
uname -r
@@ -231,7 +233,7 @@ MNT_ROOT="/media"
231233
sudo mkdir -p $MNT_ROOT
232234
```
233235
234-
To mount an Azure file share on Linux, use the storage account name as the username of the file share, and the storage account key as the password. Because the storage account credentials might change over time, you should store the credentials for the storage account separately from the mount configuration.
236+
Use the storage account name as the username of the file share, and the storage account key as the password. Because the storage account credentials might change over time, you should store the credentials for the storage account separately from the mount configuration.
235237
236238
The following example shows how to create a file to store the credentials. Remember to replace `<resource-group-name>` and `<storage-account-name>` with the appropriate information for your environment.
237239
@@ -316,7 +318,7 @@ sudo apt install autofs
316318
```
317319
# [RHEL](#tab/RHEL)
318320
319-
Same applies for CentOS or Oracle Linux
321+
Same applies for CentOS or Oracle Linux:
320322
321323
On Red Hat Enterprise Linux 8+, use the `dnf` package manager:
322324
```bash
@@ -387,9 +389,8 @@ You can use the following mount options when mounting SMB Azure file shares on L
387389
| `dir_mode=` | n/a | Optional. If the server doesn't support the CIFS Unix extensions, this overrides the default mode for directories. |
388390
| `handletimeout=` | n/a | Optional. The time (in milliseconds) for which the server should reserve the file handle after a failover waiting for the client to reconnect. |
389391
390-
## Next steps
392+
## Next step
391393
392394
For more information about using SMB Azure file shares with Linux, see:
393395
394-
- [Remove SMB 1 on Linux](files-remove-smb1-linux.md)
395396
- [Troubleshoot general SMB issues on Linux](/troubleshoot/azure/azure-storage/files-troubleshoot-linux-smb?toc=/azure/storage/files/toc.json)

0 commit comments

Comments
 (0)