|
| 1 | +# .NET 8 installation instructions for Linux |
| 2 | + |
| 3 | +The following instructions demonstrate installing .NET 8 on Linux. These instructions augment the more general [.NET install instructions](install.md), including installing with `.tar.gz` files, that work on multiple operating systems. |
| 4 | + |
| 5 | +[Linux package dependencies](linux-packages.md) describes the set of packages required to run .NET on Linux. |
| 6 | + |
| 7 | +## Distributions |
| 8 | + |
| 9 | +The following distributions are available for Linux: |
| 10 | + |
| 11 | +- .NET SDK: includes tools for building and testing applications, and includes the runtime distributions that follow. |
| 12 | +- .NET Runtime: includes the .NET runtime and libraries, enabling running console applications. |
| 13 | +- ASP.NET Core Runtime: includes the .NET and ASP.NET Core runtimes, enabling running console, and web applications. |
| 14 | + |
| 15 | +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. |
| 16 | + |
| 17 | +## Downloads |
| 18 | + |
| 19 | +Each of the distributions can be downloaded from: |
| 20 | + |
| 21 | +- [Microsoft .NET website](https://dotnet.microsoft.com/download/dotnet/8.0) |
| 22 | +- [.NET 8 release notes](README.md) |
| 23 | + |
| 24 | +[Container images](https://hub.docker.com/r/microsoft/dotnet/) are provided for Linux (Alpine, Debian, and Ubuntu). |
| 25 | + |
| 26 | +## Install using deb/rpm packages |
| 27 | + |
| 28 | +Preview release installers are not available from the Microsoft package repositories. The steps below provide an easy way to install .NET 8 using your Distro package manager. |
| 29 | + |
| 30 | +**Note:** `curl` must be available on the system before running the following steps. Once you have confirmed that `curl` is available, complete the steps to download and install the latest .NET 8 Preview SDK and Runtime. |
| 31 | + |
| 32 | +1. Create a directory to use for the download location and change into that directory. For example, `mkdir $HOME/dotnet_install && cd $HOME/dotnet_install` |
| 33 | +2. Run `curl -L https://aka.ms/install-dotnet-preview -o install-dotnet-preview.sh` |
| 34 | +3. Run the script with `sudo bash install-dotnet-preview.sh` |
| 35 | + |
| 36 | +Here's what the script does. |
| 37 | + |
| 38 | +* Detects the distribution and version. The script supports platforms and versions listed in [.NET 8.0 - Supported OS versions](https://github.com/dotnet/core/blob/main/release-notes/8.0/supported-os.md). |
| 39 | +* Determines if additional system dependencies or utilities are needed to successfully complete and install them. For example, `tar` is used to unpack that installer packages. |
| 40 | +* Downloads the tar.gz containing the .NET preview installer packages for the detected distribution. |
| 41 | +* Downloads the system dependency installer, if needed. |
| 42 | +* Expands the tar.gz into ./dotnet_packages |
| 43 | +* Attempts to install the contents of ./dotnet_packages using `rpm` or `dpkg`, as appropriate, for the detected distribution. |
| 44 | + |
| 45 | +## Install using Snap |
| 46 | + |
| 47 | +You can use Snap is to install and try .NET Previews on [Linux distributions that support Snap](https://docs.snapcraft.io/installing-snapd/6835). |
| 48 | + |
| 49 | +After configuring Snap on your system, run the following command to install the latest .NET SDK. |
| 50 | + |
| 51 | +`sudo snap install dotnet-sdk --channel=8.0/beta --classic` |
| 52 | + |
| 53 | +When .NET is installed using the Snap package, the default .NET 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 version you may have. This command can be aliased to `dotnet` with: |
| 54 | + |
| 55 | +`sudo snap alias dotnet-sdk.dotnet dotnet` |
| 56 | + |
| 57 | +**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](https://github.com/dotnet/core/blob/main/Documentation/linux-setup.md) for a possible resolution. |
| 58 | + |
| 59 | +## Installing from a binary archive |
| 60 | + |
| 61 | +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. |
| 62 | + |
| 63 | +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. |
| 64 | + |
| 65 | +```bash |
| 66 | +~# curl -Lo dotnet.tar.gz https://download.visualstudio.microsoft.com/download/pr/e2578737-231b-493c-a6ee-f181496fe679/18038808d2621094ebe172ca011a7c22/dotnet-sdk-8.0.100-preview.1.23115.2-linux-x64.tar.gz |
| 67 | +~# mkdir dotnet |
| 68 | +~# tar -C dotnet -xf dotnet.tar.gz |
| 69 | +~# rm dotnet.tar.gz |
| 70 | +~# export DOTNET_ROOT=~/dotnet |
| 71 | +~# export PATH=$PATH:~/dotnet |
| 72 | +~# dotnet --version |
| 73 | +8.0.100-preview.1.23115.2 |
| 74 | +``` |
| 75 | + |
| 76 | +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. |
| 77 | + |
| 78 | +You can add your .NET install location permanently to your path if you'd like. |
0 commit comments