add updated install docs for 5.0
This commit is contained in:
Lee Coward
parent
531d62775f
commit
f6fd34158d
63
release-notes/5.0/install-linux.md
Normal file
63
release-notes/5.0/install-linux.md
Normal file
|
|
@ -0,0 +1,63 @@
|
|||
# .NET 5 installation instructions for Linux
|
||||
|
||||
The following instructions demonstrate installing .NET 5 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.
|
||||
|
||||
[Linux package dependencies](linux-packages.md) describes the set of packages required to run .NET on Linux.
|
||||
|
||||
## Distributions
|
||||
|
||||
The following distributions are available for Linux:
|
||||
|
||||
- .NET SDK: includes tools for building and testing applications, and includes the runtime distributions that follow.
|
||||
- .NET Runtime: includes the .NET runtime and libraries, enabling running console applications.
|
||||
- ASP.NET Core Runtime: includes the .NET and ASP.NET Core runtimes, enabling running console, and web applications.
|
||||
|
||||
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.
|
||||
|
||||
## Downloads
|
||||
|
||||
Each of the distributions can be downloaded from:
|
||||
|
||||
- [Microsoft .NET website](https://dotnet.microsoft.com/download/dotnet/5.0)
|
||||
- [.NET 5 release notes](README.md)
|
||||
|
||||
[Container images](https://hub.docker.com/r/microsoft/dotnet/) are provided for Linux (Alpine, Debian, and Ubuntu).
|
||||
|
||||
## Install using deb/rpm packages
|
||||
|
||||
DEB and RPM install packages for Linux are available from Microsoft or, natively from some Linux distrobutions. It is recommended that you use packages provided by distrobution, when available. See [Install .NET on Linux](https://docs.microsoft.com/en-us/dotnet/core/install/linux) for a complete list of supported Linux Distros and installer package options for each.
|
||||
|
||||
## Install using Snap
|
||||
|
||||
You can use Snap is to install and try .NET Previews on [Linux distributions that support Snap](https://docs.snapcraft.io/installing-snapd/6735).
|
||||
|
||||
After configuring Snap on your system, run the following command to install the latest .NET Core SDK.
|
||||
|
||||
`sudo snap install dotnet-sdk --channel=5.0/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](https://github.com/dotnet/core/blob/main/Documentation/linux-setup.md) for a possible resolution.
|
||||
|
||||
## Installing from a binary archive
|
||||
|
||||
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.
|
||||
|
||||
```bash
|
||||
~# curl -o dotnet.tar.gz http://aka.ms/dotnet/5.0/dotnet-sdk-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
|
||||
5.0.301
|
||||
```
|
||||
|
||||
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.
|
||||
49
release-notes/5.0/install-macos.md
Normal file
49
release-notes/5.0/install-macos.md
Normal file
|
|
@ -0,0 +1,49 @@
|
|||
# .NET 5 installation instructions for macOS
|
||||
|
||||
The following instructions demonstrate installing .NET 5 on macOS. These instructions augment the more general [.NET install instructions](install.md), including installing with `.tar.gz` files, that work on multiple operating systems.
|
||||
|
||||
## Distributions
|
||||
|
||||
The following distributions are available for Linux:
|
||||
|
||||
- .NET SDK: includes tools for building and testing applications, and includes the runtime distributions that follow.
|
||||
- .NET Runtime: includes the .NET runtime and libraries, enabling running console applications.
|
||||
- ASP.NET Core Runtime: includes the .NET and ASP.NET Core runtimes, enabling running console, and web applications.
|
||||
|
||||
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.
|
||||
|
||||
## Downloads
|
||||
|
||||
Each of the distributions can be downloaded from:
|
||||
|
||||
- [Microsoft .NET website](https://dotnet.microsoft.com/download/dotnet/5.0)
|
||||
- [.NET 5 release notes](README.md)
|
||||
|
||||
[Container images](https://hub.docker.com/r/microsoft/dotnet/) are provided for Linux (Alpine, Debian, and Ubuntu).
|
||||
|
||||
## Install using PKG
|
||||
|
||||
You can install any of the distributions with PKG. The following image demonstrates installing the .NET SDK. After launching the PKG, click "Continue" and you will be taken through the process of installing the SDK.
|
||||
|
||||
|
||||
|
||||
## Installing from a binary archive
|
||||
|
||||
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.
|
||||
|
||||
```bash
|
||||
~# curl -o dotnet.tar.gz http://aka.ms/dotnet/5.0/dotnet-sdk-osx-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
|
||||
5.0.301
|
||||
```
|
||||
|
||||
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.
|
||||
54
release-notes/5.0/install-windows.md
Normal file
54
release-notes/5.0/install-windows.md
Normal file
|
|
@ -0,0 +1,54 @@
|
|||
# .NET 5 installation instructions for Windows
|
||||
|
||||
The following instructions demonstrate installing .NET 5 on Windows. These instructions augment the more general [.NET install instructions](install.md), including installing with `.zip` files, that work on multiple operating systems.
|
||||
|
||||
## Distributions
|
||||
|
||||
The following distributions are available for Windows:
|
||||
|
||||
- .NET SDK: includes tools for building and testing applications, and includes the runtime distributions that follow.
|
||||
- .NET Runtime: includes the .NET runtime and libraries, enabling running console applications.
|
||||
- .NET Desktop Runtime: includes the .NET runtime and Windows desktop libraries, enabling running console, Windows Forms, and Windows Presentation Framework (WPF) applications.
|
||||
- ASP.NET Core Runtime: includes the .NET and ASP.NET Core runtimes, enabling running console, and web applications.
|
||||
- ASP.NET Core Hosting Bundle: includes the ASP.NET Core runtime and IIS support (for running both in- and out-of-process with IIS).
|
||||
|
||||
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.
|
||||
|
||||
## Downloads
|
||||
|
||||
Each of the distributions can be downloaded from:
|
||||
|
||||
- [Microsoft .NET website](https://dotnet.microsoft.com/download/dotnet/6.0)
|
||||
- [.NET 5 release notes](README.md)
|
||||
|
||||
[Container images](https://hub.docker.com/r/microsoft/dotnet/) are provided for Windows (Nano Server and Server Core) and Linux (Alpine, Debian, and Ubuntu).
|
||||
|
||||
## Install using MSI
|
||||
|
||||
You can install any of the distributions with MSI. The following image demonstrates installing the .NET SDK. After launching the MSI, click "Install" and you will be taken through the process of installing the SDK.
|
||||
|
||||
|
||||
|
||||
## Windows Server Hosting with IIS
|
||||
|
||||
You should install the Hosting Bundle MSI if you want to enable hosting ASP.NET Core with IIS.
|
||||
|
||||
## Installing from a binary archive
|
||||
|
||||
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.
|
||||
|
||||
```console
|
||||
C:\>curl -o dotnet.zip http://aka.ms/dotnet/5.0/dotnet-sdk-win-x64.zip
|
||||
C:\>tar -C dotnet -xf dotnet.zip
|
||||
C:\>del dotnet.zip
|
||||
C:\>set DOTNET_ROOT=C:\dotnet
|
||||
C:\>set PATH=%PATH%;C:\dotnet
|
||||
C:\>dotnet --version
|
||||
5.0.301
|
||||
```
|
||||
|
||||
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.
|
||||
64
release-notes/5.0/install.md
Normal file
64
release-notes/5.0/install.md
Normal file
|
|
@ -0,0 +1,64 @@
|
|||
# .NET 5 installation instructions
|
||||
|
||||
Concise install instructions are provided in this document and may be augmented in [release notes](README.md) for a given update. Complete [.NET installation instructions for Windows, macOS, and Linux](https://docs.microsoft.com/dotnet/core/install/) are provided for supported releases in [.NET documentation](https://docs.microsoft.com/dotnet).
|
||||
|
||||
Operating system specific instructions:
|
||||
|
||||
- [Linux](install-linux.md)
|
||||
- [macOS](install-macos.md)
|
||||
- [Windows](install-windows.md)
|
||||
|
||||
## Distributions
|
||||
|
||||
The following distributions are available for all operating systems:
|
||||
|
||||
- .NET SDK: includes tools for building and testing applications, and includes the runtime distributions that follow.
|
||||
- .NET Runtime: includes the .NET runtime and libraries, enabling running console applications.
|
||||
- ASP.NET Core Runtime: includes the .NET and ASP.NET Core runtimes, enabling running console, and web applications.
|
||||
|
||||
We recommend that 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.
|
||||
|
||||
## Downloads
|
||||
|
||||
Download links are provided for each of the distributions at:
|
||||
|
||||
- [Microsoft .NET website](https://dotnet.microsoft.com/download/dotnet/5.0)
|
||||
- [.NET 5 release notes](README.md)
|
||||
|
||||
[Container images](https://hub.docker.com/r/microsoft/dotnet/) are provided for Windows (Nano Server, and Server Core) and Linux (Alpine, Debian, and Ubuntu).
|
||||
|
||||
## What's installed?
|
||||
|
||||
You can determine what is installed on your machine (assuming .NET is installed) using the following approach, with `dotnet --info`.
|
||||
|
||||
```console
|
||||
# dotnet --info
|
||||
.NET SDK (reflecting any global.json):
|
||||
Version: 5.0.301
|
||||
Commit: ef17233f86
|
||||
|
||||
Runtime Environment:
|
||||
OS Name: fedora
|
||||
OS Version: 34
|
||||
OS Platform: Linux
|
||||
RID: fedora.34-x64
|
||||
Base Path: /dotnet/sdk/5.0.301/
|
||||
|
||||
Host (useful for support):
|
||||
Version: 5.0.7
|
||||
Commit: 556582d964
|
||||
|
||||
.NET SDKs installed:
|
||||
5.0.301 [/dotnet/sdk]
|
||||
|
||||
.NET runtimes installed:
|
||||
Microsoft.AspNetCore.App 5.0.7 [/dotnet/shared/Microsoft.AspNetCore.App]
|
||||
Microsoft.NETCore.App 5.0.7 [/dotnet/shared/Microsoft.NETCore.App]
|
||||
```
|
||||
|
||||
If you have the .NET SDK installed, you can also use `dotnet --version` as demonstrated in the following example:
|
||||
|
||||
```console
|
||||
C:\>dotnet --version
|
||||
5.0.301
|
||||
```
|
||||
115
release-notes/5.0/linux-packages.md
Normal file
115
release-notes/5.0/linux-packages.md
Normal file
|
|
@ -0,0 +1,115 @@
|
|||
# Linux package dependencies
|
||||
|
||||
.NET 5 has several dependencies that must be satisfied to run .NET apps. The commands to install these libraries are listed for multiple Linux distributions.
|
||||
|
||||
Feel free to contribute packages for distributions not (yet) listed in this document, including ones not supported by the .NET Team.
|
||||
|
||||
Tips:
|
||||
|
||||
- [runtime-deps container images](https://github.com/dotnet/dotnet-docker/tree/main/src/runtime-deps) installs these same packages. You can look at those dockerfiles.
|
||||
- [pkgs.org](https://pkgs.org/) is a useful site for searching for packages, to find the one for your distribution.
|
||||
|
||||
## Packages
|
||||
|
||||
.NET depends on the following packages.
|
||||
|
||||
- [GNU C Library (glibc)](https://www.gnu.org/software/libc/libc.html)
|
||||
- [GNU C++ Library](https://gcc.gnu.org/onlinedocs/libstdc++/)
|
||||
- [GCC low-level runtime library](https://gcc.gnu.org/onlinedocs/gccint/Libgcc.html)
|
||||
- [ICU](http://site.icu-project.org/)
|
||||
- [Kerberos](http://web.mit.edu/kerberos/)
|
||||
- [Open SSL](https://www.openssl.org/)
|
||||
- [zlib compression library](https://www.zlib.net/)
|
||||
|
||||
You do not need to install ICU if you [enable globalization invariant mode](https://github.com/dotnet/runtime/blob/main/docs/design/features/globalization-invariant-mode.md#enabling-the-invariant-mode).
|
||||
|
||||
If your app relies on `https` endpoints, you'll also need to install `ca-certificates`.
|
||||
|
||||
## Alpine 3.13
|
||||
|
||||
```bash
|
||||
sudo apk add \
|
||||
krb5-libs \
|
||||
libgcc \
|
||||
libintl \
|
||||
libssl1.1 \
|
||||
libstdc++ \
|
||||
zlib
|
||||
```
|
||||
|
||||
## Debian 11 "Bullseye"
|
||||
|
||||
```bash
|
||||
sudo apt-get update \
|
||||
&& sudo apt-get install -y --no-install-recommends \
|
||||
libc6 \
|
||||
libgcc1 \
|
||||
libgssapi-krb5-2 \
|
||||
libicu67 \
|
||||
libssl1.1 \
|
||||
libstdc++6 \
|
||||
zlib1g
|
||||
```
|
||||
|
||||
## Debian 10 "Buster"
|
||||
|
||||
```bash
|
||||
sudo apt-get update \
|
||||
&& sudo apt-get install -y --no-install-recommends \
|
||||
libc6 \
|
||||
libgcc1 \
|
||||
libgssapi-krb5-2 \
|
||||
libicu63 \
|
||||
libssl1.1 \
|
||||
libstdc++6 \
|
||||
zlib1g
|
||||
```
|
||||
|
||||
## Ubuntu 20.04 "Focal"
|
||||
|
||||
```bash
|
||||
sudo apt-get update \
|
||||
&& sudo apt-get install -y --no-install-recommends \
|
||||
libc6 \
|
||||
libgcc1 \
|
||||
libgssapi-krb5-2 \
|
||||
libicu66 \
|
||||
libssl1.1 \
|
||||
libstdc++6 \
|
||||
zlib1g
|
||||
```
|
||||
|
||||
Note: Add [noninteractive](https://github.com/dotnet/dotnet-docker/blob/c0e8be8a44b47b1dcc2a5b4b2ebd92022087ac0b/src/runtime-deps/3.1/focal/arm64v8/Dockerfile#L4) for non-interactive installation.
|
||||
|
||||
## Ubuntu 18.04 "Bionic"
|
||||
|
||||
```bash
|
||||
sudo apt-get update \
|
||||
&& sudo apt-get install -y --no-install-recommends \
|
||||
libc6 \
|
||||
libgcc1 \
|
||||
libgssapi-krb5-2 \
|
||||
libicu60 \
|
||||
libssl1.1 \
|
||||
libstdc++6 \
|
||||
zlib1g \
|
||||
```
|
||||
|
||||
## Community supported distros
|
||||
|
||||
The following distros are not supported by the .NET team. The following package information is provided on an as-is basis. Feel free contribute package information for the distro you use .NET with if it isn't listed.
|
||||
|
||||
### Arch Linux
|
||||
|
||||
```bash
|
||||
sudo pacman -Sy \
|
||||
glibc \
|
||||
gcc \
|
||||
krb5 \
|
||||
icu \
|
||||
openssl \
|
||||
libc++ \
|
||||
zlib
|
||||
```
|
||||
|
||||
This set of packages was tested on the Arch and Manjaro.
|
||||
Loading…
Reference in a new issue