.NET Core 3.1.0 Preview 1 comprises:
- .NET Core Runtime 3.1.0-preview1-19506.1
- ASP.NET Core 3.1.0-preview1.19508.20
- .NET Core 3.1.100-preview1-014459
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 | x86 | x64 | x86 | x64 | ARM | x86 | x64 | x86 | x64 | ARM | x86 | x64 | ARM | Hosting Bundle2 |
macOS | x64 | x64 | x64 | x64 | x641 |
Linux | See installations steps below | x64 | ARM | ARM64 | x64 Alpine | - | x64 | ARM | ARM64 | x64 Alpine | x641 | ARM1 | ARM64 | x64 Alpine1 |
RHEL6 | - | x64 | - | x64 | - |
Checksums | SDK | - | Runtime | - | - |
- Includes the .NET Core and ASP.NET Core Runtimes
- For hosting stand-alone apps on Windows Servers. Includes the ASP.NET Core Module for IIS and can be installed separately on servers without installing .NET Core runtime.
The .NET Core Docker images have been updated for this release. Details on our Docker versioning and how to work with the images can be seen in "Staying up-to-date with .NET Container Images".
Because of the isolated environment, using Snap is the preferred way to install and try .NET Core Previews on Linux distributions that support Snap.
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/beta --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 distributions 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.
Preview release installers are not available from the Microsoft package repositories but you can download them and install manually or, set up a local package repository. Setting up a local package repository will result in a typical package manager installation experience. Consult your distros documentation to understand this option.
A manual installation requires the use of your distribution's package installer to install each of the files in the order presented below. If you attempt to install them out of order, dependency checks will not succeed and the installation will fail. Download the correct System Dependencies Installer along with the host, hostfxr, runtime, aspnetcore-runtime
and sdk
installers.
Please see the 3.1 Supported OS document for specific distribution version support status.
System Dependencies Installer |
---|
CentOS 7 |
Fedora |
OpenSUSE |
Oracle Linux 7 |
RHEL 7 |
SLES 12 |
Debian-based systems |
Component | Package Type |
---|---|
dotnet-host | deb | rpm |
dotnet-hostfxr | deb | rpm |
dotnet-runtime | deb | rpm |
aspnetcore-runtime | deb | rpm |
dotnet-targeting-pack | deb | rpm |
dotnet-apphost-targeting-pack | deb | rpm |
aspnetcore-targeting-pack | deb | rpm |
dotnet-sdk | deb | rpm |
After downloading the files, run your package utility to install the files in the following order.
- dotnet-runtime-deps (System Dependencies Installer)
- dotnet-host
- dotnet-hostfxr
- dotnet-runtime
- aspnetcore-runtime
- dotnet-apphost-targeting-pack
- aspnetcore-targeting-pack
- dotnet-sdk
CentOS, Fedora, OpenSUSE, Oracle Linux, RHEL and SLES
sudo rpm -ivh [package name]
Debian and Ubuntu
sudo dpkg -i [package name]
Here is a simple example script for Fedora to download and install the packages as described above.
cd $HOME/Downloads
mkdir 3.1preview.1
cd 3.1preview.1
wget -c https://download.visualstudio.microsoft.com/download/pr/1cb4dfea-3cd1-4308-9715-d445a8e90a87/b559fcff820841d269a27377f0295498/dotnet-host-3.1.0-preview1.19506.1-x64.rpm
wget -c https://download.visualstudio.microsoft.com/download/pr/c1b73692-a4aa-46b3-b828-db061bd3c97f/7a4a3084955371f76e9d96a2319c4f18/dotnet-hostfxr-3.1.0-preview1.19506.1-x64.rpm
wget -c https://download.visualstudio.microsoft.com/download/pr/2ceb8e42-f900-4500-9de0-9b159ed81b26/c1bc099d2bd35c76bf38e694df4a9226/dotnet-runtime-3.1.0-preview1.19506.1-linux-x64.tar.gz
wget -c https://download.visualstudio.microsoft.com/download/pr/c321b140-ce08-4ad4-a082-1d2c75f80ed2/de026d15ace3ed93dadae71aae2abcaf/dotnet-runtime-deps-3.1.0-preview1.19506.1-fedora.27-x64.rpm
wget -c https://download.visualstudio.microsoft.com/download/pr/afb589d2-f71c-43d1-86d6-984d811930a4/08c21031cb6c13aa41779b189789ada5/aspnetcore-runtime-3.1.0-preview1.19508.20-x64.rpm
wget -c https://download.visualstudio.microsoft.com/download/pr/8862b83f-5364-457a-b42b-4bd0da1d122f/0043c62703d4498904d606b769ba3dff/dotnet-sdk-3.1.100-preview1-014459-x64.rpm
wget -c https://download.visualstudio.microsoft.com/download/pr/c6b55422-82d3-4408-b3fb-ff12a48cc812/38a7aa45b20c6dcdb9b911666ee6f5fc/dotnet-apphost-pack-3.1.0-preview1.19506.1-x64.rpm
wget -c https://download.visualstudio.microsoft.com/download/pr/320c8699-452b-4856-8f32-024bf1e1b6df/e2478d5a0ea5da1c59512ac404613558/dotnet-targeting-pack-3.1.0-preview1.19506.1-x64.rpm
wget -c https://download.visualstudio.microsoft.com/download/pr/9e6533da-9d4e-4061-8c44-77b705a27eba/effff4c0c40e59d88e60017d12152ba7/aspnetcore-targeting-pack-3.1.0-preview1.19508.20.rpm
sudo rpm -ivh dotnet-runtime-deps-3.1.0-preview1.19506.1 -fedora.27-x64.rpm
sudo rpm -ivh dotnet-host-3.1.0-preview1.19506.1 -x64.rpm
sudo rpm -ivh dotnet-hostfxr-3.1.0-preview1.19506.1 -x64.rpm
sudo rpm -ivh dotnet-runtime-3.1.0-preview1.19506.1 -x64.rpm
sudo rpm -ivh aspnetcore-runtime-3.1.0-preview1.19508.20-x64.rpm
sudo rpm -ivh dotnet-apphost-pack-3.1.0-preview1.19506.1 -x64.rpm
sudo rpm -ivh dotnet-targeting-pack-3.1.0-preview1.19506.1 -x64.rpm
sudo rpm -ivh aspnetcore-targeting-pack-3.1.0-preview1.19508.20.rpm
sudo rpm -ivh dotnet-sdk-3.1.100-preview1-014459-x64.rpm
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 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.