DEV Community

IronSoftware
IronSoftware

Posted on

How to Install .NET 10 (.NET Guide)

#csharp #dotnet

.NET 10 is an LTS release — three years of support through November 2028. Here's how to install it on Windows, macOS, and Linux.

# Verify installation
dotnet --version
# Output: 10.0.100
Enter fullscreen mode Exit fullscreen mode

Takes five minutes on any platform.

How Do I Install .NET 10 on Windows?

Option 1: Installer (Recommended)

  1. Download the installer from dotnet.microsoft.com/download/dotnet/10.0
  2. Choose "Windows" → "x64" (or "Arm64" for ARM devices)
  3. Run the .exe installer
  4. Follow the prompts

.NET installs to C:\Program Files\dotnet\ by default.

Option 2: WinGet 

winget install Microsoft.DotNet.SDK.10
Enter fullscreen mode Exit fullscreen mode

One command. Automatic updates.

Option 3: Visual Studio 2026

Visual Studio 2026 includes .NET 10 SDK. Installing VS installs .NET automatically.

How Do I Install .NET 10 on macOS?

Option 1: Homebrew (Recommended) 

brew install dotnet-sdk
Enter fullscreen mode Exit fullscreen mode

Homebrew installs the latest stable SDK.

Option 2: Official Installer

  1. Download from dotnet.microsoft.com/download/dotnet/10.0
  2. Choose "macOS" → "Arm64" (Apple Silicon) or "x64" (Intel)
  3. Run the .pkg installer

Apple Silicon Macs (M1/M2/M3/M4): Choose Arm64 for native performance.

Intel Macs: Choose x64.

Option 3: Install Script 

curl -sSL https://dot.net/v1/dotnet-install.sh | bash /dev/stdin --channel 10.0
Enter fullscreen mode Exit fullscreen mode

Add to PATH:

echo 'export DOTNET_ROOT=$HOME/.dotnet' >> ~/.zshrc
echo 'export PATH=$PATH:$DOTNET_ROOT:$DOTNET_ROOT/tools' >> ~/.zshrc
source ~/.zshrc
Enter fullscreen mode Exit fullscreen mode

How Do I Install .NET 10 on Linux?

Ubuntu/Debian 

# Add Microsoft package repository
wget https://packages.microsoft.com/config/ubuntu/24.04/packages-microsoft-prod.deb
sudo dpkg -i packages-microsoft-prod.deb
rm packages-microsoft-prod.deb

# Install SDK
sudo apt-get update
sudo apt-get install -y dotnet-sdk-10.0
Enter fullscreen mode Exit fullscreen mode

Fedora/RHEL 

sudo dnf install dotnet-sdk-10.0
Enter fullscreen mode Exit fullscreen mode

Alpine 

apk add dotnet10-sdk
Enter fullscreen mode Exit fullscreen mode

Snap (Any Distribution) 

sudo snap install dotnet-sdk --classic --channel=10.0
Enter fullscreen mode Exit fullscreen mode

Install Script (Any Distribution) 

wget https://dot.net/v1/dotnet-install.sh
chmod +x dotnet-install.sh
./dotnet-install.sh --channel 10.0

# Add to PATH
echo 'export DOTNET_ROOT=$HOME/.dotnet' >> ~/.bashrc
echo 'export PATH=$PATH:$DOTNET_ROOT:$DOTNET_ROOT/tools' >> ~/.bashrc
source ~/.bashrc
Enter fullscreen mode Exit fullscreen mode

How Do I Verify the Installation? 

# Check version
dotnet --version
# Output: 10.0.100

# Full information
dotnet --info
Enter fullscreen mode Exit fullscreen mode

dotnet --info shows:

  • SDK versions installed
  • Runtime versions installed
  • Operating system details
  • Runtime identifier (RID)

What's Included in the SDK?

The .NET 10 SDK (version 10.0.100) includes:

Component Version
.NET Runtime 10.0.0
ASP.NET Core Runtime 10.0.0
.NET Desktop Runtime 10.0.0
C# 14.0
F# 10.0
Visual Basic 17.13

One download, everything included.

Should I Install the SDK or Runtime?

Install the SDK if you're developing apps:

# SDK includes everything
dotnet-sdk-10.0
Enter fullscreen mode Exit fullscreen mode

Install the runtime if you're only running apps:

# Smaller, just runs apps
dotnet-runtime-10.0        # Console apps
aspnetcore-runtime-10.0    # Web apps
Enter fullscreen mode Exit fullscreen mode

Most developers need the SDK.

Can I Have Multiple .NET Versions Installed?

Yes. .NET versions install side-by-side:

# Check all installed versions
dotnet --list-sdks
# 8.0.404
# 9.0.100
# 10.0.100

dotnet --list-runtimes
Enter fullscreen mode Exit fullscreen mode

Projects use the version specified in their .csproj:

<PropertyGroup>
    <TargetFramework>net10.0</TargetFramework>
</PropertyGroup>
Enter fullscreen mode Exit fullscreen mode

Or use global.json to pin SDK version:

{
    "sdk": {
        "version": "10.0.100"
    }
}
Enter fullscreen mode Exit fullscreen mode

How Do I Update .NET?

Windows 

winget upgrade Microsoft.DotNet.SDK.10
Enter fullscreen mode Exit fullscreen mode

Or download the latest installer.

macOS 

brew upgrade dotnet-sdk
Enter fullscreen mode Exit fullscreen mode

Linux 

# Ubuntu/Debian
sudo apt-get update && sudo apt-get upgrade dotnet-sdk-10.0

# Fedora
sudo dnf update dotnet-sdk-10.0
Enter fullscreen mode Exit fullscreen mode

How Do I Uninstall .NET?

Windows

Settings → Apps → Search ".NET" → Uninstall

Or use PowerShell:

winget uninstall Microsoft.DotNet.SDK.10
Enter fullscreen mode Exit fullscreen mode

macOS 

sudo rm -rf /usr/local/share/dotnet
Enter fullscreen mode Exit fullscreen mode

Linux 

# Ubuntu/Debian
sudo apt-get remove dotnet-sdk-10.0

# Fedora
sudo dnf remove dotnet-sdk-10.0
Enter fullscreen mode Exit fullscreen mode

What IDE Should I Use?

.NET 10 is supported by:

IDE Platform Notes
Visual Studio 2026 Windows Full IDE
VS Code + C# Dev Kit All Lightweight
JetBrains Rider All Full IDE

VS Code with C# Dev Kit auto-installs .NET if missing.

How Do I Create My First Project? 

# Console app
dotnet new console -n HelloWorld
cd HelloWorld
dotnet run

# Web API
dotnet new webapi -n MyApi
cd MyApi
dotnet run

# Blazor app
dotnet new blazor -n MyBlazorApp
cd MyBlazorApp
dotnet run
Enter fullscreen mode Exit fullscreen mode

Troubleshooting

"dotnet is not recognized"
PATH not set. Re-run installer or add manually:

# Windows (PowerShell)
$env:PATH += ";C:\Program Files\dotnet"

# macOS/Linux
export PATH=$PATH:/usr/local/share/dotnet
Enter fullscreen mode Exit fullscreen mode

Wrong version showing
Check global.json in your project directory. Remove it to use latest SDK.

Permission denied (Linux)
Don't install with sudo when using install scripts. Install to user directory.

Quick Reference

Platform Recommended Method Command
Windows WinGet winget install Microsoft.DotNet.SDK.10
macOS Homebrew brew install dotnet-sdk
Ubuntu apt sudo apt install dotnet-sdk-10.0
Fedora dnf sudo dnf install dotnet-sdk-10.0
Any Script ./dotnet-install.sh --channel 10.0
Any Snap snap install dotnet-sdk --channel=10.0

.NET 10 is an LTS release. Install once, receive updates for three years.

Written by Jacob Mellor, CTO at Iron Software. Jacob created IronPDF and leads a team of 50+ engineers building .NET document processing libraries.

Top comments (0)