Mount an Azure file share on macOS
Summary — Mount an Azure file share on macOS
Overview
Azure Files supports SMB 3 mounts from macOS High Sierra (10.13+) using storage account name and key.
Identity-based (Azure AD) authentication is not supported on macOS; mounting with storage account keys has security risks. See Manage storage account access keys: https://docs.azure.cn/en-us/storage/common/storage-account-keys-manage
Ensure TCP port 445 is open on your Mac or use a VPN/private endpoint if port 445 is blocked. Networking guidance: https://docs.azure.cn/en-us/storage/files/storage-files-networking-overview
Applies to
Azure Files with SMB is supported across various management/billing models and redundancy tiers (see original table in the article for details).
Prerequisites
Storage account name.
Storage account key (primary or secondary).
Port 445 accessible from your macOS host.
How to mount
Mount via Finder (GUI)
Open Finder.
From the Go menu choose "Connect to Server".
Enter the UNC path converted to SMB format (replace leading \ with smb:// and backslashes with forward slashes).
When prompted, use the storage account name as the username and the storage account key as the password (you can save to Keychain).
The share mounts and behaves like a local folder (drag/drop, etc.).
Notes and next steps
Mounting with account keys is convenient but less secure; follow best practices for protecting keys: https://docs.azure.cn/en-us/storage/common/storage-account-keys-manage
For Apple help on connecting to servers: https://support.apple.com/guide/mac-help/connect-mac-shared-computers-servers-mchlp1140/mac
Last updated: 07/31/2025
Was this helpful?