Critical Update: .NET Install Links Are Changing

Published on December 26, 2024

We are currently making an unexpected change to the way that .NET installers and archives are distributed. This change may affect you and may require changes in your development, CI, and/or production infrastructure. We expect that most users will not be directly affected; however, it is critical that you validate if you are affected and to watch for downtime or other kinds of breakage.

The most up-to-date status is being maintained at dotnet/core #9671. Please refer to that issue to stay current.

If you are experiencing an outage that you believe is caused by these changes, please comment on the referenced GitHub issue and/or email us at dotnet@microsoft.com.

Affected Domains

We maintain multiple Content Delivery Network (CDN) instances for delivering .NET builds. Some end in azureedge.net. These domains are hosted by edg.io, which will soon cease operations due to bankruptcy. We are required to migrate to a new CDN and will be using new domains going forward.

It is possible that azureedge.net domains will experience downtime in the near term. We expect that these domains will be permanently retired in the first few months of 2025.

Note: No other party will ever have access to use these domains.

Affected domains:

• dotnetcli.azureedge.net
• dotnetbuilds.azureedge.net

Unaffected domains:

• dotnet.microsoft.com
• download.visualstudio.microsoft.com

Our Response

We have made several changes in response to this situation. We have tried to reduce what you need to do to react. In many cases, you won’t need to do anything special.

New CDNs

• Official builds: builds.dotnet.microsoft.com
• CI builds: ci.dot.net

Updated .NET Install Script

• The install script now uses the new domains, per dotnet/install-scripts #555.
• This script has been deployed to the official locations, as described in the dotnet-install scripts reference.

Addressing CI Installers

• GitHub Actions has been updated to use the new domains, per actions/setup-dotnet #570.
• We expect that GitHub Enterprise Server will be addressed in January.
• Azure DevOps UseDotNet@2 will be updated in January.
• We do not yet have a date for updating Azure DevOps Server.

Domain Configuration

We are in the process of changing the configuration of our domains. At present, they may be using a combination of Akamai, Azure Front Door, and edgio. Our highest priority has been maintaining service continuity during this transition.

Recommended Actions

We recommend that you:

• Review your systems to identify any dependencies on the affected azureedge.net domains.
• Update any hardcoded URLs to point to the new domains as soon as possible.
• Monitor your systems for any issues related to these changes and report them promptly.

We apologize for any inconvenience this may cause and appreciate your understanding as we work to ensure the reliability and security of our services.

For more detailed information, please refer to the official announcement: Critical: .NET Install links are changing.