azure-stack-edge

name	azure-stack-edge
description	Expert knowledge for Azure Stack Edge development including troubleshooting, best practices, decision making, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when deploying IoT Edge modules, GPU/Kubernetes apps, DeepStream workloads, Arc GitOps, or local ARM integrations, and other Azure Stack Edge related development tasks. Not for Azure IoT Edge (use azure-iot-edge), Azure Kubernetes Service (AKS) (use azure-kubernetes-service), Azure Kubernetes Service Edge Essentials (use azure-aks-edge-essentials), 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-08-09","generator":"docs2skills/1.0.0"}

Azure Stack Edge Skill

This skill provides expert guidance for Azure Stack Edge. Covers troubleshooting, 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
Troubleshooting	L36-L86	Diagnosing and fixing Azure Stack Edge/Data Box Gateway issues: release-specific critical bugs, ordering/activation, certificates, ARM/Blob/IoT Edge/VM/GPU problems, and using logs/alerts for troubleshooting.
Best Practices	L87-L92	Best practices for Azure Stack Edge Pro: device failure recovery, GPU sharing/partitioning guidance, and operational guidelines for deployment, monitoring, and maintenance.
Decision Making	L93-L101	Guidance on region and data-location choices, resiliency behavior, disconnected deployment planning, and processes for replacing Azure Stack Edge devices.
Limits & Quotas	L102-L114	Limits, capacities, performance, and system requirements for Azure Stack Edge and Data Box Gateway devices, including supported VM sizes, GPU limits, and cross-subscription resource moves.
Security	L115-L141	Securing Azure Stack Edge: user access, certificates/TLS, Key Vault secrets, VPN/BCDR, encryption, secure wipe, Kubernetes RBAC, and built-in security features/policies.
Configuration	L142-L194	Configuring and managing Azure Stack Edge/Data Box Gateway devices: networking, power, storage, Kubernetes/VMs, GPUs, monitoring, automation, and hardware/system requirements.
Integrations & Coding Patterns	L195-L206	How to deploy and integrate workloads on Azure Stack Edge: IoT Edge modules, GPU-sharing/Kubernetes apps, DeepStream, Arc/Kubernetes GitOps, and connecting to local ARM.
Deployment	L207-L210	Predeployment requirements and planning for Azure Stack Edge Pro GPU, including hardware, networking, certificates, capacity, and environment checks before deployment.

Troubleshooting

Topic	URL
Troubleshoot Azure Edge Hardware Center ordering issues	https://learn.microsoft.com/en-us/azure/azure-edge-hardware-center/azure-edge-hardware-center-troubleshoot-order
Azure Data Box Gateway 1905 GA release known issues	https://learn.microsoft.com/en-us/azure/databox-gateway/data-box-gateway-1905-release-notes
Azure Data Box Edge and Gateway 1906 release issues	https://learn.microsoft.com/en-us/azure/databox-gateway/data-box-gateway-1906-release-notes
Azure Stack Edge and Data Box Gateway 1911 release issues	https://learn.microsoft.com/en-us/azure/databox-gateway/data-box-gateway-1911-release-notes
Azure Stack Edge and Data Box Gateway 2007 release issues	https://learn.microsoft.com/en-us/azure/databox-gateway/data-box-gateway-2007-release-notes
Azure Data Box Gateway 2101 release known issues and workarounds	https://learn.microsoft.com/en-us/azure/databox-gateway/data-box-gateway-2101-release-notes
Azure Data Box Gateway 2105 release known issues and fixes	https://learn.microsoft.com/en-us/azure/databox-gateway/data-box-gateway-2105-release-notes
Azure Data Box Gateway 2301 release issues and fixes	https://learn.microsoft.com/en-us/azure/databox-gateway/data-box-gateway-2301-release-notes
Azure Data Box Gateway 2409 release issues and workarounds	https://learn.microsoft.com/en-us/azure/databox-gateway/data-box-gateway-2409-release-notes
Azure Data Box Gateway general availability release notes	https://learn.microsoft.com/en-us/azure/databox-gateway/data-box-gateway-release-notes

Best Practices

Topic	URL
Recover from Azure Stack Edge Pro device failure	https://learn.microsoft.com/en-us/azure/databox-online/azure-stack-edge-gpu-recover-device-failure
Use GPU sharing options on Azure Stack Edge Pro GPU	https://learn.microsoft.com/en-us/azure/databox-online/azure-stack-edge-gpu-sharing

Decision Making

Topic	URL
Understand data residency options for Azure Stack Edge	https://learn.microsoft.com/en-us/azure/databox-online/azure-stack-edge-gpu-data-residency
Understand data resiliency behavior for Azure Stack Edge	https://learn.microsoft.com/en-us/azure/databox-online/azure-stack-edge-gpu-data-resiliency
Plan disconnected Azure Stack Edge deployments	https://learn.microsoft.com/en-us/azure/databox-online/azure-stack-edge-gpu-disconnected-scenario
Choose Azure regions for Azure Stack Edge service and data	https://learn.microsoft.com/en-us/azure/databox-online/azure-stack-edge-gpu-regions
Request and provision a replacement Azure Stack Edge device	https://learn.microsoft.com/en-us/azure/databox-online/azure-stack-edge-replace-device

Limits & Quotas

Topic	URL
Move Azure Edge Hardware Center resources across subscriptions	https://learn.microsoft.com/en-us/azure/azure-edge-hardware-center/azure-edge-hardware-center-resource-move-subscription-resource-group
Capacity and performance limits for Azure Data Box Gateway	https://learn.microsoft.com/en-us/azure/databox-gateway/data-box-gateway-limits
System requirements for Azure Data Box Gateway deployment	https://learn.microsoft.com/en-us/azure/databox-gateway/data-box-gateway-system-requirements
Supported VM sizes and capacities on Azure Stack Edge	https://learn.microsoft.com/en-us/azure/databox-online/azure-stack-edge-gpu-virtual-machine-sizes
Azure Stack Edge Pro GPU service and device limits	https://learn.microsoft.com/en-us/azure/databox-online/azure-stack-edge-limits
Capacity and system limits for Azure Stack Edge Mini R	https://learn.microsoft.com/en-us/azure/databox-online/azure-stack-edge-mini-r-limits
Operational limits and guidelines for Azure Stack Edge	https://learn.microsoft.com/en-us/azure/databox-online/azure-stack-edge-operational-guidelines-faq
Azure Stack Edge Pro 2 device and service limits	https://learn.microsoft.com/en-us/azure/databox-online/azure-stack-edge-pro-2-limits
Azure Stack Edge Pro R system limits and sizes	https://learn.microsoft.com/en-us/azure/databox-online/azure-stack-edge-pro-r-limits

Security

Topic	URL
Manage user accounts and access on Azure Data Box Gateway	https://learn.microsoft.com/en-us/azure/databox-gateway/data-box-gateway-manage-users
Security configuration for Azure Data Box Gateway components	https://learn.microsoft.com/en-us/azure/databox-gateway/data-box-gateway-security
Use Azure Key Vault for Azure Stack Edge activation secrets	https://learn.microsoft.com/en-us/azure/databox-online/azure-stack-edge-gpu-activation-key-vault
Certificate requirements and error troubleshooting for Azure Stack Edge	https://learn.microsoft.com/en-us/azure/databox-online/azure-stack-edge-gpu-certificate-requirements
Understand certificate types for Azure Stack Edge devices	https://learn.microsoft.com/en-us/azure/databox-online/azure-stack-edge-gpu-certificates-overview
Configure TLS 1.2 on Windows clients for Azure Stack Edge	https://learn.microsoft.com/en-us/azure/databox-online/azure-stack-edge-gpu-configure-tls-settings
Create certificates for Azure Stack Edge using Azure PowerShell	https://learn.microsoft.com/en-us/azure/databox-online/azure-stack-edge-gpu-create-certificates-powershell
Generate Azure Stack Edge certificates with Readiness Checker tool	https://learn.microsoft.com/en-us/azure/databox-online/azure-stack-edge-gpu-create-certificates-tool
Configure certificates on Azure Stack Edge Pro GPU	https://learn.microsoft.com/en-us/azure/databox-online/azure-stack-edge-gpu-deploy-configure-certificates
Configure Kubernetes RBAC on Azure Stack Edge clusters

Configuration

Topic	URL
Manage Azure Data Box Gateway using PowerShell commands	https://learn.microsoft.com/en-us/azure/databox-gateway/data-box-gateway-connect-powershell-interface
Configure access, power, and connectivity for Data Box Gateway	https://learn.microsoft.com/en-us/azure/databox-gateway/data-box-gateway-manage-access-power-connectivity-mode
Configure bandwidth schedules on Azure Data Box Gateway	https://learn.microsoft.com/en-us/azure/databox-gateway/data-box-gateway-manage-bandwidth-schedules
Monitor Azure Data Box Gateway metrics, alerts, and events	https://learn.microsoft.com/en-us/azure/databox-gateway/data-box-gateway-monitor
Configure custom VM sizes on Azure Stack Edge	https://learn.microsoft.com/en-us/azure/databox-online/azure-stack-edge-create-vm-with-custom-size
Check network readiness for Azure Stack Edge deployments	https://learn.microsoft.com/en-us/azure/databox-online/azure-stack-edge-deploy-check-network-readiness
Configure compute network access to modules on Azure Stack Edge FPGA	https://learn.microsoft.com/en-us/azure/databox-online/azure-stack-edge-extend-compute-access-modules
Configure MetalLB BGP load balancing on Azure Stack Edge	https://learn.microsoft.com/en-us/azure/databox-online/azure-stack-edge-gpu-configure-metallb-bgp-mode
Connect and manage Azure Stack Edge via Windows PowerShell	https://learn.microsoft.com/en-us/azure/databox-online/azure-stack-edge-gpu-connect-powershell-interface
Configure and manage Kubernetes cluster on Azure Stack Edge

Integrations & Coding Patterns

Topic	URL
Deploy NVIDIA DeepStream on Ubuntu VM on Azure Stack Edge	https://learn.microsoft.com/en-us/azure/databox-online/azure-stack-edge-deploy-nvidia-deepstream-module
Connect to local Azure Resource Manager on Azure Stack Edge	https://learn.microsoft.com/en-us/azure/databox-online/azure-stack-edge-gpu-connect-resource-manager
Build a C# IoT Edge module for Azure Stack Edge GPU	https://learn.microsoft.com/en-us/azure/databox-online/azure-stack-edge-gpu-create-iot-edge-module
Enable Azure Arc on Kubernetes for Azure Stack Edge	https://learn.microsoft.com/en-us/azure/databox-online/azure-stack-edge-gpu-deploy-arc-kubernetes-cluster
Deploy IoT Edge GPU-sharing workloads on Azure Stack Edge	https://learn.microsoft.com/en-us/azure/databox-online/azure-stack-edge-gpu-deploy-iot-edge-gpu-sharing
Deploy IoT Edge runtime on Ubuntu VM on Azure Stack Edge	https://learn.microsoft.com/en-us/azure/databox-online/azure-stack-edge-gpu-deploy-iot-edge-linux-vm
Run Kubernetes GPU-sharing workloads on Azure Stack Edge	https://learn.microsoft.com/en-us/azure/databox-online/azure-stack-edge-gpu-deploy-kubernetes-gpu-sharing
Deploy PHP Guestbook via GitOps on Arc-enabled Azure Stack Edge	https://learn.microsoft.com/en-us/azure/databox-online/azure-stack-edge-gpu-deploy-stateless-application-git-ops-guestbook

Deployment

Topic	URL
Predeployment checklist for Azure Stack Edge Pro GPU	https://learn.microsoft.com/en-us/azure/databox-online/azure-stack-edge-gpu-deploy-checklist