diff --git a/docs/core/install/linux-scripted-manual.md b/docs/core/install/linux-scripted-manual.md index 5f28bafd9d2bd..9a0ec61a28a32 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: 11/11/2024 +ms.date: 12/20/2024 ms.custom: linux-related-content --- @@ -73,7 +73,7 @@ You can usually install a recent version of *libgdiplus* by [adding the Mono rep ## Scripted install -The [dotnet-install scripts](../tools/dotnet-install-script.md) are used for automation and non-admin installs of the **SDK** and **Runtime**. You can download the script from . When .NET is installed in this way, you must install the dependencies required by your Linux distribution. Use the links in the [Install .NET on Linux](linux.md) article for your specific Linux distribution. +The [dotnet-install scripts](../tools/dotnet-install-script.md) are used for automation and non-admin installs of the **SDK** and **Runtime**. You can download the script from . When .NET is installed in this way, you must install the dependencies required by your Linux distribution. Use the links in the [Install .NET on Linux](linux.md) article for your specific Linux distribution. > [!IMPORTANT] > Bash is required to run the script. @@ -81,7 +81,7 @@ The [dotnet-install scripts](../tools/dotnet-install-script.md) are used for aut You can download the script with `wget`: ```bash -wget https://dot.net/v1/dotnet-install.sh -O dotnet-install.sh +wget https://dot.net/v2/dotnet-install.sh -O dotnet-install.sh ``` Before running this script, make sure you grant permission for this script to run as an executable: diff --git a/docs/core/install/macos.md b/docs/core/install/macos.md index 6d7e0f35a3563..9ebd0dc98e778 100644 --- a/docs/core/install/macos.md +++ b/docs/core/install/macos.md @@ -4,7 +4,7 @@ description: Learn about which versions of .NET SDK and .NET Runtime are support author: adegeo ms.author: adegeo ms.topic: install-set-up-deploy -ms.date: 11/11/2024 +ms.date: 12/20/2024 ms.custom: linux-related-content #customer intent: As a user or developer, I want to know which versions of .NET are supported on macOS. I also need to know how to install .NET on macOS. @@ -168,7 +168,7 @@ chdir ~/Applications/.dotnet/ ## Install .NET with a script -The [dotnet-install scripts](../tools/dotnet-install-script.md) are used for automation and unelevated installs of the runtime. You can download the script from . +The [dotnet-install scripts](../tools/dotnet-install-script.md) are used for automation and unelevated installs of the runtime. You can download the script from . The script defaults to installing the latest [long term support (LTS)](https://dotnet.microsoft.com/platform/support/policy/dotnet-core) version, which is .NET 8. You can choose a specific release by specifying the `channel` switch. Include the `runtime` switch to install a runtime. Otherwise, the script installs the SDK. @@ -186,7 +186,7 @@ The script defaults to installing the latest [long term support (LTS)](https://d 01. Run the following command to download the script: ```bash - wget https://dot.net/v1/dotnet-install.sh + wget https://dot.net/v2/dotnet-install.sh ``` 01. Give the script execute permissions @@ -208,7 +208,7 @@ Here are all the commands as a single bash script: ```bash chdir ~/Downloads brew install wget -wget https://dot.net/v1/dotnet-install.sh +wget https://dot.net/v2/dotnet-install.sh chmod +x dotnet-install.sh ./dotnet-install.sh ``` diff --git a/docs/core/install/windows.md b/docs/core/install/windows.md index 06ec609841b88..4d29ad0d9dfcb 100644 --- a/docs/core/install/windows.md +++ b/docs/core/install/windows.md @@ -4,7 +4,7 @@ description: "Learn about which versions of .NET SDK and .NET Runtime are suppor author: adegeo ms.author: adegeo ms.topic: install-set-up-deploy #Don't change -ms.date: 11/11/2024 +ms.date: 12/20/2024 #customer intent: As a developer or user, I want to decide the best way to install .NET on Windows. --- @@ -330,10 +330,10 @@ winget install Microsoft.DotNet.DesktopRuntime.Preview Installing .NET through the `dotnet-install` PowerShell script is recommended for continuous integration and nonadmin installs. If you're installing .NET for normal use on your system, use either the [.NET Installer](#net-installer) or [Windows Package Manager](#install-with-windows-package-manager-winget) installation methods. -The script defaults to installing the latest [long term support (LTS)](https://dotnet.microsoft.com/platform/support/policy/dotnet-core) version, which is .NET 8. You can choose a specific release by specifying the `-Channel` switch. Include the `-Runtime` switch to install a runtime. Otherwise, the script installs the SDK. The script is available at and the source code is hosted on [GitHub](https://github.com/dotnet/install-scripts). +The script defaults to installing the latest [long term support (LTS)](https://dotnet.microsoft.com/platform/support/policy/dotnet-core) version, which is .NET 8. You can choose a specific release by specifying the `-Channel` switch. Include the `-Runtime` switch to install a runtime. Otherwise, the script installs the SDK. The script is available at and the source code is hosted on [GitHub](https://github.com/dotnet/install-scripts). > [!div class="button"] -> [Download the script](https://dot.net/v1/dotnet-install.ps1) +> [Download the script](https://dot.net/v2/dotnet-install.ps1) For more information about the script, see [dotnet-install script reference](../tools/dotnet-install-script.md). @@ -341,7 +341,7 @@ For more information about the script, see [dotnet-install script reference](../ The .NET Runtime is installed by providing the `-Runtime` switch. -01. Download the install script from +01. Download the install script from 01. Open PowerShell and navigate to the folder containing the script. 01. Run the following commands to install both the Desktop runtime and ASP.NET Core runtime for maximum compatibility: @@ -356,7 +356,7 @@ To learn how to use the .NET CLI, see [.NET CLI overview](../tools/index.md). If you install the SDK, you don't need to install the runtimes. -01. Download the install script from +01. Download the install script from 01. Open PowerShell and navigate to the folder containing the script. 01. Run the following command to install the .NET SDK. diff --git a/docs/core/tools/dotnet-install-script.md b/docs/core/tools/dotnet-install-script.md index cf7e861f56dea..f12b4ba8a42b2 100644 --- a/docs/core/tools/dotnet-install-script.md +++ b/docs/core/tools/dotnet-install-script.md @@ -1,7 +1,7 @@ --- title: dotnet-install scripts description: Learn about the dotnet-install scripts to install the .NET SDK and the shared runtime. -ms.date: 08/01/2023 +ms.date: 12/20/2023 --- # dotnet-install scripts reference @@ -69,8 +69,8 @@ To set up a development environment or to run apps, use the installers rather th We recommend that you use the stable version of the scripts: -- Bash (Linux/macOS): -- PowerShell (Windows): +- Bash (Linux/macOS): +- PowerShell (Windows): The source for the scripts is in the [dotnet/install-scripts](https://github.com/dotnet/install-scripts) GitHub repository. @@ -272,7 +272,7 @@ The install scripts do not update the registry on Windows. They just download th - Obtain script and install the 6.0.2 version behind a corporate proxy (Windows only): ```powershell - Invoke-WebRequest 'https://dot.net/v1/dotnet-install.ps1' -Proxy $env:HTTP_PROXY -ProxyUseDefaultCredentials -OutFile 'dotnet-install.ps1'; + Invoke-WebRequest 'https://dot.net/v2/dotnet-install.ps1' -Proxy $env:HTTP_PROXY -ProxyUseDefaultCredentials -OutFile 'dotnet-install.ps1'; ./dotnet-install.ps1 -InstallDir '~/.dotnet' -Version '6.0.2' -Runtime 'dotnet' -ProxyAddress $env:HTTP_PROXY -ProxyUseDefaultCredentials; ``` @@ -282,13 +282,13 @@ The install scripts do not update the registry on Windows. They just download th ```powershell # Run a separate PowerShell process because the script calls exit, so it will end the current PowerShell session. - &powershell -NoProfile -ExecutionPolicy unrestricted -Command "[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12; &([scriptblock]::Create((Invoke-WebRequest -UseBasicParsing 'https://dot.net/v1/dotnet-install.ps1'))) " + &powershell -NoProfile -ExecutionPolicy unrestricted -Command "[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12; &([scriptblock]::Create((Invoke-WebRequest -UseBasicParsing 'https://dot.net/v2/dotnet-install.ps1'))) " ``` macOS/Linux: ```bash - curl -sSL https://dot.net/v1/dotnet-install.sh | bash /dev/stdin + curl -sSL https://dot.net/v2/dotnet-install.sh | bash /dev/stdin ``` ## Set environment variables @@ -322,8 +322,8 @@ Signature validation is an important security measure that helps ensure the auth Here is a step-by-step guide on how to verify the authenticity of the `dotnet-install.sh` script using GPG: 1. **Install GPG**: GPG (GNU Privacy Guard) is a free and open-source tool for encrypting and signing data. You can install it by following the [instructions on the GPG website](https://gnupg.org/download/). -2. **Import our public key**: Download the install-scripts [public key](https://dot.net/v1/dotnet-install.asc) file, and then import it into your GPG keyring by running the command `gpg --import dotnet-install.asc`. -3. **Download the signature file**: The signature file for our bash script is available at `https://dot.net/v1/dotnet-install.sig`. You can download it using a tool like `wget` or `curl`. +2. **Import our public key**: Download the install-scripts [public key](https://dot.net/v2/dotnet-install.asc) file, and then import it into your GPG keyring by running the command `gpg --import dotnet-install.asc`. +3. **Download the signature file**: The signature file for our bash script is available at `https://dot.net/v2/dotnet-install.sig`. You can download it using a tool like `wget` or `curl`. 4. **Verify the signature**: To verify the signature of our bash script, run the command `gpg --verify dotnet-install.sig dotnet-install.sh`. This will check the signature of the `dotnet-install.sh` file against the signature in the `dotnet-install.sig` file. 5. **Check the result**: If the signature is valid, you will see a message containing `Good signature from "Microsoft DevUXTeamPrague "`. This means that the script has not been tampered with and can be trusted. @@ -333,7 +333,7 @@ Installing GPG and importing our public key is a one time operation. ```bash sudo apt install gpg -wget https://dot.net/v1/dotnet-install.asc +wget https://dot.net/v2/dotnet-install.asc gpg --import dotnet-install.asc ``` @@ -353,8 +353,8 @@ gpg: imported: 1 With the key imported, you can now download the script and the signature, then verify the script matches the signature: ```bash -wget https://dot.net/v1/dotnet-install.sh -wget https://dot.net/v1/dotnet-install.sig +wget https://dot.net/v2/dotnet-install.sh +wget https://dot.net/v2/dotnet-install.sig gpg --verify dotnet-install.sig dotnet-install.sh ``` diff --git a/docs/devops/dotnet-cli-and-continuous-integration.md b/docs/devops/dotnet-cli-and-continuous-integration.md index da0dc7d19dad2..41362c2dcb097 100644 --- a/docs/devops/dotnet-cli-and-continuous-integration.md +++ b/docs/devops/dotnet-cli-and-continuous-integration.md @@ -73,7 +73,7 @@ Write-Host "Downloading the CLI installer..." # Use the Invoke-WebRequest PowerShell cmdlet to obtain the # installation script and save it into the installation directory. Invoke-WebRequest ` - -Uri "https://dot.net/v1/dotnet-install.ps1" ` + -Uri "https://dot.net/v2/dotnet-install.ps1" ` -OutFile "$InstallDir/dotnet-install.ps1" Write-Host "Installing the CLI requested version ($CliVersion) ..." @@ -105,7 +105,7 @@ then fi mkdir -p "$INSTALLDIR" echo Downloading the CLI installer. -$DOWNLOADER https://dot.net/v1/dotnet-install.sh > "$INSTALLDIR/dotnet-install.sh" +$DOWNLOADER https://dot.net/v2/dotnet-install.sh > "$INSTALLDIR/dotnet-install.sh" chmod +x "$INSTALLDIR/dotnet-install.sh" echo Installing the CLI requested version $CLI_VERSION. Please wait, installation may take a few minutes. "$INSTALLDIR/dotnet-install.sh" --install-dir "$INSTALLDIR" --version $CLI_VERSION diff --git a/docs/iot/deployment.md b/docs/iot/deployment.md index f4330555f9fb4..8078c690ee0d4 100644 --- a/docs/iot/deployment.md +++ b/docs/iot/deployment.md @@ -26,7 +26,7 @@ To deploy your app as a framework-dependent app, complete the following steps: 1. Run the following command to install .NET: ```bash - curl -sSL https://dot.net/v1/dotnet-install.sh | bash /dev/stdin --channel STS + curl -sSL https://dot.net/v2/dotnet-install.sh | bash /dev/stdin --channel STS ``` > [!NOTE]