diff --git a/docs/core/install/includes/linux-install-60-apt.md b/docs/core/install/includes/linux-install-60-apt.md index 0d032d90b2fb4..fce939195c8a9 100644 --- a/docs/core/install/includes/linux-install-60-apt.md +++ b/docs/core/install/includes/linux-install-60-apt.md @@ -19,7 +19,7 @@ sudo apt-get update && \ ### Install .NET 6 Runtime -Both .NET Runtime and the ASP.NET Core Runtime allow you to run apps that were made with .NET that didn't provide the runtime. The following commands install the ASP.NET Core Runtime, which is the most compatible runtime for .NET. In your terminal, run the following commands: +The ASP.NET Core Runtime allows you to run apps that were made with .NET that didn't provide the runtime. The following command installs the ASP.NET Core Runtime, which is the most compatible runtime for .NET. In your terminal, run the following commands: ```bash sudo apt-get update && \ diff --git a/docs/core/install/includes/linux-install-60-dnf.md b/docs/core/install/includes/linux-install-60-dnf.md index d215a5710d4d2..25cb6c2687901 100644 --- a/docs/core/install/includes/linux-install-60-dnf.md +++ b/docs/core/install/includes/linux-install-60-dnf.md @@ -15,7 +15,7 @@ sudo dnf install dotnet-sdk-6.0 ### Install the runtime -The ASP.NET Core Runtime allows you to run apps that were made with .NET that didn't provide the runtime. The following command install the ASP.NET Core Runtime, which is the most compatible runtime for .NET. In your terminal, run the following command: +The ASP.NET Core Runtime allows you to run apps that were made with .NET that didn't provide the runtime. The following command installs the ASP.NET Core Runtime, which is the most compatible runtime for .NET. In your terminal, run the following command: ```bash sudo dnf install aspnetcore-runtime-6.0 diff --git a/docs/core/install/includes/linux-install-80-apk.md b/docs/core/install/includes/linux-install-80-apk.md new file mode 100644 index 0000000000000..9384d5071e090 --- /dev/null +++ b/docs/core/install/includes/linux-install-80-apk.md @@ -0,0 +1,28 @@ +--- +author: adegeo +ms.author: adegeo +ms.date: 11/14/2023 +ms.topic: include +--- + +### Install the SDK + +The .NET SDK allows you to develop apps with .NET. If you install the .NET SDK, you don't need to install the corresponding runtime. To install the .NET SDK, run the following command: + +```bash +sudo apk add dotnet8-sdk +``` + +### Install the runtime + +The ASP.NET Core Runtime allows you to run apps that were made with .NET that didn't provide the runtime. The following command installs the ASP.NET Core Runtime, which is the most compatible runtime for .NET. In your terminal, run the following command: + +```bash +sudo apk add aspnetcore8-runtime +``` + +As an alternative to the ASP.NET Core Runtime, you can install the .NET Runtime, which doesn't include ASP.NET Core support: replace `aspnetcore8-runtime` in the previous command with `dotnet8-runtime`: + +```bash +sudo apk add dotnet8-runtime +``` diff --git a/docs/core/install/includes/linux-install-80-apt.md b/docs/core/install/includes/linux-install-80-apt.md new file mode 100644 index 0000000000000..8fc902a3d5d48 --- /dev/null +++ b/docs/core/install/includes/linux-install-80-apt.md @@ -0,0 +1,36 @@ +--- +author: adegeo +ms.author: adegeo +ms.date: 11/14/2023 +ms.topic: include +--- + +### Install the SDK + +The .NET SDK allows you to develop apps with .NET. If you install the .NET SDK, you don't need to install the corresponding runtime. To install the .NET SDK, run the following commands: + +```bash +sudo apt-get update && \ + sudo apt-get install -y dotnet-sdk-8.0 +``` + +> [!IMPORTANT] +> If you receive an error message similar to **Unable to locate package dotnet-sdk-8.0**, see the [troubleshooting](#troubleshooting) section. + +### Install the runtime + +The ASP.NET Core Runtime allows you to run apps that were made with .NET that didn't provide the runtime. The following commands install the ASP.NET Core Runtime, which is the most compatible runtime for .NET. In your terminal, run the following commands: + +```bash +sudo apt-get update && \ + sudo apt-get install -y aspnetcore-runtime-8.0 +``` + +> [!IMPORTANT] +> If you receive an error message similar to **Unable to locate package aspnetcore-runtime-8.0**, see the [troubleshooting](#troubleshooting) section. + +As an alternative to the ASP.NET Core Runtime, you can install the .NET Runtime, which doesn't include ASP.NET Core support: replace `aspnetcore-runtime-8.0` in the previous command with `dotnet-runtime-8.0`: + +```bash +sudo apt-get install -y dotnet-runtime-8.0 +``` diff --git a/docs/core/install/includes/linux-install-80-dnf.md b/docs/core/install/includes/linux-install-80-dnf.md new file mode 100644 index 0000000000000..abb235086d026 --- /dev/null +++ b/docs/core/install/includes/linux-install-80-dnf.md @@ -0,0 +1,28 @@ +--- +author: adegeo +ms.author: adegeo +ms.date: 11/14/2023 +ms.topic: include +--- + +### Install the SDK + +The .NET SDK allows you to develop apps with .NET. If you install the .NET SDK, you don't need to install the corresponding runtime. To install the .NET SDK, run the following command: + +```bash +sudo dnf install dotnet-sdk-8.0 +``` + +### Install the runtime + +The ASP.NET Core Runtime allows you to run apps that were made with .NET that didn't provide the runtime. The following command installs the ASP.NET Core Runtime, which is the most compatible runtime for .NET. In your terminal, run the following command: + +```bash +sudo dnf install aspnetcore-runtime-8.0 +``` + +As an alternative to the ASP.NET Core Runtime, you can install the .NET Runtime, which doesn't include ASP.NET Core support: replace `aspnetcore-runtime-8.0` in the previous command with `dotnet-runtime-8.0`: + +```bash +sudo dnf install dotnet-runtime-8.0 +``` diff --git a/docs/core/install/includes/linux-install-80-yum.md b/docs/core/install/includes/linux-install-80-yum.md new file mode 100644 index 0000000000000..b2c8eea90e365 --- /dev/null +++ b/docs/core/install/includes/linux-install-80-yum.md @@ -0,0 +1,28 @@ +--- +author: adegeo +ms.author: adegeo +ms.date: 11/14/2023 +ms.topic: include +--- + +### Install the SDK + +The .NET SDK allows you to develop apps with .NET. If you install the .NET SDK, you don't need to install the corresponding runtime. To install the .NET SDK, run the following command: + +```bash +sudo yum install dotnet-sdk-8.0 +``` + +### Install the runtime + +The ASP.NET Core Runtime allows you to run apps that were made with .NET that didn't provide the runtime. The following command installs the ASP.NET Core Runtime, which is the most compatible runtime for .NET. In your terminal, run the following command: + +```bash +sudo yum install aspnetcore-runtime-8.0 +``` + +As an alternative to the ASP.NET Core Runtime, you can install the .NET Runtime, which doesn't include ASP.NET Core support: replace `aspnetcore-runtime-8.0` in the previous command with `dotnet-runtime-8.0`: + +```bash +sudo yum install dotnet-runtime-8.0 +``` diff --git a/docs/core/install/includes/linux-install-80-zyp.md b/docs/core/install/includes/linux-install-80-zyp.md new file mode 100644 index 0000000000000..24da2a516f57e --- /dev/null +++ b/docs/core/install/includes/linux-install-80-zyp.md @@ -0,0 +1,28 @@ +--- +author: adegeo +ms.author: adegeo +ms.date: 11/14/2023 +ms.topic: include +--- + +### Install the SDK + +The .NET SDK allows you to develop apps with .NET. If you install the .NET SDK, you don't need to install the corresponding runtime. To install the .NET SDK, run the following command: + +```bash +sudo zypper install dotnet-sdk-8.0 +``` + +### Install the runtime + +The ASP.NET Core Runtime allows you to run apps that were made with .NET that didn't provide the runtime. The following command installs the ASP.NET Core Runtime, which is the most compatible runtime for .NET. In your terminal, run the following command: + +```bash +sudo zypper install aspnetcore-runtime-8.0 +``` + +As an alternative to the ASP.NET Core Runtime, you can install the .NET Runtime, which doesn't include ASP.NET Core support: replace `aspnetcore-runtime-8.0` in the previous command with `dotnet-runtime-8.0`: + +```bash +sudo zypper install dotnet-runtime-8.0 +``` diff --git a/docs/core/install/includes/linux-install-package-manager-x64-vs-arm.md b/docs/core/install/includes/linux-install-package-manager-x64-vs-arm.md index e489ab015524c..c2ab91ee69e2f 100644 --- a/docs/core/install/includes/linux-install-package-manager-x64-vs-arm.md +++ b/docs/core/install/includes/linux-install-package-manager-x64-vs-arm.md @@ -1,3 +1,9 @@ +--- +author: adegeo +ms.author: adegeo +ms.date: 11/14/2023 +ms.topic: include +--- > [!IMPORTANT] > Package manager installs are only supported on the **x64** architecture. Other architectures, such as **Arm**, must install .NET by some other means such as with Snap, an installer script, or through a manual binary installation. diff --git a/docs/core/install/includes/linux-intro-sdk-vs-runtime.md b/docs/core/install/includes/linux-intro-sdk-vs-runtime.md index 8b0c922b77116..37dd92653cd41 100644 --- a/docs/core/install/includes/linux-intro-sdk-vs-runtime.md +++ b/docs/core/install/includes/linux-intro-sdk-vs-runtime.md @@ -1,3 +1,9 @@ +--- +author: adegeo +ms.author: adegeo +ms.date: 11/14/2023 +ms.topic: include +--- Install the SDK (which includes the runtime) if you want to develop .NET apps. Or, if you only need to run apps, install the Runtime. If you're installing the Runtime, we suggest you install the **ASP.NET Core Runtime** as it includes both .NET and ASP.NET Core runtimes. diff --git a/docs/core/install/includes/linux-prep-intro-apt.md b/docs/core/install/includes/linux-prep-intro-apt.md index 7c9d0cb9cce74..dca784eb3626c 100644 --- a/docs/core/install/includes/linux-prep-intro-apt.md +++ b/docs/core/install/includes/linux-prep-intro-apt.md @@ -1,3 +1,9 @@ +--- +author: adegeo +ms.author: adegeo +ms.date: 11/14/2023 +ms.topic: include +--- Installing with APT can be done with a few commands. Before you install .NET, run the following commands to add the Microsoft package signing key to your list of trusted keys and add the package repository. diff --git a/docs/core/install/includes/linux-prep-intro-generic.md b/docs/core/install/includes/linux-prep-intro-generic.md index 053bae13b26e9..852de358234cc 100644 --- a/docs/core/install/includes/linux-prep-intro-generic.md +++ b/docs/core/install/includes/linux-prep-intro-generic.md @@ -1,2 +1,8 @@ +--- +author: adegeo +ms.author: adegeo +ms.date: 11/14/2023 +ms.topic: include +--- Before you install .NET, run the following commands to add the Microsoft package signing key to your list of trusted keys and add the Microsoft package repository. Open a terminal and run the following commands: diff --git a/docs/core/install/includes/linux-release-wait.md b/docs/core/install/includes/linux-release-wait.md new file mode 100644 index 0000000000000..f2fad00fcdb12 --- /dev/null +++ b/docs/core/install/includes/linux-release-wait.md @@ -0,0 +1,9 @@ +--- +author: adegeo +ms.author: adegeo +ms.date: 11/14/2023 +ms.topic: include +--- + +> [!IMPORTANT] +> .NET 8 was released on November 14, 2023. It may take time for the packages to appear in the package manager feeds. diff --git a/docs/core/install/includes/linux-rpm-install-dependencies.md b/docs/core/install/includes/linux-rpm-install-dependencies.md index d38f2fd1698ed..c242d59e566cc 100644 --- a/docs/core/install/includes/linux-rpm-install-dependencies.md +++ b/docs/core/install/includes/linux-rpm-install-dependencies.md @@ -1,3 +1,9 @@ +--- +author: adegeo +ms.author: adegeo +ms.date: 11/14/2023 +ms.topic: include +--- When you install with a package manager, these libraries are installed for you. But, if you manually install .NET or you publish a self-contained app, you'll need to make sure these libraries are installed: diff --git a/docs/core/install/includes/linux-uninstall-preview-info.md b/docs/core/install/includes/linux-uninstall-preview-info.md index 190f169f73167..d9b522381463e 100644 --- a/docs/core/install/includes/linux-uninstall-preview-info.md +++ b/docs/core/install/includes/linux-uninstall-preview-info.md @@ -1,2 +1,8 @@ +--- +author: adegeo +ms.author: adegeo +ms.date: 11/14/2023 +ms.topic: include +--- When using a package manager to manage your installation of .NET, you may run into a conflict if you've previously installed a preview release. The package manager may interpret the non-preview release as an earlier version of .NET. To install the non-preview release, first uninstall the preview versions. For more information about uninstalling .NET, see [How to remove the .NET Runtime and SDK](../remove-runtime-sdk-versions.md?pivots=os-linux#uninstall-net). diff --git a/docs/core/install/includes/package-manager-failed-to-fetch-deb.md b/docs/core/install/includes/package-manager-failed-to-fetch-deb.md index 8f539b07037e4..c35059a0d706a 100644 --- a/docs/core/install/includes/package-manager-failed-to-fetch-deb.md +++ b/docs/core/install/includes/package-manager-failed-to-fetch-deb.md @@ -1,2 +1,8 @@ +--- +author: adegeo +ms.author: adegeo +ms.date: 11/14/2023 +ms.topic: include +--- While installing the .NET package, you may see an error similar to `Failed to fetch ... File has unexpected size ... Mirror sync in progress?`. This error could mean that the package feed for .NET is being upgraded with newer package versions, and that you should try again later. During an upgrade, the package feed shouldn't be unavailable for more than 30 minutes. If you continually receive this error for more than 30 minutes, please file an issue at . diff --git a/docs/core/install/includes/package-manager-failed-to-fetch-rpm.md b/docs/core/install/includes/package-manager-failed-to-fetch-rpm.md index 761374ffb4fa7..4e7b525864504 100644 --- a/docs/core/install/includes/package-manager-failed-to-fetch-rpm.md +++ b/docs/core/install/includes/package-manager-failed-to-fetch-rpm.md @@ -1,2 +1,8 @@ +--- +author: adegeo +ms.author: adegeo +ms.date: 11/14/2023 +ms.topic: include +--- While installing the .NET package, you may see an error similar to `signature verification failed for file 'repomd.xml' from repository 'packages-microsoft-com-prod'`. Generally speaking, this error means that the package feed for .NET is being upgraded with newer package versions, and that you should try again later. During an upgrade, the package feed should not be unavailable for more than 2 hours. If you continually receive this error for more than 2 hours, please file an issue at . diff --git a/docs/core/install/includes/package-manager-failed-to-find-deb.md b/docs/core/install/includes/package-manager-failed-to-find-deb.md index 641f1698f61ce..73e9554391599 100644 --- a/docs/core/install/includes/package-manager-failed-to-find-deb.md +++ b/docs/core/install/includes/package-manager-failed-to-find-deb.md @@ -1,10 +1,16 @@ +--- +author: adegeo +ms.author: adegeo +ms.date: 11/14/2023 +ms.topic: include +--- If you receive an error message similar to **Unable to locate package {dotnet-package}** or **Some packages could not be installed**, run the following commands. There are two placeholders in the following set of commands. - `{dotnet-package}`\ -This represents the .NET package you're installing, such as `aspnetcore-runtime-7.0`. This is used in the following `sudo apt-get install` command. +This represents the .NET package you're installing, such as `aspnetcore-runtime-8.0`. This is used in the following `sudo apt-get install` command. - `{os-version}`\ This represents the distribution version you're on. This is used in the `wget` command below. The distribution version is the numerical value, such as `20.04` on Ubuntu or `10` on Debian. diff --git a/docs/core/install/includes/package-manager-heading-hack-pkgname.md b/docs/core/install/includes/package-manager-heading-hack-pkgname.md index c786f86063ee6..618cb426e0e0c 100644 --- a/docs/core/install/includes/package-manager-heading-hack-pkgname.md +++ b/docs/core/install/includes/package-manager-heading-hack-pkgname.md @@ -1,3 +1,9 @@ +--- +author: adegeo +ms.author: adegeo +ms.date: 11/14/2023 +ms.topic: include +--- All versions of .NET are available for download at , but require [manual installation](../linux-scripted-manual.md). You can try and use the package manager to install a different version of .NET. However, the requested version may not be available. @@ -18,8 +24,8 @@ Chooses the SDK or the runtime. Valid options are: - **version**\ The version of the SDK or runtime to install. This article will always give the instructions for the latest supported version. Valid options are any released version, such as: - - 7.0 - - 5.0 + - 8.0 + - 6.0 - 3.1 - 2.1 @@ -27,11 +33,11 @@ The version of the SDK or runtime to install. This article will always give the ### Examples -- Install the ASP.NET Core 7.0 runtime: `aspnetcore-runtime-7.0` +- Install the ASP.NET Core 8.0 runtime: `aspnetcore-runtime-8.0` - Install the .NET Core 2.1 runtime: `dotnet-runtime-2.1` - Install the .NET 5 SDK: `dotnet-sdk-5.0` - Install the .NET Core 3.1 SDK: `dotnet-sdk-3.1` ### Package missing -If the package-version combination doesn't work, it's not available. For example, there isn't an ASP.NET Core SDK, the SDK components are included with the .NET SDK. The value `aspnetcore-sdk-7.0` is incorrect and should be `dotnet-sdk-7.0`. For a list of Linux distributions supported by .NET, see [.NET dependencies and requirements](../linux.md). +If the package-version combination doesn't work, it's not available. For example, there isn't an ASP.NET Core SDK, the SDK components are included with the .NET SDK. The value `aspnetcore-sdk-8.0` is incorrect and should be `dotnet-sdk-8.0`. For a list of Linux distributions supported by .NET, see [.NET dependencies and requirements](../linux.md). diff --git a/docs/core/install/includes/verify-download-macos-linux.md b/docs/core/install/includes/verify-download-macos-linux.md index 33b6cc14de645..96263315cbfb8 100644 --- a/docs/core/install/includes/verify-download-macos-linux.md +++ b/docs/core/install/includes/verify-download-macos-linux.md @@ -1,15 +1,15 @@ --- author: adegeo ms.author: adegeo -ms.date: 06/21/2023 +ms.date: 11/14/2023 ms.topic: include --- -Use the `sha512sum` command to print the checksum of the file you've downloaded. For example, the following command reports the checksum of the _dotnet-sdk-7.0.304-linux-x64.tar.gz_ file: +Use the `sha512sum` command to print the checksum of the file you've downloaded. For example, the following command reports the checksum of the _dotnet-sdk-8.0.100-linux-x64.tar.gz_ file: ```bash -$ sha512sum dotnet-sdk-7.0.304-linux-x64.tar.gz -f4b7d0cde432bd37f445363b3937ad483e5006794886941e43124de051475925b3cd11313b73d2cae481ee9b8f131394df0873451f6088ffdbe73f150b1ed727 dotnet-sdk-7.0.304-linux-x64.tar.gz +$ sha512sum dotnet-sdk-8.0.100-linux-x64.tar.gz +13905ea20191e70baeba50b0e9bbe5f752a7c34587878ee104744f9fb453bfe439994d38969722bdae7f60ee047d75dda8636f3ab62659450e9cd4024f38b2a5 dotnet-sdk-8.0.100-linux-x64.tar.gz ``` Compare the checksum with the value provided by the download site. @@ -21,11 +21,11 @@ Compare the checksum with the value provided by the download site. The .NET release notes contain a link to a checksum file you can use to validate your downloaded file. The following steps describe how to download the checksum file and validate a .NET install binary: -01. The release notes page for .NET 7 on GitHub at contains a section named **Releases**. The table in that section links to the downloads and checksum files for each .NET 7 release: +01. The release notes page for .NET 8 on GitHub at contains a section named **Releases**. The table in that section links to the downloads and checksum files for each .NET 8 release: :::image type="content" source="../media/install-sdk/release-notes-root.png" alt-text="The github release notes version table for .NET"::: -01. Select the link for the version of .NET that you downloaded. The previous section used .NET SDK 7.0.304, which is in the .NET 7.0.7 release. +01. Select the link for the version of .NET that you downloaded. The previous section used .NET SDK 8.0.100, which is in the .NET 8.0.0 release. 01. In the release page, you can see the .NET Runtime and .NET SDK version, and a link to the checksum file: @@ -36,7 +36,7 @@ The .NET release notes contain a link to a checksum file you can use to validate 01. Use the following script, but replace the link to download the appropriate checksum file: ```bash - curl -O https://dotnetcli.blob.core.windows.net/dotnet/checksums/7.0.7-sha.txt + curl -O https://dotnetcli.blob.core.windows.net/dotnet/checksums/8.0.0-sha.txt ``` 01. With both the checksum file and the .NET release file downloaded to the same directory, use the `sha512sum -c {file} --ignore-missing` command to validate the downloaded file. @@ -44,15 +44,15 @@ The .NET release notes contain a link to a checksum file you can use to validate When validation passes, you see the file printed with the **OK** status: ```bash - $ sha512sum -c 7.0.7-sha.txt --ignore-missing - dotnet-sdk-7.0.304-linux-x64.tar.gz: OK + $ sha512sum -c 8.0.0-sha.txt --ignore-missing + dotnet-sdk-8.0.100-linux-x64.tar.gz: OK ``` If you see the file marked as **FAILED**, the file you downloaded isn't valid and shouldn't be used. ```bash - $ sha512sum -c 7.0.7-sha.txt --ignore-missing - dotnet-sdk-7.0.304-linux-x64.tar.gz: FAILED + $ sha512sum -c 8.0.0-sha.txt --ignore-missing + dotnet-sdk-8.0.100-linux-x64.tar.gz: FAILED sha512sum: WARNING: 1 computed checksum did NOT match - sha512sum: 7.0.7-sha.txt: no file was verified + sha512sum: 8.0.0-sha.txt: no file was verified ``` diff --git a/docs/core/install/includes/verify-download-windows.md b/docs/core/install/includes/verify-download-windows.md index 667adb045aef7..b33ee0d8c9224 100644 --- a/docs/core/install/includes/verify-download-windows.md +++ b/docs/core/install/includes/verify-download-windows.md @@ -1,22 +1,22 @@ --- author: adegeo ms.author: adegeo -ms.date: 06/21/2023 +ms.date: 11/14/2023 ms.topic: include --- -You can use **PowerShell** or **Command Prompt** to validate the checksum of the file you've downloaded. For example, the following command reports the checksum of the _dotnet-sdk-7.0.304-win-x64.exe_ file: +You can use **PowerShell** or **Command Prompt** to validate the checksum of the file you've downloaded. For example, the following command reports the checksum of the _dotnet-sdk-8.0.100-win-x64.exe_ file: ```cmd -> certutil -hashfile dotnet-sdk-7.0.304-win-x64.exe SHA512 -SHA512 hash of dotnet-sdk-7.0.304-win-x64.exe: -648732c79f6276c37a92e211b4c5b6cf84a0a54637c0f85949ced96d31838b43a4dcae905ef70bafbc9edd3542400746fb1e00c4c84679713e97219493a45938 +> certutil -hashfile dotnet-sdk-8.0.100-win-x64.exe SHA512 +SHA512 hash of dotnet-sdk-8.0.100-win-x64.exe: +248acec95b381e5302255310fb9396267fd74a4a2dc2c3a5989031969cb31f8270cbd14bda1bc0352ac90f8138bddad1a58e4af1e56cc4a1613b1cf2854b518e CertUtil: -hashfile command completed successfully. ``` ```powershell -> (Get-FileHash .\dotnet-sdk-7.0.304-win-x64.exe -Algorithm SHA512).Hash -648732C79F6276C37A92E211B4C5B6CF84A0A54637C0F85949CED96D31838B43A4DCAE905EF70BAFBC9EDD3542400746FB1E00C4C84679713E97219493A45938 +> (Get-FileHash .\dotnet-sdk-8.0.100-win-x64.exe -Algorithm SHA512).Hash +248acec95b381e5302255310fb9396267fd74a4a2dc2c3a5989031969cb31f8270cbd14bda1bc0352ac90f8138bddad1a58e4af1e56cc4a1613b1cf2854b518e ``` Compare the checksum with the value provided by the download site. @@ -25,11 +25,11 @@ Compare the checksum with the value provided by the download site. The .NET release notes contain a link to a checksum file you can use to validate your downloaded file. The following steps describe how to download the checksum file and validate a .NET install binary: -01. The release notes page for .NET 7 on GitHub at contains a section named **Releases**. The table in that section links to the downloads and checksum files for each .NET 7 release: +01. The release notes page for .NET 8 on GitHub at contains a section named **Releases**. The table in that section links to the downloads and checksum files for each .NET 8 release: :::image type="content" source="../media/install-sdk/release-notes-root.png" alt-text="The github release notes version table for .NET"::: -01. Select the link for the version of .NET that you downloaded. The previous section used .NET SDK 7.0.304, which is in the .NET 7.0.7 release. +01. Select the link for the version of .NET that you downloaded. The previous section used .NET SDK 8.0.100, which is in the .NET 8.0.0 release. > [!TIP] > If you're not sure which .NET release contains your checksum file, explore the links until you find it. @@ -43,7 +43,7 @@ The .NET release notes contain a link to a checksum file you can use to validate 01. Use the following script, but replace the link to download the appropriate checksum file: ```powershell - Invoke-WebRequest https://dotnetcli.blob.core.windows.net/dotnet/checksums/7.0.7-sha.txt -OutFile 7.0.7-sha.txt + Invoke-WebRequest https://dotnetcli.blob.core.windows.net/dotnet/checksums/8.0.0-sha.txt -OutFile 8.0.0-sha.txt ``` 01. With both the checksum file and the .NET release file downloaded to the same directory, search the checksum file for the checksum of the .NET download: @@ -51,7 +51,7 @@ The .NET release notes contain a link to a checksum file you can use to validate When validation passes, you see **True** printed: ```powershell - > (Get-Content .\7.0.7-sha.txt | Select-String "dotnet-sdk-7.0.304-win-x64.exe").Line -like (Get-FileHash .\dotnet-sdk-7.0.304-win-x64.exe -Algorithm SHA512).Hash + "*" + > (Get-Content .\8.0.0-sha.txt | Select-String "dotnet-sdk-8.0.100-win-x64.exe").Line -like (Get-FileHash .\dotnet-sdk-8.0.100-win-x64.exe -Algorithm SHA512).Hash + "*" True ``` diff --git a/docs/core/install/linux-alpine.md b/docs/core/install/linux-alpine.md index f7e0070ab3e9f..42e66ce5318b0 100644 --- a/docs/core/install/linux-alpine.md +++ b/docs/core/install/linux-alpine.md @@ -3,11 +3,13 @@ title: Install .NET on Alpine description: Demonstrates the various ways to install .NET SDK and .NET Runtime on Alpine. author: adegeo ms.author: adegeo -ms.date: 10/16/2023 +ms.date: 11/14/2023 --- # Install the .NET SDK or the .NET Runtime on Alpine +[!INCLUDE [linux-release-wait](includes/linux-release-wait.md)] + .NET is supported on Alpine and this article describes how to install .NET on Alpine. When an Alpine version falls out of support, .NET is no longer supported with that version. If you're using Docker, consider using [official .NET Docker images](../docker/introduction.md#net-images) instead of installing .NET yourself. @@ -19,6 +21,10 @@ The Alpine package manager supports installing some versions of .NET. If the .NE - [Use the .NET install script.](linux-scripted-manual.md#scripted-install) - [Download and install .NET manually.](linux-scripted-manual.md#manual-install) +## Install .NET 8 + +[!INCLUDE [linux-apk-install-80](includes/linux-install-80-apk.md)] + ## Install .NET 7 [!INCLUDE [linux-apk-install-70](includes/linux-install-70-apk.md)] @@ -33,8 +39,8 @@ The following table is a list of currently supported .NET releases and the versi | Alpine | Supported Version | Available in Package Manager | |--------|--------------------| -----------------------------| -| 3.18 | .NET 7.0, .NET 6.0 | .NET 7.0, .NET 6.0 | -| 3.17 | .NET 7.0, .NET 6.0 | .NET 7.0, .NET 6.0 | +| 3.18 | .NET 7.0, .NET 6.0 | .NET 8.0, .NET 7.0, .NET 6.0 | +| 3.17 | .NET 7.0, .NET 6.0 | .NET 8.0, .NET 7.0, .NET 6.0 | | 3.16 | .NET 7.0, .NET 6.0 | .NET 6.0 | | 3.15 | .NET 7.0, .NET 6.0 | None | @@ -44,16 +50,16 @@ The following table is a list of currently supported .NET releases and the versi The following table is a list of currently supported .NET releases and the architecture of Alpine they're supported on. These versions remain supported until either the version of [.NET reaches end-of-support](https://dotnet.microsoft.com/platform/support/policy/dotnet-core) or the architecture of [Alpine is supported#](https://alpinelinux.org/releases/). Note that only `x86_64`, `armv7`, `aarch64` is officially supported by Microsoft. Other architectures are supported by the distribution maintainers, and can be installed using the `apk` package manager. -| Architecture | .NET 6 | .NET 7 | -|------------------|------------------|---------| -| x86_64 | 3.16, 3.17, 3.18 | 3.17, 3.18 | -| x86 | None | None | -| aarch64 | 3.16, 3.17, 3.18 | 3.17, 3.18 | -| armv7 | 3.16, 3.17, 3.18 | 3.17, 3.18 | -| armhf | None | None | -| s390x | 3.17 | 3.17 | -| ppc64le | None | None | -| riscv64 | None | None | +| Architecture | .NET 6 | .NET 7 | .NET 8 | +|------------------|------------------|---------|---------| +| x86_64 | 3.16, 3.17, 3.18 | 3.17, 3.18 | 3.17, 3.18 | +| x86 | None | None | None | +| aarch64 | 3.16, 3.17, 3.18 | 3.17, 3.18 | 3.17, 3.18 | +| armv7 | 3.16, 3.17, 3.18 | 3.17, 3.18 | 3.17, 3.18 | +| armhf | None | None | None | +| s390x | 3.17 | 3.17 | 3.17 | +| ppc64le | None | None | None | +| riscv64 | None | None | None | ## Install preview versions diff --git a/docs/core/install/linux-debian.md b/docs/core/install/linux-debian.md index b856a64145832..7537a8c13e1db 100644 --- a/docs/core/install/linux-debian.md +++ b/docs/core/install/linux-debian.md @@ -3,7 +3,7 @@ title: Install .NET on Debian description: Demonstrates the various ways to install .NET SDK and .NET Runtime on Debian. author: adegeo ms.author: adegeo -ms.date: 08/09/2023 +ms.date: 11/14/2023 --- # Install the .NET SDK or the .NET Runtime on Debian @@ -20,8 +20,8 @@ The following table is a list of currently supported .NET releases and the versi | Debian | .NET | |---------|-----------| -| 12 | 7, 6 | -| 11 | 7, 6 | +| 12 | 8, 7, 6 | +| 11 | 8, 7, 6 | | 10 | 7, 6 | [!INCLUDE [versions-not-supported](includes/versions-not-supported.md)] @@ -44,7 +44,7 @@ sudo dpkg -i packages-microsoft-prod.deb rm packages-microsoft-prod.deb ``` -[!INCLUDE [linux-apt-install-70](includes/linux-install-70-apt.md)] +[!INCLUDE [linux-apt-install-80](includes/linux-install-80-apt.md)] ## Debian 11 @@ -56,7 +56,7 @@ sudo dpkg -i packages-microsoft-prod.deb rm packages-microsoft-prod.deb ``` -[!INCLUDE [linux-apt-install-70](includes/linux-install-70-apt.md)] +[!INCLUDE [linux-apt-install-80](includes/linux-install-80-apt.md)] ## Debian 10 diff --git a/docs/core/install/linux-fedora.md b/docs/core/install/linux-fedora.md index 951dd02e84d31..a964d834af010 100644 --- a/docs/core/install/linux-fedora.md +++ b/docs/core/install/linux-fedora.md @@ -3,11 +3,13 @@ title: Install .NET on Fedora description: Demonstrates the various ways to install .NET SDK and .NET Runtime on Fedora. author: adegeo ms.author: adegeo -ms.date: 05/04/2023 +ms.date: 11/14/2023 --- # Install the .NET SDK or the .NET Runtime on Fedora +[!INCLUDE [linux-release-wait](includes/linux-release-wait.md)] + .NET is supported on Fedora and this article describes how to install .NET on Fedora. When a Fedora version falls out of support, .NET is no longer supported with that version. [!INCLUDE [linux-intro-sdk-vs-runtime](includes/linux-intro-sdk-vs-runtime.md)] @@ -23,11 +25,16 @@ The following table is a list of currently supported .NET releases and the versi | Fedora | .NET | |--------|-----------| -| 38 | 7, 6 | -| 37 | 7, 6 | +| 39 | 8, 7, 6 | +| 38 | 8, 7, 6 | +| 37 | 8, 7, 6 | [!INCLUDE [versions-not-supported](includes/versions-not-supported.md)] +## Install .NET 8 + +[!INCLUDE [linux-dnf-install-80](includes/linux-install-80-dnf.md)] + ## Install .NET 7 [!INCLUDE [linux-dnf-install-70](includes/linux-install-70-dnf.md)] @@ -62,6 +69,7 @@ Older versions of Fedora don't contain .NET Core in the default package reposito | Fedora Version | Package repository | | -------------- | ------- | + | 36 | `https://packages.microsoft.com/config/fedora/36/prod.repo` | | 35 | `https://packages.microsoft.com/config/fedora/35/prod.repo` | | 34 | `https://packages.microsoft.com/config/fedora/34/prod.repo` | | 33 | `https://packages.microsoft.com/config/fedora/33/prod.repo` | diff --git a/docs/core/install/linux-opensuse.md b/docs/core/install/linux-opensuse.md index bdc39c33c6622..a5463921cb3e7 100644 --- a/docs/core/install/linux-opensuse.md +++ b/docs/core/install/linux-opensuse.md @@ -3,7 +3,7 @@ title: Install .NET on openSUSE description: Demonstrates the various ways to install .NET SDK and .NET Runtime on openSUSE. author: adegeo ms.author: adegeo -ms.date: 05/04/2023 +ms.date: 11/14/2023 --- # Install the .NET SDK or the .NET Runtime on openSUSE @@ -20,7 +20,7 @@ The following table is a list of currently supported .NET releases on openSUSE 1 | openSUSE | .NET | |------------|-----------| -| 15.4+ | 7, 6 | +| 15.4+ | 8, 7, 6 | [!INCLUDE [versions-not-supported](includes/versions-not-supported.md)] @@ -44,7 +44,7 @@ sudo mv prod.repo /etc/zypp/repos.d/microsoft-prod.repo sudo chown root:root /etc/zypp/repos.d/microsoft-prod.repo ``` -[!INCLUDE [linux-zyp-install-70](includes/linux-install-70-zyp.md)] +[!INCLUDE [linux-zyp-install-80](includes/linux-install-80-zyp.md)] ## How to install other versions diff --git a/docs/core/install/linux-rhel.md b/docs/core/install/linux-rhel.md index 80c65527172f9..1b76dc7460a02 100644 --- a/docs/core/install/linux-rhel.md +++ b/docs/core/install/linux-rhel.md @@ -3,11 +3,13 @@ title: Install .NET on RHEL and CentOS Stream description: Demonstrates the various ways to install .NET SDK and .NET Runtime on Red Hat Enterprise Linux. author: adegeo ms.author: adegeo -ms.date: 05/05/2023 +ms.date: 11/14/2023 --- # Install the .NET SDK or the .NET Runtime on RHEL and CentOS Stream +[!INCLUDE [linux-release-wait](includes/linux-release-wait.md)] + .NET is supported on Red Hat Enterprise Linux (RHEL). This article describes how to install .NET on RHEL and CentOS Stream. [!INCLUDE [linux-intro-sdk-vs-runtime](includes/linux-intro-sdk-vs-runtime.md)] @@ -25,11 +27,11 @@ The following table is a list of currently supported .NET releases on both RHEL | Distribution | .NET | | ---------------------- | --------- | -| RHEL 9 (9.1) | 7, 6 | -| RHEL 8 (8.7) | 7, 6 | +| RHEL 9 (9.1) | 8, 7, 6 | +| RHEL 8 (8.7) | 8, 7, 6 | | RHEL 7 | 6 | -| CentOS Stream 9 | 7, 6 | -| CentOS Stream 8 | 7, 6 | +| CentOS Stream 9 | 8, 7, 6 | +| CentOS Stream 8 | 8, 7, 6 | [!INCLUDE [versions-not-supported](includes/versions-not-supported.md)] @@ -45,13 +47,17 @@ The following table is a list of currently supported .NET releases on both RHEL .NET is included in the AppStream repositories for RHEL 9. -[!INCLUDE [linux-dnf-install-70](includes/linux-install-70-dnf.md)] +[!INCLUDE [linux-dnf-install-80](includes/linux-install-80-dnf.md)] ## RHEL 8 .NET is included in the AppStream repositories for RHEL 8. -[!INCLUDE [linux-dnf-install-70](includes/linux-install-70-dnf.md)] +[!INCLUDE [linux-dnf-install-80](includes/linux-install-80-dnf.md)] + +## RHEL 7 ❌ .NET 8 + +.NET 8 isn't officially supported on RHEL 7. To install .NET 8, see [Install .NET on Linux by using an install script or by extracting binaries](linux-scripted-manual.md). ## RHEL 7 ❌ .NET 7 @@ -103,7 +109,7 @@ As an alternative to the ASP.NET Core Runtime, you can install the .NET Runtime .NET is included in the AppStream repositories for CentOS Stream 9. -[!INCLUDE [linux-dnf-install-70](includes/linux-install-70-dnf.md)] +[!INCLUDE [linux-dnf-install-80](includes/linux-install-80-dnf.md)] ## CentOS Stream 8 ✔️ @@ -111,7 +117,7 @@ Use the Microsoft repository to install .NET: ```bash sudo rpm -Uvh https://packages.microsoft.com/config/centos/8/packages-microsoft-prod.rpm -sudo yum install dotnet-sdk-7.0 +sudo yum install dotnet-sdk-8.0 ``` ## Dependencies diff --git a/docs/core/install/linux-scripted-manual.md b/docs/core/install/linux-scripted-manual.md index 1272b3e5c61c4..bae8a8a4bfa2e 100644 --- a/docs/core/install/linux-scripted-manual.md +++ b/docs/core/install/linux-scripted-manual.md @@ -3,7 +3,7 @@ title: Install .NET on Linux without using a package manager description: Demonstrates how to install the .NET SDK and the .NET Runtime on Linux without a package manager. Use the install script or manually extract the binaries. author: adegeo ms.author: adegeo -ms.date: 12/21/2022 +ms.date: 11/14/2023 --- # Install .NET on Linux by using an install script or by extracting binaries @@ -20,9 +20,9 @@ The following table lists the support status of each version of .NET (and .NET C | ✔️ Supported | ❌ Unsupported | |-------------|---------------| -| 7 (STS) | 5 | -| 6 (LTS) | 3.1 | -| | 3.0 | +| 8 (LTS) | 5 | +| 7 (STS) | 3.1 | +| 6 (LTS) | 3.0 | | | 2.2 | | | 2.1 | | | 2.0 | @@ -102,10 +102,10 @@ To install .NET Runtime instead of the SDK, use the `--runtime` parameter. ./dotnet-install.sh --version latest --runtime aspnetcore ``` -You can install a specific major version with the `--channel` parameter to indicate the specific version. The following command installs .NET 7.0 SDK. +You can install a specific major version with the `--channel` parameter to indicate the specific version. The following command installs .NET 8.0 SDK. ```bash -./dotnet-install.sh --channel 7.0 +./dotnet-install.sh --channel 8.0 ``` For more information, see [dotnet-install scripts reference](../tools/dotnet-install-script.md). @@ -120,6 +120,7 @@ As an alternative to the package managers, you can download and manually install Download a **binary** release for either the SDK or the runtime from one of the following sites. The .NET SDK includes the corresponding runtime: +- ✔️ [.NET 8 downloads](https://dotnet.microsoft.com/download/dotnet/8.0) - ✔️ [.NET 7 downloads](https://dotnet.microsoft.com/download/dotnet/7.0) - ✔️ [.NET 6 downloads](https://dotnet.microsoft.com/download/dotnet/6.0) - [All .NET Core downloads](https://dotnet.microsoft.com/download/dotnet) @@ -136,7 +137,7 @@ The following commands set the environment variable `DOTNET_ROOT` to the current > If you run these commands, remember to change the `DOTNET_FILE` value to the name of the .NET binary you downloaded. ```bash -DOTNET_FILE=dotnet-sdk-7.0.100-linux-x64.tar.gz +DOTNET_FILE=dotnet-sdk-8.0.100-linux-x64.tar.gz export DOTNET_ROOT=$(pwd)/.dotnet mkdir -p "$DOTNET_ROOT" && tar zxf "$DOTNET_FILE" -C "$DOTNET_ROOT" diff --git a/docs/core/install/linux-sles.md b/docs/core/install/linux-sles.md index 1406290b91e47..e9045199d6690 100644 --- a/docs/core/install/linux-sles.md +++ b/docs/core/install/linux-sles.md @@ -3,7 +3,7 @@ title: Install .NET on SLES description: Demonstrates the various ways to install .NET SDK and .NET Runtime on SLES. author: adegeo ms.author: adegeo -ms.date: 05/05/2023 +ms.date: 11/14/2023 --- # Install the .NET SDK or the .NET Runtime on SLES @@ -18,8 +18,8 @@ The following table is a list of currently supported .NET releases on both SLES | SLES | .NET | |--------|------| -| 15 | 7, 6 | -| 12 SP5 | 7, 6 | +| 15 | 8, 7, 6 | +| 12 SP5 | 8, 7, 6 | [!INCLUDE [versions-not-supported](includes/versions-not-supported.md)] @@ -45,7 +45,7 @@ Currently, the SLES 15 Microsoft repository setup package installs the *microsof sudo ln -s /etc/yum.repos.d/microsoft-prod.repo /etc/zypp/repos.d/microsoft-prod.repo ``` -[!INCLUDE [linux-zyp-install-60](includes/linux-install-60-zyp.md)] +[!INCLUDE [linux-zyp-install-80](includes/linux-install-80-zyp.md)] ## SLES 12 @@ -57,7 +57,7 @@ sudo ln -s /etc/yum.repos.d/microsoft-prod.repo /etc/zypp/repos.d/microsoft-prod sudo rpm -Uvh https://packages.microsoft.com/config/sles/12/packages-microsoft-prod.rpm ``` -[!INCLUDE [linux-zyp-install-60](includes/linux-install-60-zyp.md)] +[!INCLUDE [linux-zyp-install-80](includes/linux-install-80-zyp.md)] ## How to install other versions diff --git a/docs/core/install/linux-ubuntu-2004.md b/docs/core/install/linux-ubuntu-2004.md index d4e716a0d084e..96aa8a9e7c380 100644 --- a/docs/core/install/linux-ubuntu-2004.md +++ b/docs/core/install/linux-ubuntu-2004.md @@ -3,11 +3,13 @@ title: Install .NET on Ubuntu 20.04 description: Demonstrates the various ways to install .NET SDK and .NET Runtime on Ubuntu 20.04. author: adegeo ms.author: adegeo -ms.date: 03/01/2023 +ms.date: 11/14/2023 --- # Install .NET SDK or .NET Runtime on Ubuntu 20.04 +[!INCLUDE [linux-release-wait](includes/linux-release-wait.md)] + This article discusses how to install .NET on Ubuntu 20.04; .NET 6 and .NET 7 are supported. [!INCLUDE [linux-intro-sdk-vs-runtime](includes/linux-intro-sdk-vs-runtime.md)] @@ -20,7 +22,7 @@ The following versions of .NET are supported or available for Ubuntu 20.04: | Supported .NET versions | Available in Ubuntu feed | [Available in Microsoft feed](linux-ubuntu.md#register-the-microsoft-package-repository) | |-------------------------|--------------------------|-----------------------------------| -| 7.0, 6.0 | None | 7.0. 6.0, 5.0, 3.1, 2.1 | +| 8.0, 7.0, 6.0 | None | 8.0, 7.0. 6.0, 5.0, 3.1, 2.1 | When an [Ubuntu version](https://wiki.ubuntu.com/Releases) falls out of support, .NET is no longer supported with that version. @@ -36,7 +38,7 @@ sudo dpkg -i packages-microsoft-prod.deb rm packages-microsoft-prod.deb ``` -[!INCLUDE [linux-apt-install-70](includes/linux-install-70-apt.md)] +[!INCLUDE [linux-apt-install-80](includes/linux-install-80-apt.md)] ## How to install other versions diff --git a/docs/core/install/linux-ubuntu-2204.md b/docs/core/install/linux-ubuntu-2204.md index 4e68d6f8354d0..efc0fd2048175 100644 --- a/docs/core/install/linux-ubuntu-2204.md +++ b/docs/core/install/linux-ubuntu-2204.md @@ -3,11 +3,13 @@ title: Install .NET on Ubuntu 22.04 description: Demonstrates the various ways to install .NET SDK and .NET Runtime on Ubuntu 22.04. author: adegeo ms.author: adegeo -ms.date: 05/24/2023 +ms.date: 11/14/2023 --- # Install .NET SDK or .NET Runtime on Ubuntu 22.04 +[!INCLUDE [linux-release-wait](includes/linux-release-wait.md)] + This article discusses how to install .NET on Ubuntu 22.04; .NET 6 and .NET 7 are supported. [!INCLUDE [linux-intro-sdk-vs-runtime](includes/linux-intro-sdk-vs-runtime.md)] @@ -22,7 +24,7 @@ The following versions of .NET are supported or available for Ubuntu 22.04: | Supported .NET versions | Available in Ubuntu feed | [Available in Microsoft feed](linux-ubuntu.md#register-the-microsoft-package-repository) | |-------------------------|--------------------------|-----------------------------------| -| 7.0, 6.0 | 7.0, 6.0 | 7.0, 6.0, 3.1 | +| 8.0, 7.0, 6.0 | 8.0, 7.0, 6.0 | 8.0, 7.0, 6.0, 3.1 | [!INCLUDE [linux-ubuntu-feed-sdk-note](includes/linux-ubuntu-feed-sdk-note.md)] @@ -32,7 +34,7 @@ When an [Ubuntu version](https://wiki.ubuntu.com/Releases) falls out of support, ## Install .NET -[!INCLUDE [linux-apt-install-70](includes/linux-install-70-apt.md)] +[!INCLUDE [linux-apt-install-80](includes/linux-install-80-apt.md)] ## How to install other versions diff --git a/docs/core/install/linux-ubuntu-2304.md b/docs/core/install/linux-ubuntu-2304.md index 17fc0cdaad90c..50de9071f2ced 100644 --- a/docs/core/install/linux-ubuntu-2304.md +++ b/docs/core/install/linux-ubuntu-2304.md @@ -3,11 +3,13 @@ title: Install .NET on Ubuntu 23.04 description: Demonstrates the various ways to install .NET SDK and .NET Runtime on Ubuntu 23.04. author: adegeo ms.author: adegeo -ms.date: 05/24/2023 +ms.date: 11/14/2023 --- # Install .NET SDK or .NET Runtime on Ubuntu 23.04 +[!INCLUDE [linux-release-wait](includes/linux-release-wait.md)] + This article discusses how to install .NET on Ubuntu 23.04; .NET 6 and .NET 7 are supported. [!INCLUDE [linux-intro-sdk-vs-runtime](includes/linux-intro-sdk-vs-runtime.md)] @@ -22,7 +24,7 @@ The following versions of .NET are supported or available for Ubuntu 23.04: | Supported .NET versions | Available in Ubuntu feed | [Available in Microsoft feed](linux-ubuntu.md#register-the-microsoft-package-repository) | |-------------------------|--------------------------|-----------------------------------| -| 7.0, 6.0 | 7.0, 6.0 | 7.0, 6.0 | +| 8.0, 7.0, 6.0 | 8.0, 7.0, 6.0 | 8.0, 7.0, 6.0 | [!INCLUDE [linux-ubuntu-feed-sdk-note](includes/linux-ubuntu-feed-sdk-note.md)] @@ -32,7 +34,7 @@ When an [Ubuntu version](https://wiki.ubuntu.com/Releases) falls out of support, ## Install .NET -[!INCLUDE [linux-apt-install-70](includes/linux-install-70-apt.md)] +[!INCLUDE [linux-apt-install-80](includes/linux-install-80-apt.md)] ## How to install other versions diff --git a/docs/core/install/linux-ubuntu.md b/docs/core/install/linux-ubuntu.md index 3e9922462a6cc..cc7d2cf7ee03c 100644 --- a/docs/core/install/linux-ubuntu.md +++ b/docs/core/install/linux-ubuntu.md @@ -3,7 +3,7 @@ title: .NET and Ubuntu overview description: Demonstrates the various ways to install .NET SDK and .NET Runtime on Ubuntu. author: adegeo ms.author: adegeo -ms.date: 05/24/2023 +ms.date: 11/14/2023 --- # Install the .NET SDK or the .NET Runtime on Ubuntu @@ -25,7 +25,7 @@ When your version of Ubuntu supports .NET through the built-in Ubuntu feed, supp Use the following sections to determine how you should install .NET: -- [I'm using Ubuntu 22.04, 22.10, or 23.04, and I only need .NET 6.0 or .NET 7.0](#im-using-ubuntu-2204-2210-or-2304-and-i-only-need-net-60-or-net-70) +- [I'm using Ubuntu 22.04, 22.10, or 23.04, and I only need .NET](#im-using-ubuntu-2204-2210-or-2304-and-i-only-need-net) - [I'm using a version of Ubuntu prior to 22.04](#im-using-a-version-of-ubuntu-prior-to-2204) - [I'm using other Microsoft packages, such as `powershell`, `mdatp`, or `mssql`](#im-using-other-microsoft-packages-such-as-powershell-mdatp-or-mssql) - [I want to create a .NET app](#i-want-to-create-a-net-app) @@ -35,7 +35,7 @@ Use the following sections to determine how you should install .NET: - [I don't want to use APT](#i-dont-want-to-use-apt) - [I'm using an Arm-based CPU](#im-using-an-arm-based-cpu) -### I'm using Ubuntu 22.04, 22.10, or 23.04, and I only need .NET 6.0 or .NET 7.0 +### I'm using Ubuntu 22.04, 22.10, or 23.04, and I only need .NET Install .NET through the Ubuntu feed. For more information, see the following pages: diff --git a/docs/core/install/macos.md b/docs/core/install/macos.md index 6880ca19941c3..0153e0dbabee4 100644 --- a/docs/core/install/macos.md +++ b/docs/core/install/macos.md @@ -19,7 +19,7 @@ In this article, you learn how to install .NET on macOS. .NET is made up of the The latest version of .NET is 8. > [!div class="button"] -> [Download .NET Core](https://dotnet.microsoft.com/download/dotnet) +> [Download .NET](https://dotnet.microsoft.com/download/dotnet) ## Supported releases @@ -29,9 +29,9 @@ The following table is a list of currently supported .NET releases and the versi | Operating System | .NET 8 (LTS) | .NET 7 (STS) | .NET 6 (LTS) | |------------------------|--------------|--------------|--------------| -| macOS 13.0 "Ventura" | ✔️ 8.0 | ✔️ 7.0 | ✔️ 6.0 | -| macOS 12.0 "Monterey" | ✔️ 8.0 | ✔️ 7.0 | ✔️ 6.0 | -| macOS 11.0 "Big Sur" | ✔️ 8.0 | ✔️ 7.0 | ✔️ 6.0 | +| macOS 13.0 "Ventura" | ❌ | ✔️ 7.0 | ✔️ 6.0 | +| macOS 12.0 "Monterey" | ❌ | ✔️ 7.0 | ✔️ 6.0 | +| macOS 11.0 "Big Sur" | ❌ | ✔️ 7.0 | ✔️ 6.0 | | macOS 10.15 "Catalina" | ✔️ 8.0 | ✔️ 7.0 | ✔️ 6.0 | For a full list of .NET versions and their support life cycle, see [.NET Support Policy](https://dotnet.microsoft.com/platform/support/policy/dotnet-core). @@ -82,9 +82,11 @@ brew install mono-libgdiplus ## Install with an installer -macOS has standalone installers that can be used to install .NET 8: +macOS has standalone installers that can be used to install .NET: -- [x64 and Arm64 CPUs](https://dotnet.microsoft.com/download/dotnet/8.0) +- ✔️ [.NET 8 downloads](https://dotnet.microsoft.com/download/dotnet/8.0) +- ✔️ [.NET 7 downloads](https://dotnet.microsoft.com/download/dotnet/7.0) +- ✔️ [.NET 6 downloads](https://dotnet.microsoft.com/download/dotnet/6.0) ## Download and manually install @@ -97,7 +99,6 @@ First, download a **binary** release for either the SDK or the runtime from one - ✔️ [.NET 8 downloads](https://dotnet.microsoft.com/download/dotnet/8.0) - ✔️ [.NET 7 downloads](https://dotnet.microsoft.com/download/dotnet/7.0) - ✔️ [.NET 6 downloads](https://dotnet.microsoft.com/download/dotnet/6.0) -- ✔️ [.NET Core 3.1 downloads](https://dotnet.microsoft.com/download/dotnet/3.1) - [All .NET downloads](https://dotnet.microsoft.com/download/dotnet) Next, extract the downloaded file and use the `export` command to set `DOTNET_ROOT` to the extracted folder's location and then ensure .NET is in PATH. This should make the .NET CLI commands available at the terminal. For more information about .NET environment variables, see [.NET SDK and CLI environment variables](../tools/dotnet-environment-variables.md#net-sdk-and-cli-environment-variables). @@ -176,7 +177,6 @@ Visual Studio for Mac installs the .NET SDK when the **.NET** workload is select | 8.0 | Visual Studio 2022 for Mac 17.8 or higher. | | 7.0 | Visual Studio 2022 for Mac 17.4 or higher. | | 6.0 | Visual Studio 2022 for Mac Preview 3 17.0 or higher. | -| 3.1 | Visual Studio 2019 for Mac version 8.4 or higher. | :::image type="content" source="media/install-sdk/mac-install-selection.png" alt-text="macOS Visual Studio 2019 for Mac with the .NET workload selected." lightbox="media/install-sdk/mac-install-selection.png"::: diff --git a/docs/core/install/media/install-sdk/checksum.png b/docs/core/install/media/install-sdk/checksum.png index 21e350de5a32d..5fa7df1366076 100644 Binary files a/docs/core/install/media/install-sdk/checksum.png and b/docs/core/install/media/install-sdk/checksum.png differ diff --git a/docs/core/install/media/install-sdk/release-notes-root.png b/docs/core/install/media/install-sdk/release-notes-root.png index ea7613f51943b..e1e133b7bc202 100644 Binary files a/docs/core/install/media/install-sdk/release-notes-root.png and b/docs/core/install/media/install-sdk/release-notes-root.png differ diff --git a/docs/core/install/media/install-sdk/release-notes-version.png b/docs/core/install/media/install-sdk/release-notes-version.png index 4689230e72849..92e73bf858ff2 100644 Binary files a/docs/core/install/media/install-sdk/release-notes-version.png and b/docs/core/install/media/install-sdk/release-notes-version.png differ diff --git a/docs/core/install/windows.md b/docs/core/install/windows.md index aa7dbf0a9adbd..8214ad33fb0b2 100644 --- a/docs/core/install/windows.md +++ b/docs/core/install/windows.md @@ -46,7 +46,7 @@ If you're installing .NET system-wide, install with administrative privileges. The .NET SDK allows you to develop apps with .NET. If you install the .NET SDK, you don't need to install the corresponding runtimes. To install the .NET SDK, run the following command: ```cmd -winget install Microsoft.DotNet.SDK.7 +winget install Microsoft.DotNet.SDK.8 ``` ### Install the runtime @@ -58,7 +58,7 @@ For Windows, there are three .NET runtimes you can install. You should install b This runtime includes the base .NET runtime, and supports Windows Presentation Foundation (WPF) and Windows Forms apps that are built with .NET. This isn't the same as .NET Framework, which comes with Windows. ```cmd - winget install Microsoft.DotNet.DesktopRuntime.7 + winget install Microsoft.DotNet.DesktopRuntime.8 ``` - ASP.NET Core Runtime @@ -66,7 +66,7 @@ For Windows, there are three .NET runtimes you can install. You should install b This runtime includes the base .NET runtime, and runs web server apps. The ASP.NET Core Runtime allows you to run apps that were made with .NET that didn't provide the runtime. The following commands install the ASP.NET Core Runtime, which is the most compatible runtime for .NET. In your terminal, run the following commands: ```cmd - winget install Microsoft.DotNet.AspNetCore.7 + winget install Microsoft.DotNet.AspNetCore.8 ``` - .NET Runtime @@ -74,7 +74,7 @@ For Windows, there are three .NET runtimes you can install. You should install b This is the base runtime, and contains just the components needed to run a console app. Typically, you'd install the other runtimes. ```cmd - winget install Microsoft.DotNet.Runtime.7 + winget install Microsoft.DotNet.Runtime.8 ``` You can install preview versions of the runtimes by substituting the version number, such as `6`, with the word `Preview`. The following example installs the preview release of the .NET Desktop Runtime: @@ -112,7 +112,7 @@ Prevents any UI and prompts from displaying. Suppresses any attempts to restart. ```console -dotnet-sdk-7.0.100-win-x64.exe /install /quiet /norestart +dotnet-sdk-8.0.100-win-x64.exe /install /quiet /norestart ``` For more information, see [Standard Installer Command-Line Options](/windows/win32/msi/standard-installer-command-line-options).