This .NET Core SDK release includes the following released .NET Core and ASP.NET Core Runtimes.
See the Release Notes for details about what is included in this update.
| SDK Installer1 | SDK Binaries1 | Runtime Installer | Runtime Binaries | ASP.NET Core Runtime | Windows Desktop Runtime | |
|---|---|---|---|---|---|---|
| Windows | x86 | x64 | x86 | x64 | ARM | x86 | x64 | x86 | x64 | ARM | x86 | x64 | ARM | Hosting Bundle2 |
x86 | x64 |
| macOS | x64 | x64 | x64 | x64 | x641 | - |
| Linux | Snap Install | x64 | ARM | ARM64 | x64 Alpine | - | x64 | ARM | ARM64 | x64 Alpine | ARM64 Alpine | x641 | ARM1 | ARM641 | x64 Alpine | ARM64 Alpine | - |
| Checksums | Checksums | Checksums | Checksums | Checksums | Checksums |
Visual Studio compatibility: .NET Core 3.1 requires Visual Studio 2019 16.4 or above to take full advantage of all its features. .NET Core 3.1 won’t work properly in earlier versions of Visual Studio. See the following table to select the correct download.
| OS | Development Environment | .NET Core SDK |
|---|---|---|
| Windows | Visual Studio 2019 version 16.4 | 3.1.119 |
| macOS | Visual Studio for Mac | Visual Studio for Mac .NET Core Support |
The .NET Core Docker images have been updated for this release. The .NET Docker samples show various ways to use .NET and Docker together.
Snap is a system which installs applications in an isolated environment and provides for automatic updates. Many distributions which are not directly supported by .NET Core can use Snaps to install. See the list of distributions supported Snap for details.
After configuring Snap on your system, run the following command to install the latest .NET Core SDK.
sudo snap install dotnet-sdk --channel 3.1/stable –-classic
When .NET Core in installed using the Snap package, the default .NET Core command is dotnet-sdk.dotnet, as opposed to just dotnet. The benefit of the namespaced command is that it will not conflict with a globally installed .NET Core version you may have. This command can be aliased to dotnet with:
sudo snap alias dotnet-sdk.dotnet dotnet
Note: Some distros require an additional step to enable access to the SSL certificate. If you experience SSL errors when running dotnet restore, see Linux Setup for a possible resolution.
Before installing .NET, you will need to register the Microsoft key, register the product repository, and install required dependencies. This only needs to be done once per machine. Refer to Setting up Linux for .NET Core for the requirements.
The commands listed below do not specifically include package managers to help with readability. Here are the package managers typically used by the Distros on which .NET Core is supported.
| Distro | Package Manager |
|---|---|
| CentOS, Oracle | yum |
| Debian, Ubuntu | apt-get |
| Fedora | dnf |
| OpenSUSE, SLES | zypper |
Note: .NET Core 3.1 is available in the default Fedora 33+ packages feeds. Before using the default Fedora package feed, please make sure to remove any packages.microsoft.com registration first. Alpine 3.14 and Debian 11 are now supported with the .NET 5.0.10 and .NET Core 3.1.19. The operating system support pages for .NET 5.0 and .NET Core 3.1 have been updated to reflect that.
To develop applications using the .NET Core SDK, run the following command. The .NET Core runtime and ASP.NET Core runtime are included.
sudo [package manager] update or refresh
sudo [package manager] install dotnet-sdk-3.1
If you only need to run existing applications, run the following command. The .NET Core runtime and ASP.NET Core runtime are included.
sudo [package manager] update or refresh
sudo [package manager] install aspnetcore-runtime-3.1
Installing from the packages detailed above is recommended or you can install from binary archive, if that better suits your needs. When using binary archives to install, the contents must be extracted to a user location such as $HOME/dotnet, a symbolic link created for dotnet and a few dependencies installed. Dependency requirements can be seen in the Linux System Prerequisites document.
mkdir -p $HOME/dotnet && tar zxf dotnet.tar.gz -C $HOME/dotnet
export PATH=$PATH:$HOME/dotnet
If only the .NET Core Runtime is needed, install dotnet-runtime-3.1 using your package manager. If you also need ASP.NET Core functionality, installing aspnetcore-runtime-3.1 will install both the ASP.NET Core Runtime and .NET Core Runtime.
If you are looking to host stand-alone apps on Servers, the following installer can be used on Windows systems.
You can download the Windows Server Hosting installer and run the following command from an Administrator command prompt:
This will install the ASP.NET Core Module for IIS.