azure-files

name	azure-files
description	Expert knowledge for Azure Files development including best practices, decision making, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when configuring Azure Files/File Sync, SMB/NFS access, DFS/VDI setups, RAG over files, or data migrations, and other Azure Files related development tasks. Not for Azure Blob Storage (use azure-blob-storage), Azure NetApp Files (use azure-netapp-files), Azure Managed Lustre (use azure-managed-lustre), Azure Virtual Machines (use azure-virtual-machines).
compatibility	Requires network access. Uses mcp_microsoftdocs:microsoft_docs_fetch or fetch_webpage to retrieve documentation.
metadata	{"generated_at":"2026-04-19","generator":"docs2skills/1.0.0"}

Azure Files Skill

This skill provides expert guidance for Azure Files. Covers best practices, decision making, limits & quotas, security, configuration, integrations & coding patterns, and deployment. It combines local quick-reference content with remote documentation fetching capabilities.

How to Use This Skill

IMPORTANT for Agent: Use the Category Index below to locate relevant sections. For categories with line ranges (e.g., L35-L120), use read_file with the specified lines. For categories with file links (e.g., [security.md](security.md)), use read_file on the linked reference file

IMPORTANT for Agent: If metadata.generated_at is more than 3 months old, suggest the user pull the latest version from the repository. If mcp_microsoftdocs tools are not available, suggest the user install it: Installation Guide

This skill requires network access to fetch documentation content:

• Preferred: Use mcp_microsoftdocs:microsoft_docs_fetch with query string from=learn-agent-skill. Returns Markdown.
• Fallback: Use fetch_webpage with query string from=learn-agent-skill&accept=text/markdown. Returns Markdown.

Category Index

Category	Lines	Description
Best Practices	L35-L50	Disaster recovery, lifecycle, and performance best practices for Azure Files and Azure File Sync, including failover planning, server/drive replacement, large directory handling, and VDI/FSLogix usage.
Decision Making	L51-L71	Guidance for planning Azure Files deployments: choosing tiers, redundancy, billing/cost models, reservations, access patterns, and migration/architecture options for SMB/NFS and File Sync.
Limits & Quotas	L72-L79	Azure Files/File Sync limits: capacity, IOPS/throughput, scalability targets, API throttling behavior, redundancy/region support, and FAQ on performance-related constraints.
Security	L80-L107	Securing Azure Files with identity-based auth (AD DS, Entra ID, Kerberos), NTFS/share permissions, TLS/SMB/NFS hardening, and network/firewall/proxy configuration for secure access.
Configuration	L108-L134	Configuring Azure Files and Azure File Sync: networking/VPN and private endpoints, monitoring/alerts, cloud tiering, DFS integration, redundancy, soft delete, and secure access for apps and RAG.
Integrations & Coding Patterns	L135-L156	Patterns and code samples for building RAG apps over Azure Files using Haystack, LangChain, LlamaIndex with Pinecone/Qdrant/Weaviate, plus .NET, Java, and Python integration guides.
Deployment	L157-L168	Guides for migrating and syncing data to Azure Files/Azure File Sync from NAS, Linux, GlusterFS, SMB/NFS shares, and moving File Sync resources safely across scopes.

Best Practices

Topic	URL
Implement disaster recovery best practices for Azure File Sync	https://learn.microsoft.com/en-us/azure/storage/file-sync/file-sync-disaster-recovery-best-practices
Modify Azure File Sync topology without data loss	https://learn.microsoft.com/en-us/azure/storage/file-sync/file-sync-modify-sync-topology
Replace drives on Azure File Sync servers correctly	https://learn.microsoft.com/en-us/azure/storage/file-sync/file-sync-replace-drive
Replace Azure File Sync servers during lifecycle events	https://learn.microsoft.com/en-us/azure/storage/file-sync/file-sync-replace-server
Deprovision Azure File Sync server endpoints safely	https://learn.microsoft.com/en-us/azure/storage/file-sync/file-sync-server-endpoint-delete
Recover Azure File Sync servers after failures	https://learn.microsoft.com/en-us/azure/storage/file-sync/file-sync-server-recovery
Plan disaster recovery and failover for Azure Files	https://learn.microsoft.com/en-us/azure/storage/files/files-disaster-recovery
Handle large directories on NFS Azure file shares	https://learn.microsoft.com/en-us/azure/storage/files/nfs-large-directories
Tune NFS Azure file share performance at scale	https://learn.microsoft.com/en-us/azure/storage/files/nfs-performance
Optimize SMB Azure file share performance on SSD	https://learn.microsoft.com/en-us/azure/storage/files/smb-performance
Optimize Azure Files performance for your workload	https://learn.microsoft.com/en-us/azure/storage/files/understand-performance

Decision Making

Topic	URL
Select optimal Azure File Sync cloud tiering policies	https://learn.microsoft.com/en-us/azure/storage/file-sync/file-sync-choose-cloud-tiering-policies
Plan Azure File Sync deployment options and topology	https://learn.microsoft.com/en-us/azure/storage/file-sync/file-sync-planning
Choose and configure Azure File Sync server endpoints	https://learn.microsoft.com/en-us/azure/storage/file-sync/file-sync-server-endpoint-create
Decide when to use Microsoft.FileShares NFS file shares	https://learn.microsoft.com/en-us/azure/storage/files/create-file-share
Estimate Azure Files costs across billing models	https://learn.microsoft.com/en-us/azure/storage/files/file-estimate-cost
Choose Azure Files redundancy options for durability	https://learn.microsoft.com/en-us/azure/storage/files/files-redundancy
Reduce Azure Files costs using reservations	https://learn.microsoft.com/en-us/azure/storage/files/files-reserve-capacity
Adjust Azure file share size, cost, and performance	https://learn.microsoft.com/en-us/azure/storage/files/modify-file-share
Select redundancy for premium SSD Azure file shares	https://learn.microsoft.com/en-us/azure/storage/files/redundancy-premium-file-shares
Choose development approaches for Azure Files applications	https://learn.microsoft.com/en-us/azure/storage/files/storage-files-developer-overview
Migrate Linux servers to NFS Azure file shares	https://learn.microsoft.com/en-us/azure/storage/files/storage-files-migration-nfs

Limits & Quotas

Topic	URL
Understand Azure File Sync scalability and performance targets	https://learn.microsoft.com/en-us/azure/storage/file-sync/file-sync-scale-targets
Review Azure File Sync API throttling limits and behavior	https://learn.microsoft.com/en-us/azure/storage/file-sync/file-sync-throttling
Azure Files and File Sync FAQ with limits and behaviors	https://learn.microsoft.com/en-us/azure/storage/files/storage-files-faq
Azure Files scalability, IOPS, and throughput limits	https://learn.microsoft.com/en-us/azure/storage/files/storage-files-scale-targets

Security

Topic	URL
Configure on-premises firewall and proxy for Azure File Sync	https://learn.microsoft.com/en-us/azure/storage/file-sync/file-sync-firewall-and-proxy
Use managed identities to secure Azure File Sync access	https://learn.microsoft.com/en-us/azure/storage/file-sync/file-sync-managed-identities
Authorize Azure portal access to Azure file data	https://learn.microsoft.com/en-us/azure/storage/files/authorize-data-operations-portal
Enable OAuth-based REST access to Azure file shares	https://learn.microsoft.com/en-us/azure/storage/files/authorize-oauth-rest
Change identity source for Azure Files SMB authentication	https://learn.microsoft.com/en-us/azure/storage/files/change-identity-source
Enable TLS encryption in transit for NFS Azure Files	https://learn.microsoft.com/en-us/azure/storage/files/encryption-in-transit-for-nfs-shares
Use managed identities to access Azure SMB file shares	https://learn.microsoft.com/en-us/azure/storage/files/files-managed-identities
Configure network security perimeter for Azure Files	https://learn.microsoft.com/en-us/azure/storage/files/files-network-security-perimeter
Secure and configure NFS file shares in Azure Files	https://learn.microsoft.com/en-us/azure/storage/files/files-nfs-protocol
Disable insecure SMB1 on Linux for Azure Files	https://learn.microsoft.com/en-us/azure/storage/files/files-remove-smb1-linux
Configure SMB Azure file shares and security features	https://learn.microsoft.com/en-us/azure/storage/files/files-smb-protocol

Configuration

Topic	URL
Silently install Azure File Sync agent with custom settings	https://learn.microsoft.com/en-us/azure/storage/file-sync/file-sync-agent-silent-installation
Configure Azure File Sync cloud tiering date and space policies	https://learn.microsoft.com/en-us/azure/storage/file-sync/file-sync-cloud-tiering-policy
Install and manage Azure File Sync agent on Arc servers	https://learn.microsoft.com/en-us/azure/storage/file-sync/file-sync-extension
Manage Azure File Sync cloud tiered files via PowerShell	https://learn.microsoft.com/en-us/azure/storage/file-sync/file-sync-how-to-manage-tiered-files
Monitor Azure File Sync cloud tiering metrics and cache	https://learn.microsoft.com/en-us/azure/storage/file-sync/file-sync-monitor-cloud-tiering
Configure Azure Monitor for Azure File Sync monitoring and alerts	https://learn.microsoft.com/en-us/azure/storage/file-sync/file-sync-monitoring
Configure public and private endpoints for Azure File Sync	https://learn.microsoft.com/en-us/azure/storage/file-sync/file-sync-networking-endpoints
Configure networking for Azure File Sync caching servers	https://learn.microsoft.com/en-us/azure/storage/file-sync/file-sync-networking-overview
Reference metrics and logs for monitoring Azure File Sync	https://learn.microsoft.com/en-us/azure/storage/file-sync/monitor-file-sync-reference
Analyze Azure Files performance metrics with Azure Monitor	https://learn.microsoft.com/en-us/azure/storage/files/analyze-files-metrics

Integrations & Coding Patterns

Topic	URL
Integrate Haystack RAG pipelines with Azure Files	https://learn.microsoft.com/en-us/azure/storage/files/artificial-intelligence/retrieval-augmented-generation/open-source-frameworks/orchestrations/haystack
Integrate LangChain RAG pipelines with Azure Files	https://learn.microsoft.com/en-us/azure/storage/files/artificial-intelligence/retrieval-augmented-generation/open-source-frameworks/orchestrations/langchain
Integrate LlamaIndex RAG pipelines with Azure Files	https://learn.microsoft.com/en-us/azure/storage/files/artificial-intelligence/retrieval-augmented-generation/open-source-frameworks/orchestrations/llamaindex
Build Haystack + Pinecone RAG over Azure Files	https://learn.microsoft.com/en-us/azure/storage/files/artificial-intelligence/retrieval-augmented-generation/open-source-frameworks/tutorials/haystack-pinecone/tutorial-haystack-pinecone
Implement Haystack–Qdrant RAG with Azure Files	https://learn.microsoft.com/en-us/azure/storage/files/artificial-intelligence/retrieval-augmented-generation/open-source-frameworks/tutorials/haystack-qdrant/tutorial-haystack-qdrant
Implement Haystack–Weaviate RAG with Azure Files	https://learn.microsoft.com/en-us/azure/storage/files/artificial-intelligence/retrieval-augmented-generation/open-source-frameworks/tutorials/haystack-weaviate/tutorial-haystack-weaviate
Build LangChain + Pinecone RAG over Azure Files	https://learn.microsoft.com/en-us/azure/storage/files/artificial-intelligence/retrieval-augmented-generation/open-source-frameworks/tutorials/langchain-pinecone/tutorial-langchain-pinecone

Deployment

Topic	URL
Move Azure File Sync resources across scopes safely	https://learn.microsoft.com/en-us/azure/storage/file-sync/file-sync-resource-move
Migrate data between Azure file shares with File Sync	https://learn.microsoft.com/en-us/azure/storage/file-sync/file-sync-share-to-share-migration
Migrate GlusterFS volumes to Azure Files	https://learn.microsoft.com/en-us/azure/storage/files/glusterfs-migration-guide
Migrate SMB/NFS shares to Azure Files via Storage Mover	https://learn.microsoft.com/en-us/azure/storage/files/migrate-files-storage-mover
Migrate Linux servers to Azure File Sync hybrid	https://learn.microsoft.com/en-us/azure/storage/files/storage-files-migration-linux-hybrid
Migrate on-prem NAS to Azure Files with Data Box	https://learn.microsoft.com/en-us/azure/storage/files/storage-files-migration-nas-cloud-databox
Migrate NAS SMB shares to Azure File Sync hybrid	https://learn.microsoft.com/en-us/azure/storage/files/storage-files-migration-nas-hybrid
Migrate on-premises NAS to Azure File Sync using Data Box	https://learn.microsoft.com/en-us/azure/storage/files/storage-files-migration-nas-hybrid-databox
Migrate to SMB Azure file shares using Robocopy	https://learn.microsoft.com/en-us/azure/storage/files/storage-files-migration-robocopy