The following instructions demonstrate installing .NET 3.1 on Linux. These instructions augment the more general .NET install instructions, including installing with .tar.gz files, that work on multiple operating systems.
Linux package dependencies describes the set of packages required to run .NET on Linux.
The following distributions are available for Linux:
We recommend you install the .NET SDK to develop and build applications, and to install one of the runtimes packages (like ASP.NET Core) to exclusively run applications.
Each of the distributions can be downloaded from:
Container images are provided for Linux (Alpine, Debian, and Ubuntu).
DEB and RPM install packages for Linux are available from Microsoft or, natively from some Linux distributions. It is recommended that you use packages provided by distribution, when available. See Install .NET on Linux for a complete list of supported Linux distributions and installer package options for each.
You can use Snap to install .NET 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/stable --classic
When .NET Core is 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.
You can install .NET with a binary archive. This option is required if you want to install .NET for a single user. It is also recommended if you want to install .NET temporarily.
The following workflow demonstrates downloading, unpacking, configuring, and running the .NET SDK from the command line. You may choose to do some of these tasks via the browser and functionality provided by your operating system.
~# curl -Lo dotnet.tar.gz https://download.visualstudio.microsoft.com/download/pr/e6ae53a9-8567-4f44-b6ce-684d4f4a0b27/e0c29635c1c2ae9424390a41fecc95f1/dotnet-sdk-3.1.410-linux-x64.tar.gz
~# mkdir dotnet
~# tar -C dotnet -xf dotnet.tar.gz
~# rm dotnet.tar.gz
~# export DOTNET_ROOT=~/dotnet
~# export PATH=$PATH:~/dotnet
~# dotnet --version
3.1.410
The DOTNET_ROOT environment variable is required to launch an application with their executables (like myapp.exe). The executables look for this environment variable to find the runtime if it isn’t installed in its regular location. The PATH environment variable must be updated if you want to use dotnet without absolute paths to its location. Setting both of these environment variables is optional.
You can add your .NET install location permanently to your path if you’d like.