Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
Applies to: ✔️ SMB file shares
Azure Files is Microsoft's easy-to-use cloud file system. Azure file shares can be mounted with the industry standard SMB 3 protocol by macOS High Sierra 10.13+.
Warning
Mounting a file share using storage account keys carries inherent security risks. Use identity-based authentication instead. For information on how to protect and manage your keys, see Manage storage account access keys.
Prerequisites for mounting an Azure file share on macOS
Ensure port 445 is open, or set up a VPN connection: SMB communicates over TCP port 445. On your macOS, check to make sure your firewall doesn't block TCP port 445. If port 445 is blocked, you can set up a VPN from on-premises to your Azure file share using private endpoints. For more information, see Networking considerations for direct Azure file share access.
Storage account name: To mount an Azure file share, you need the name of the storage account.
Storage account key (not recommended): If you're using identity-based authentication (recommended), you don't need the storage account key. If identity-based authentication isn't configured on the storage account, you need the primary (or secondary) storage account key.
Mount an Azure file share via Finder
Open Finder: Finder is open on macOS by default, but you can ensure that it's the currently selected application by clicking the macOS face icon on the dock:
Select "Connect to Server" from the "Go" Menu: Using the UNC path, convert the beginning double backslash (
\\) tosmb://and all other backslashes (\) to forward slashes (/).
Use the storage account name and storage account key if prompted for a username and password: If desired, you can persist the storage account name and storage account key in your macOS Keychain.
Use the Azure file share as desired: Use the file share as you would normally use a local folder, including dragging and dropping files into the file share:
Mount an Azure file share via Terminal
Replace
<storage-account-name>,<storage-account-key>, and<share-name>with the appropriate values for your environment. If you're using identity-based authentication (recommended), omit the storage account key.open smb://<storage-account-name>:<storage-account-key>@<storage-account-name>.file.core.windows.net/<share-name>Use the Azure file share as desired: The Azure file share is mounted at the mount point specified by the previous command.
