.NET SDK
Microsoft, .NET Foundation and contributors · Microsoft’s free, open-source development toolkit for building, testing and publishing .NET applications, including the CLI and matching runtimes.
brew install --cask dotnet-sdk- 30-day installs
- 21,192
- #17 in App
- 1-year installs
- 128.4K
- Last 365 days
- Latest version
- 11.0.100
- Download size
- 196MB
- pkg
- Release cadence
- Daily
- 9 releases in 30 days
About
Microsoft .NET SDK is the command-line toolkit for building, testing, and publishing .NET apps and libraries on macOS. It includes the dotnet CLI, compilers, templates, MSBuild, and the matching .NET and ASP.NET Core runtimes. Use it for console apps, web services, class libraries, tests, and supported platform workloads, with a compatible editor or IDE; it is not a standalone IDE or a Java runtime.
What the SDK includes and what you can build
The SDK is the build-time package for .NET. It contains the dotnet command, the C# and F# compilers, project templates, MSBuild, NuGet restore, the test runner and the publishing tools. An SDK installation also includes the .NET Runtime and ASP.NET Core Runtime for its own release, so the same install can build and run an app. A runtime-only install can run an app but cannot build one.
Typical uses include console tools, web APIs and services, class libraries, automated tests and supported platform workloads. New projects can be created with dotnet new, dependencies restored with dotnet restore, builds run with dotnet build, and published output produced with dotnet publish. For editing, use any compatible editor or IDE; the SDK does not install a standalone Mac GUI or IDE. The Developer Workbench collection lists other command-line and developer tools for macOS.
Install on Mac, set PATH and create a working project
The official Microsoft PKG is the primary installer. Homebrew users can install the same cask with brew install --cask dotnet-sdk; Homebrew selects the Arm64 PKG on Apple Silicon and the x64 PKG on Intel, and creates the dotnet and dnx command links. Microsoft also documents dotnet-install. and manual tar.gz options for automation or non-admin installs. Reopen Terminal after installation if dotnet is not found.
Check the installation with dotnet --info, dotnet --version, dotnet --list-sdks and dotnet --list-runtimes. The official PKG normally configures the path. For script or manual installs, add the install directory to PATH; Arm64 installs under /, and x64 builds use /. Some tools read DOTNET_ROOT, so set it when a tool cannot find the runtime.
To create a starter console project, run dotnet new console -o HelloWorld, change into the directory with cd HelloWorld, and run dotnet run. A global. file can pin a project to a specific SDK and control roll-forward when several SDKs are installed; dotnet --list-sdks shows what is available. The .NET SDK version history records the cask versions, their matching runtimes and release dates.
macOS requirements and architecture
Microsoft's .NET 10 supported-OS matrix lists macOS 15, 26 and 27 on Arm64 and x64. On Apple Silicon, the Arm64 build runs natively, and the x64 build can run under Rosetta 2. macOS 14 appears in the out-of-support table with an end-of-life date of 2026-09-14. Microsoft's macOS installation page still lists an older set of versions; the supported-OS matrix is the more recently updated reference, so check it before deployment.
The Homebrew cask declares macOS 12 or later. That number is Homebrew's installation minimum, not Microsoft's support commitment. The cask also declares arm64 and x64 variants and conflicts with dotnet-runtime, dotnet-runtime@preview and dotnet-sdk@preview. Optional workloads for mobile, desktop or Native AOT can require extra platform tools such as Xcode, workload packs or signing credentials. Microsoft does not publish one RAM or disk minimum for every workload; projects, caches and optional workloads determine the footprint. See the Languages category for other language runtimes and SDKs.
Price, licence and telemetry
The SDK is free to download and use. The dotnet/ repository uses the MIT licence and includes notices for additional components. The Homebrew cask notes that its package may include extra closed-source components, so the terms in the installer's notices or EULA apply to those parts; this is not an all-open-source package in every respect. NuGet packages, commercial IDEs, private feeds, cloud hosting and code-signing services can carry separate licences or costs.
Microsoft-distributed SDK builds enable CLI telemetry by default. Set DOTNET_CLI_TELEMETRY_OPTOUT= (or true) to opt out; the setting must be present before the installer runs if you also want to skip the installer's telemetry event.
Versions and support status
The current cask is SDK 10.0.403, released on 2026-10-25, with .NET Runtime 10.0.14. SDK and runtime version numbers differ: the SDK number identifies the toolchain, and the runtime number identifies the runtime it carries.
| .NET | Support type | Support period | Current patch (2026-11-04) | Homebrew cask history |
|---|---|---|---|---|
| 10 | LTS | 2025-11-11 to 2028-11-14 | 10.0.14 / SDK 10.0.403 | latest 10.0.403 |
| 9 | STS | 2024-11-12 to 2026-11-10 | 9.0.22 / SDK 9.0.320 | ends at 9.0.307 (2025-11-19) |
| 8 | LTS | 2023-11-14 to 2026-11-10 | 8.0.33 / SDK 8.0.427 | ends at 8.0.404 (2024-11-12) |
| 7 | STS | ended 2024-05-14 (EOL) | 7.0.20 / SDK 7.0.410 | ends at 7.0.403 (2023-10-24) |
The cask history is not Microsoft's full patch list. .NET 9 and .NET 8 reach end of support on 2026-11-10, so plan a move to .NET 10; .NET 7 is already out of support. Use the version page for the per-release record and Microsoft's release notes for the authoritative support dates.
Alternatives and adjacent runtimes
Temurin 17 and Amazon Corretto 11 are Java runtimes, not drop-in replacements for the .NET SDK. Choose them for Java workloads and keep JAVA_HOME separate from DOTNET_ROOT; they can coexist with .NET on the same Mac. See Temurin 17 and Corretto 11 for their support terms. For .NET itself, the practical alternatives are installing a different SDK version side by side, using the official PKG instead of the cask, or using a runtime-only install when you only need to run an existing app.
FAQ
Is the .NET SDK free?
Yes. The SDK and the .NET runtime are free to download and use, and the dotnet/ source is MIT-licensed. NuGet packages, commercial IDEs, cloud services and signing services may have their own terms. The Homebrew cask may include additional closed-source components; check the installer notices.
Does the SDK include a runtime?
Yes. Each SDK release includes the matching .NET Runtime and ASP.NET Core Runtime, so one install can build and run apps. A runtime-only install can run an app but does not include the compiler, templates or CLI build commands.
Which macOS versions does .NET 10 support?
Microsoft's current supported-OS matrix lists macOS 15, 26 and 27 on Arm64 and x64. macOS 14 is out of support as of 2026-09-14. The Homebrew cask's macOS 12 minimum is an installation requirement, not a Microsoft support statement.
Should I install the Arm64 or x64 build on Apple Silicon?
Use the Arm64 build for native performance. The x64 build is supported through Rosetta 2 when a workload or tool requires it. Homebrew chooses the matching package automatically; avoid mixing architectures for the same SDK installation.
What is the difference between the SDK and the .NET Runtime?
The SDK builds, tests and publishes .NET apps. The runtime runs them. The SDK includes its matching runtime, while a runtime-only installation cannot build or publish a project.
How do I update the cask or pin an SDK?
Update with brew upgrade --cask dotnet-sdk, or install a newer official PKG. To keep a project on a specific SDK, add a global. with that SDK version; dotnet --list-sdks lists what is installed. Back up project files before changing SDK versions.
Last updated: 2026-11-04. Sources: Microsoft .NET release notes and support policy, the .NET 10 supported-OS matrix, the Microsoft Learn macOS install guide, and Homebrew cask metadata.
Official references
At a glance
- System
- macOS 12 or later
- Chip
- Apple silicon · Intel
- Auto-updates
- No
- Repository
- Open source · MIT · Updated 1 day ago★3.3K
- Developer
- Microsoft, .NET Foundation and contributors
- Homebrew
- Available; updated by Homebrew
- Also known as
- dotnet-sdk
- Homepage
- www.microsoft.com/net/core#macos
- Token
- dotnet-sdk
Checked
How to install .NET SDK on Mac
Homebrew runs the dotnet-sdk-11.0.100-osx-arm64.pkg installer, which asks for an administrator password.
Install without Homebrew
Download the file Homebrew uses for your chip: Install Details
Uninstall .NET SDK and optional data cleanup
brew uninstall --cask dotnet-sdkA regular uninstall removes the app and keeps its settings and caches.
Deep clean (optional)
brew uninstall --zap --cask dotnet-sdk--zap also deletes the settings, caches and other files listed in the Homebrew definition. They can include data shared with other apps and cannot be restored, and it does not guarantee that nothing is left. Back up any data you need first. To keep settings and caches, leave out --zap.
Questions about .NET SDK
Is .NET SDK safe?
.NET SDK is in Homebrew’s official catalog and has not been disabled. Since September 2026, Homebrew disables apps that fail macOS Gatekeeper checks. When installing, Homebrew checks the download from builds.dotnet.microsoft.com against its SHA-256 checksum. It was installed 21,192 times through Homebrew in the last 30 days.
Is .NET SDK open source?
.NET SDK’s source code is public on GitHub (dotnet/sdk) under the MIT license.
How do I completely uninstall .NET SDK on a Mac?
Run brew uninstall --cask dotnet-sdk. It forgets 3 installer receipts. To delete its settings and caches as well, run brew uninstall --zap --cask dotnet-sdk. --zap also deletes the settings, caches and other files listed in the Homebrew definition. They can include data shared with other apps and cannot be restored, and it does not guarantee that nothing is left. Back up any data you need first. To keep settings and caches, leave out --zap. That also deletes 4 files and folders, including ~/.
Does .NET SDK run on Apple silicon (M1 and later) Macs?
Yes. Homebrew downloads separate builds for Apple silicon and Intel Macs. It needs macOS 12 or later.
Where does .NET SDK store its settings and data?
Its data is in ~/ and ~/. These locations come from Homebrew’s clean-up list.
What is the latest version of .NET SDK?
The latest version is 11.0.100, added to Homebrew on Nov 11, 2026. Run brew upgrade --cask dotnet-sdk to update it. Homebrew also offers dotnet-sdk@preview, which cannot be installed alongside it.
What else does installing .NET SDK add?
It also adds 2 command-line tools: dotnet and dnx. It installs through a .pkg installer, which asks for an administrator password. It cannot be installed alongside dotnet-runtime and dotnet-runtime@preview.
Similar Apps
- PostmanAPI development and testing desktop app for requests, collections, scripted tests and team workspaces, with account and plan limits for cloud features.
- Flutter SDKOpen-source Dart toolkit for building Android, iOS, web, and desktop applications with reusable widgets, hot reload, and integrated development tools.
- GitHub Copilot CLITerminal AI coding assistant for understanding, planning, editing, and debugging projects, with GitHub integration, custom agents, and MCP tools.
- ZedFast native code editor with language tooling, Git, terminal, collaboration, remote development and optional AI agents on macOS, Linux and Windows.