Quickstart: Create and manage Azure file shares

Azure Files is Microsoft's easy-to-use cloud file system. Azure file shares can be mounted in Windows, Linux, and macOS. This guide walks you through the basics of working with Azure file shares using either the Azure portal, Azure CLI, or Azure PowerShell module.

Applies to

File share type SMB NFS
Standard file shares (GPv2), LRS/ZRS Yes No
Standard file shares (GPv2), GRS/GZRS Yes No
Premium file shares (FileStorage), LRS/ZRS Yes No


If you don't have an Azure subscription, create a free account before you begin.

Create a storage account

A storage account is a shared pool of storage in which you can deploy an Azure file share or other storage resources, such as blobs or queues. A storage account can contain an unlimited number of shares. A share can store an unlimited number of files, up to the capacity limits of the storage account.

To create a storage account:

  1. In the left menu, select + to create a resource.

  2. Select Storage account to create a storage account.

    A screenshot of the storage account option in the create a resource blade.

  3. In Name, enter mystorageacct followed by a few random numbers, until you see a green check mark that indicates that it's a unique name. A storage account name must be all lowercase and globally unique. Make a note of your storage account name. You will use it later.

  4. In Performance, keep the default value of Standard.

  5. In Replication, select Locally redundant storage (LRS).

  6. In Subscription, select the subscription that was used to create the storage account. If you have only one subscription, it should be the default.

  7. In Resource group, select Create new. For the name, enter myResourceGroup.

  8. In Location, select East US.

  9. When you're finished, select Create to start the deployment.

Create an Azure file share

To create an Azure file share:

  1. Select the storage account from your dashboard.

  2. On the storage account page, in the Services section, select Files.

    A screenshot of the data storage section of the storage account; select file shares.

  3. On the menu at the top of the File service page, click File share. The New file share page drops down.

  4. In Name type myshare, enter a quota, and leave Transaction optimized selected for Tiers.

  5. Select Create to create the Azure file share.

Share names need to be all lower case letters, numbers, and single hyphens but cannot start with a hyphen. For complete details about naming file shares and files, see Naming and Referencing Shares, Directories, Files, and Metadata.

Create a directory

To create a new directory named myDirectory at the root of your Azure file share:

  1. On the File Service page, select the myshare file share. The page for your file share opens.
  2. On the menu at the top of the page, select + Add directory. The New directory page drops down.
  3. Type myDirectory and then click OK.

Upload a file

To demonstrate uploading a file, you first need to create or select a file to be uploaded. You may do this by whatever means you see fit. Once you've selected the file you would like to upload:

  1. Select the myDirectory directory. The myDirectory panel opens.

  2. In the menu at the top, select Upload. The Upload files panel opens.

    A screenshot of the upload files panel

  3. Select the folder icon to open a window to browse your local files.

  4. Select a file and then select Open.

  5. In the Upload files page, verify the file name and then select Upload.

  6. When finished, the file should appear in the list on the myDirectory page.

Download a file

You can download a copy of the file you uploaded by right-clicking on the file. After selecting the download button, the exact experience will depend on the operating system and browser you're using.

Clean up resources

When you're done, you can delete the resource group. Deleting the resource group deletes the storage account, the Azure file share, and any other resources that you deployed inside the resource group.

  1. In the left menu, select Resource groups.
  2. Right-click the resource group, and then select Delete resource group. A window opens and displays a warning about the resources that will be deleted with the resource group.
  3. Enter the name of the resource group, and then select Delete.

Next steps