You’ve decided to start building applications with C#, or you’ve encountered an error message asking you to install .NET to run a program. The first step—downloading the correct version—can feel confusing if you’re new to the ecosystem. The good news is that it’s a straightforward process once you understand what you’re installing and why.
This guide is designed to cut through the noise. We’ll walk you through downloading .NET across Windows, macOS, and Linux, explaining your options so you can get back to what matters—building software or running your applications.
What Exactly Are You Downloading?
Before you click a download button, it’s helpful to understand what .NET actually is. In simple terms, .NET is a free, cross-platform, open-source developer platform. It provides the tools and libraries needed to build and run various applications, from web APIs and mobile apps to console tools and cloud services.
When you download .NET, you usually choose between two primary packages:
-
.NET SDK (Software Development Kit): This is what you need if you plan to write code and build applications . It includes the .NET runtime (to run apps) plus compilers, project templates, and the command-line interface (CLI) tools. It’s the all-in-one package for developers.
-
.NET Runtime: This is the stripped-down version required to run an application that someone else has already built. If a program you’ve installed on your machine says it needs .NET, this is what you’re being asked for .
For most people reading a development guide, you will want the .NET SDK.
Step-by-Step: How to Download and Install .NET
The process differs slightly depending on your operating system. We’ll cover the most common environments here.
Windows Installation
-
Go to the Official Download Page: Navigate to the official Microsoft .NET download page at
dotnet.microsoft.com/download. This is the only source you should use to ensure you get a safe, genuine build. -
Choose Your Version: The website usually highlights the latest Long Term Support (LTS) version. As of the current release schedule, .NET 10 is the latest LTS version (released November 2025), while .NET 9 is a Standard Term Support (STS) version . If you’re unsure, the LTS version is often recommended for its longer support period and stability.
-
Select the Installer: Click the “Download .NET SDK x64” button . If you know you have an ARM-based Windows device (like some Surface Pro models), select the Arm64 option .
-
Run the Installer: Once the
.exefile is downloaded, run it. Follow the wizard’s prompts, and you’ll be up and running in a few minutes.
macOS Installation
Installing on macOS is equally simple. You can use a graphical installer or the command line.
-
Using a Graphical Installer (.pkg): Download the SDK from the official site. Ensure you pick the correct architecture for your Mac. If you have an M1/M2/M3 chip (Apple Silicon), choose the Arm64 version. If you have an older Intel-based Mac, choose the x64 version .
-
Using the Command Line: For a faster approach, you can use
curlto download the binary archive. The official .NET GitHub repository outlines this process, which involves downloading the.tar.gzfile, extracting it, and setting theDOTNET_ROOTandPATHenvironment variables .
Linux Installation
Most Linux distributions have .NET available in their official package managers. For instance, on Ubuntu, you can install the SDK using apt-get:
sudo apt-get update && sudo apt-get install -y dotnet-sdk-8.0
For other distributions or the latest versions not in the package manager, you can download the binaries directly from the official site .
Understanding .NET Versions and Support Lifecycle
Choosing which version to download is crucial. Microsoft releases a new major version every November, alternating between LTS and STS releases .
-
LTS (Long Term Support): These releases have a longer support period, typically around three years, providing a stable foundation for enterprise applications. .NET 8 and .NET 10 are LTS releases.
-
STS (Standard Term Support): These releases are supported for a shorter period, usually around 18 months, but often include the latest features and performance improvements. .NET 9 is an STS release .
If you are starting a new production project, the latest LTS version (.NET 10 as of 2026) is generally the safest bet. Avoid versions that are out of support, like .NET 5, 6, or 7, as they no longer receive security updates .
Verifying Your Installation
Once the installation is complete, it’s good practice to verify that everything is working correctly. Open your terminal (Command Prompt on Windows, Terminal on Mac/Linux) and run the following command:
dotnet --version
If successful, this command will print the version number of the SDK you have installed, such as 10.0.101 or 9.0.302 . This confirms that the dotnet command is now globally available in your system path.
Key Components Included in .NET
When you download the SDK, you’re getting a comprehensive suite of tools and libraries, not just a runtime. Based on the official release manifests, here are some of the core components you’ll have access to :
-
ASP.NET Core Runtime: For building and running web applications and APIs.
-
Entity Framework Core: A modern object-database mapper for data access.
-
Microsoft.Extensions (Logging, Dependency Injection, Configuration): A collection of common patterns and utilities foundational to modern .NET applications.
-
SignalR: For adding real-time web functionality to your apps.
-
Project Templates: Pre-built structures for web apps, console apps, and class libraries to get started quickly.
Conclusion: Build or Run with Confidence
Downloading .NET is the gateway to one of the most powerful and versatile development ecosystems available today. By choosing the correct package (SDK vs. Runtime) and the appropriate version (LTS vs. STS), you ensure your system is prepared for either development or deployment. Always download from the official Microsoft source to guarantee security and reliability.
Now that you have .NET installed, you’re ready to write your first “Hello World” app or run the application that required this powerful framework.
About the Author
