Skip to content
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 3 additions & 3 deletions docs/core/install/linux-scripted-manual.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
---

Expand Down Expand Up @@ -73,15 +73,15 @@ 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 <https://dot.net/v1/dotnet-install.sh>. 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 <https://dot.net/v2/dotnet-install.sh>. 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.

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:
Expand Down
8 changes: 4 additions & 4 deletions docs/core/install/macos.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Expand Down Expand Up @@ -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 <https://dot.net/v1/dotnet-install.sh>.
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 <https://dot.net/v2/dotnet-install.sh>.

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.

Expand All @@ -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
Expand All @@ -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
```
Expand Down
10 changes: 5 additions & 5 deletions docs/core/install/windows.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.
---

Expand Down Expand Up @@ -330,18 +330,18 @@ 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 <https://dot.net/v1/dotnet-install.ps1> 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 <https://dot.net/v2/dotnet-install.ps1> 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).

### Install the runtime

The .NET Runtime is installed by providing the `-Runtime` switch.

01. Download the install script from <https://dot.net/v1/dotnet-install.ps1>
01. Download the install script from <https://dot.net/v2/dotnet-install.ps1>
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:

Expand All @@ -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 <https://dot.net/v1/dotnet-install.ps1>
01. Download the install script from <https://dot.net/v2/dotnet-install.ps1>
01. Open PowerShell and navigate to the folder containing the script.
01. Run the following command to install the .NET SDK.

Expand Down
22 changes: 11 additions & 11 deletions docs/core/tools/dotnet-install-script.md
Original file line number Diff line number Diff line change
@@ -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

Expand Down Expand Up @@ -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): <https://dot.net/v1/dotnet-install.sh>
- PowerShell (Windows): <https://dot.net/v1/dotnet-install.ps1>
- Bash (Linux/macOS): <https://dot.net/v2/dotnet-install.sh>
- PowerShell (Windows): <https://dot.net/v2/dotnet-install.ps1>

The source for the scripts is in the [dotnet/install-scripts](https://github.com/dotnet/install-scripts) GitHub repository.

Expand Down Expand Up @@ -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;
```

Expand All @@ -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'))) <additional install-script args>"
&powershell -NoProfile -ExecutionPolicy unrestricted -Command "[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12; &([scriptblock]::Create((Invoke-WebRequest -UseBasicParsing 'https://dot.net/v2/dotnet-install.ps1'))) <additional install-script args>"
```

macOS/Linux:

```bash
curl -sSL https://dot.net/v1/dotnet-install.sh | bash /dev/stdin <additional install-script args>
curl -sSL https://dot.net/v2/dotnet-install.sh | bash /dev/stdin <additional install-script args>
```

## Set environment variables
Expand Down Expand Up @@ -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 <[email protected]>"`. This means that the script has not been tampered with and can be trusted.

Expand All @@ -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
```

Expand All @@ -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
```

Expand Down
4 changes: 2 additions & 2 deletions docs/devops/dotnet-cli-and-continuous-integration.md
Original file line number Diff line number Diff line change
Expand Up @@ -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) ..."
Expand Down Expand Up @@ -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
Expand Down
2 changes: 1 addition & 1 deletion docs/iot/deployment.md
Original file line number Diff line number Diff line change
Expand Up @@ -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]
Expand Down
Loading