Microsoft's documentation for Azure Local includes a strict requirement:
Two IP ranges must not be used anywhere in your Azure Local deployment:
- 10.96.0.0/12 — Reserved for Kubernetes services
- 10.244.0.0/16 — Reserved for Kubernetes pod networking
These ranges are reserved for internal Azure Local and AKS Arc components. If your existing datacenter network uses any part of these blocks — and many do — deployment can fail or behave unpredictably.
This is especially common with 10.244.0.0/16, which appears in many legacy Kubernetes clusters, lab environments, and inherited network designs.
Microsoft's guidance is simple: don't use these ranges.
But real customer networks are rarely simple.
- Sometimes you inherit a network.
- Sometimes you're mid‑migration.
- Sometimes you discover the overlap only after Azure Local deployment has already begun.
Fortunately, there is a clean, repeatable workaround.