dotnetup is a cross-platform toolchain manager for user-level .NET installations. It installs, updates, and removes .NET SDKs and runtimes without using a system package manager.

• Windows, macOS, or Linux.
• A terminal.
• Bash on macOS or Linux, or PowerShell on Windows, to run the download script.

On Windows, the default setup uses the everywhere access mode and requires elevation to update the system PATH. Choose none or shell to avoid this requirement. For details, see dotnetup environment configuration.

The download scripts install the latest preview build by default. They verify the downloaded executable with its SHA-512 checksum and install it in ~/.dotnetup.

On macOS or Linux, run:

curl -fsSL https://aka.ms/dotnetup/get-dotnetup.sh | bash

On Windows, run:

irm https://aka.ms/dotnetup/get-dotnetup.ps1 | iex

To install the latest daily build on macOS or Linux, run:

curl -fsSL https://aka.ms/dotnetup/get-dotnetup.sh |
  bash -s -- --quality daily

To install the latest daily build on Windows, run:

iex "& { $(irm https://aka.ms/dotnetup/get-dotnetup.ps1) } -Quality daily"

The scripts print instructions to add dotnetup to PATH. Open a new terminal after you apply the instructions.

Run the interactive setup:

> dotnetup init
Welcome to dotnetup!

SDK Channel: latest
Mode: <recommended-mode> (Suggested)

<recommended-mode> modifies <configuration-target> to set PATH and DOTNET_ROOT to prefer <install-path>.

Would you like to install .NET with the recommended settings?
> Yes, proceed with defaults and install

Installing SDK <resolved-version> to <install-path>...
<download and installation progress>
Installed at <install-path>:
  SDK <resolved-version>
<mode-specific environment guidance>
Setup complete!

The paths, progress display, and environment guidance depend on your system and the selected mode.

The recommended access mode is everywhere on Windows. On macOS and Linux, it is shell when dotnetup detects a supported shell and none otherwise.

Select No, customize setup to choose the SDK channel, access mode, and migration options.

An SDK channel tells dotnetup which SDK to install and how to update it.

Exact versions do not advance during updates. For all accepted forms, see dotnetup channels and versions.

The access mode controls how terminals and applications find the dotnetup-managed .NET installation.

For more details and considerations for everywhere mode, see dotnetup environment configuration.

Setup can offer to migrate existing machine-wide .NET SDK and Runtime installations into the dotnetup-managed installation. See Everywhere mode considerations for why migration is especially important with everywhere mode.

Open a new terminal after setup changes your environment.

For shell or everywhere mode, run:

dotnet --version
dotnetup list

For none mode, run:

dotnetup dotnet -- --version
dotnetup list

Run dotnetup init again to change the setup.

• dotnetup overview
• Table of contents
• Core concepts
• Release channels
• CLI reference
• Scenarios

• Design notes
• How dotnetup is included in the SDK
• Release engineering
• Signature verification

The command reference follows the generated runtime help. Command handlers and tests verify product behavior. Hidden compatibility and elevation commands are implementation details. They are not part of the public command reference.