Azure Local Documentation

DOCUMENT CATEGORY: Reference
SCOPE: Complete Azure Local solution documentation
PURPOSE: Standardized deployment of Azure Local infrastructure
MASTER REFERENCE: Microsoft Learn - Azure Local
Status: Active | Last Updated: 2026-10-15
Welcome to the Azure Local Cloud documentation site — your comprehensive guide to planning, deploying, and operating Azure Local (formerly Azure Stack HCI) infrastructure.
Release baseline
These docs track the latest Azure Local release, 12.2609 (build 12.2609.1003.7, September 2026). Each release is supported for six months, and Azure Stack HCI 23H2 (OS build 25398) reached end of support in April 2026. See Releases and Support Lifecycle for supported builds and what changed since 2604.
Quick Start
Overview
Azure Local is a standardized, automation-first solution for deploying Azure Local (formerly Azure Stack HCI) infrastructure. It is designed around a Two-Repo Architecture that separates the automation logic from the documentation, ensuring portable and repeatable deployments across different customer environments.
This documentation serves as the "Master Reference" for the solution, while the accompanying Toolkit Repository (azurelocal-toolkit) contains the actual scripts, templates, and configuration files used during deployment.
Prerequisites Checklist
Before starting an Azure Local deployment, ensure you have:
| Requirement | Description |
|---|
| Azure Subscription | Active Azure subscription with Owner or Contributor rights |
| Entra ID Access | Global Administrator or Privileged Role Administrator |
| Network Connectivity | VPN or ExpressRoute to on-premises environment |
| Hardware | Azure Local validated nodes racked and powered |
| Credentials | Access to BMC/iDRAC, network switches, and firewalls |
| GitHub Access | Source control account with repository access |
See Prerequisites & Assumptions for complete details.
System Architecture
┌─────────────────────────────────────────────────────────────────────┐
│ TWO-REPO ARCHITECTURE │
├─────────────────────────────┬───────────────────────────────────────┤
│ DOCUMENTATION REPO │ TOOLKIT REPO │
│ (This Site) │ (azurelocal-toolkit) │
├─────────────────────────────┼───────────────────────────────────────┤
│ • High-Level Design (HLD) │ • PowerShell Scripts │
│ • Low-Level Design (LLD) │ • Ansible Playbooks │
│ • Standard Operating Procs │ • Bicep/Terraform Templates │
│ • Runbooks & Procedures │ • CI/CD Pipeline Definitions │
│ • Reference Documentation │ • Customer Configuration Files │
└─────────────────────────────┴───────────────────────────────────────┘
The Toolkit Repo is cloned and instanced for each customer deployment, while this documentation remains the single source of truth for procedures.
Documentation Sections
Deployment Stages at a Glance
The implementation is divided into 8 parts with phased tasks:
Part 1: CI/CD Infrastructure
| Phase | Name | Est. Time | Link |
|---|
| 1 | CI/CD Setup | 45 min | Phase 1 |
Part 2: Azure Cloud Foundation
| Phase | Name | Est. Time | Link |
|---|
| 1 | Landing Zones | 1 hour | Phase 1 |
| 2 | Resource Providers | 15 min | Phase 2 |
| 3 | RBAC Permissions | 30 min | Phase 3 |
| 4 | Azure Management Infrastructure | 2 hours | Phase 4 |
| 5 | Identity & Access Management | 1 hour | Phase 5 |
Part 3: On-Premises Readiness
| Phase | Name | Est. Time | Link |
|---|
| 1 | Active Directory Preparation | 1 hour | Phase 1 |
| 2 | Enterprise Network Readiness Validation | 2 hours | Phase 2 |
| 3 | Network Infrastructure Configuration | 2 hours | Phase 3 |
Part 4: Cluster Deployment
| Phase | Name | Est. Time | Link |
|---|
| 1 | Hardware Provisioning & BIOS/iDRAC | 1 hour | Phase 1 |
| 2 | OS Installation | 2 hours | Phase 2 |
| 3 | OS Configuration | 1 hour | Phase 3 |
| 4 | Arc Registration | 30 min | Phase 4 |
| 5 | Cluster Deployment | 2 hours | Phase 5 |
| 6 | Post-Deployment Configuration | 1 hour | Phase 6 |
Part 5: Operational Foundations
| Phase | Name | Est. Time | Link |
|---|
| 1 | SDN Integration (Optional) | 2 hours | Phase 1 |
| 2 | Monitoring & Observability | 1 hour | Phase 2 |
| 3 | Backup & DR | 1 hour | Phase 3 |
| 4 | Security & Governance | 1 hour | Phase 4 |
| 5 | Licensing & Telemetry | 30 min | Phase 5 |
Part 6: Cluster Testing & Validation
| Activity | Est. Time | Link |
|---|
| Infrastructure Health Validation | 2 hours | Testing |
Part 7: Validation & Handover
| Activity | Est. Time | Link |
|---|
| Cluster, Arc, network and storage validation, documentation, customer transfer | 2 hours | Validation & Handover |
Part 8: Day 2 Operations
| Activity | Est. Time | Link |
|---|
| Check for updates, start the update, node maintenance, cluster operations | per task | Day 2 Operations |
Training
Total Estimated Time: 20-24 hours (spread across multiple days)
Key Capabilities
| Capability | Description |
|---|
| Part-Based Deployment | Infrastructure delivery broken into 8 parts with phased tasks |
| Validation First | Pre-flight checks and post-deployment validation scripts |
| Infrastructure as Code | Bicep and Terraform for Azure resource management |
| Vendor Integration | Standardized workflows for supported hardware vendors |
| CI/CD Automation | CI/CD pipelines for automated deployments |
| Drift Detection | Continuous monitoring for configuration drift |
Version History
| Version | Date | Changes |
|---|
| 1.1.0 | 2026-10-15 | Single docs version aligned with release 12.2609. Added release lifecycle, rack aware clustering, update and SBE, security defaults, and migration pages. Refreshed disconnected operations, BCDR, monitoring, AKS, AVD, and billing content. Fixed retired Microsoft Learn links |
| 1.0.0 | 2025-01-30 | Rebrand to Azure Local, remove legacy content |
| 0.2.0 | 2025-01-30 | Standards compliance update, documentation restructure |
| 0.1.0 | 2025-01-01 | Initial documentation structure |
Support & Resources
Repositories
| Repository | Description | Link |
|---|
| Documentation | This site | GitHub |
| Toolkit | Scripts, templates, pipelines | GitHub |
| Tool | Purpose | Link |
|---|
| Surveyor | S2D capacity planning and workload sizing | Site |
| Ranger | Read-only discovery, documentation, audit, and reporting | Site |
| Beacon | Pre-deployment endpoint, network, and hardware readiness | Site |
| ZTP | Simplified machine provisioning automation using BMC and Redfish | Site |
| Sonar | Real-time monitor for deployments | Site |
| Trailwright | Platform configuration and deployment design | Site |
The full list is in the Tools and Solutions menus of the site header.
External Resources
Browse Documentation