azure-stack-edge
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).
Source facts
- Repository
- MicrosoftDocs/Agent-Skills
- Last source activity
- August 31, 2026 at 08:27
- Detected SKILL.md language
- English
- Stars
- 782
- Forks
- 128
Install options
The review-first prompt is selected by default. You can switch to a direct command or download a local copy.
Review the source files
Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.
Showing SKILL.md
SKILL.md
Source instructions · Read-only preview- 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-31","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](https://github.com/MicrosoftDocs/mcp/blob/main/README.md)
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-L87 | Release-specific known issues, alerts, and fixes for Azure Stack Edge/Data Box Gateway, plus troubleshooting for ordering, activation, certificates, ARM, storage, IoT Edge, VMs, GPU, diagnostics, and logs. |
| Best Practices | L88-L93 | Best practices for Azure Stack Edge Pro: device failure recovery, GPU sharing/partitioning guidance, and operational guidelines for deployment, monitoring, and maintenance. |
| Decision Making | L94-L102 | Guidance on region and data-location choices, resiliency behavior, disconnected deployment planning, and processes for replacing Azure Stack Edge devices. |
| Limits & Quotas | L103-L115 | 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 | L116-L142 | 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 | L143-L195 | 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 | L196-L207 | 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 | L208-L211 | 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 |
| Troubleshoot Azure Data Box Gateway using diagnostics and logs | https://learn.microsoft.com/en-us/azure/databox-gateway/data-box-gateway-troubleshoot |
| Interpret and respond to Azure Stack Edge alerts | https://learn.microsoft.com/en-us/azure/databox-online/azure-stack-edge-alerts |
| Review critical issues for Azure Stack Edge preview | https://learn.microsoft.com/en-us/azure/databox-online/azure-stack-edge-gpu-2008-release-notes |
| Review critical issues for Azure Stack Edge GA release | https://learn.microsoft.com/en-us/azure/databox-online/azure-stack-edge-gpu-2010-release-notes |
| Review critical issues for Azure Stack Edge 2101 | https://learn.microsoft.com/en-us/azure/databox-online/azure-stack-edge-gpu-2101-release-notes |
| Review critical issues for Azure Stack Edge 2103 | https://learn.microsoft.com/en-us/azure/databox-online/azure-stack-edge-gpu-2103-release-notes |
| Review critical issues for Azure Stack Edge 2105 | https://learn.microsoft.com/en-us/azure/databox-online/azure-stack-edge-gpu-2105-release-notes |
| Review critical issues for Azure Stack Edge 2106 | https://learn.microsoft.com/en-us/azure/databox-online/azure-stack-edge-gpu-2106-release-notes |
| Review critical issues for Azure Stack Edge 2110 | https://learn.microsoft.com/en-us/azure/databox-online/azure-stack-edge-gpu-2110-release-notes |
| Review critical issues for Azure Stack Edge 2111 | https://learn.microsoft.com/en-us/azure/databox-online/azure-stack-edge-gpu-2111-release-notes |
| Review critical issues for Azure Stack Edge 2202 | https://learn.microsoft.com/en-us/azure/databox-online/azure-stack-edge-gpu-2202-release-notes |
| Review critical issues for Azure Stack Edge 2203 | https://learn.microsoft.com/en-us/azure/databox-online/azure-stack-edge-gpu-2203-release-notes |
| Review critical issues for Azure Stack Edge 2205 | https://learn.microsoft.com/en-us/azure/databox-online/azure-stack-edge-gpu-2205-release-notes |
| Review critical issues for Azure Stack Edge 2207 | https://learn.microsoft.com/en-us/azure/databox-online/azure-stack-edge-gpu-2207-release-notes |
| Review critical issues for Azure Stack Edge 2209 | https://learn.microsoft.com/en-us/azure/databox-online/azure-stack-edge-gpu-2209-release-notes |
| Review critical issues for Azure Stack Edge 2210 | https://learn.microsoft.com/en-us/azure/databox-online/azure-stack-edge-gpu-2210-release-notes |
| Review critical issues for Azure Stack Edge 2301 | https://learn.microsoft.com/en-us/azure/databox-online/azure-stack-edge-gpu-2301-release-notes |
| Review critical issues for Azure Stack Edge 2303 | https://learn.microsoft.com/en-us/azure/databox-online/azure-stack-edge-gpu-2303-release-notes |
| Review critical issues for Azure Stack Edge 2304 | https://learn.microsoft.com/en-us/azure/databox-online/azure-stack-edge-gpu-2304-release-notes |
| Review critical issues for Azure Stack Edge 2309 | https://learn.microsoft.com/en-us/azure/databox-online/azure-stack-edge-gpu-2309-release-notes |
| Review critical issues for Azure Stack Edge 2312 | https://learn.microsoft.com/en-us/azure/databox-online/azure-stack-edge-gpu-2312-release-notes |
| Review critical issues for Azure Stack Edge 2403 | https://learn.microsoft.com/en-us/azure/databox-online/azure-stack-edge-gpu-2403-release-notes |
| Review critical issues for Azure Stack Edge 2407 | https://learn.microsoft.com/en-us/azure/databox-online/azure-stack-edge-gpu-2407-release-notes |
| Review critical issues for Azure Stack Edge 2501 | https://learn.microsoft.com/en-us/azure/databox-online/azure-stack-edge-gpu-2501-release-notes |
| Review critical issues for Azure Stack Edge 2506 | https://learn.microsoft.com/en-us/azure/databox-online/azure-stack-edge-gpu-2506-release-notes |
| Resolve issues in Azure Stack Edge 2510 release | https://learn.microsoft.com/en-us/azure/databox-online/azure-stack-edge-gpu-2510-release-notes |
| Resolve Azure Stack Edge 2604 known issues | https://learn.microsoft.com/en-us/azure/databox-online/azure-stack-edge-gpu-2604-release-notes |
| Resolve Azure Stack Edge 2607 known issues | https://learn.microsoft.com/en-us/azure/databox-online/azure-stack-edge-gpu-2607-release-notes |
| Troubleshoot certificate issues on Azure Stack Edge | https://learn.microsoft.com/en-us/azure/databox-online/azure-stack-edge-gpu-certificate-troubleshooting |
| Run diagnostics and collect logs on Azure Stack Edge | https://learn.microsoft.com/en-us/azure/databox-online/azure-stack-edge-gpu-troubleshoot |
| Fix Azure Stack Edge activation and Key Vault errors | https://learn.microsoft.com/en-us/azure/databox-online/azure-stack-edge-gpu-troubleshoot-activation |
| Troubleshoot Azure Resource Manager issues on Azure Stack Edge | https://learn.microsoft.com/en-us/azure/databox-online/azure-stack-edge-gpu-troubleshoot-azure-resource-manager |
| Troubleshoot Blob storage issues on Azure Stack Edge | https://learn.microsoft.com/en-us/azure/databox-online/azure-stack-edge-gpu-troubleshoot-blob-storage |
| Troubleshoot IoT Edge runtime issues on Azure Stack Edge | https://learn.microsoft.com/en-us/azure/databox-online/azure-stack-edge-gpu-troubleshoot-iot-edge |
| Troubleshoot GPU extension installation on Azure Stack Edge VMs | https://learn.microsoft.com/en-us/azure/databox-online/azure-stack-edge-gpu-troubleshoot-virtual-machine-gpu-extension-installation |
| Troubleshoot VM image upload and management on Azure Stack Edge | https://learn.microsoft.com/en-us/azure/databox-online/azure-stack-edge-gpu-troubleshoot-virtual-machine-image-upload |
| Troubleshoot VM provisioning failures on Azure Stack Edge GPU | https://learn.microsoft.com/en-us/azure/databox-online/azure-stack-edge-gpu-troubleshoot-virtual-machine-provisioning |
| Troubleshoot Azure Stack Edge ordering problems | https://learn.microsoft.com/en-us/azure/databox-online/azure-stack-edge-troubleshoot-ordering |
### 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 | https://learn.microsoft.com/en-us/azure/databox-online/azure-stack-edge-gpu-kubernetes-rbac |
| Manage certificates on Azure Stack Edge devices | https://learn.microsoft.com/en-us/azure/databox-online/azure-stack-edge-gpu-manage-certificates |
| Manage user access on Azure Stack Edge Pro GPU | https://learn.microsoft.com/en-us/azure/databox-online/azure-stack-edge-gpu-manage-users |
View on GitHubThis SKILL.md is very large, so SkillsMP previews the first section here. View on GitHub
