This repo contains the code to build the .NET Core runtime, libraries and shared host (dotnet) installers for
all supported platforms, as wel as the sources to .NET Core runtime and libraries.
Official Starting Page: https://dotnet.microsoft.com/
- How to use .NET (with VS, VS Code, command-line CLI)
- Install official releases
- Documentation (Get Started, Tutorials, Porting from .NET Framework, API reference, ...)
- Supported OS versions
- Roadmap
- Releases
We welcome contributions! Many people all over the world have helped make this project better.
-
If you have a question or idea, file a new issue.
- Is your feedback for .NET Framework? This repo is for .NET Core. If you are having issues with the "full" .NET Framework (also called "Desktop"), the best way to file a bug is the Report a Problem tool, which is integrated with the VS Developer Community Portal; or through Product Support if you have a contract.
-
If you want to contribute a fix or improvement, you'll want to check out these links (some of these point to our original repos while work continues to consolidate here)
- Requirements to build this repo (Linux, macOS, Windows)
- What kind of contributions you might want to make and repo guidelines
- How you can make a change happen!
- How to build and test your change
- More information in the detailed readme here
Security issues and bugs should be reported privately, via email, to the Microsoft Security Response Center (MSRC) [email protected]. You should receive a response within 24 hours. If for some reason you do not, please follow up via email to ensure we received your original message. Further information, including the MSRC PGP key, can be found in the Security TechCenter.
Also see info about related Microsoft .NET Core and ASP.NET Core Bug Bounty Program.
This repo should contain issues that are tied to the runtime, the class libraries and frameworks, the installation of the dotnet binary (sometimes known as the muxer) and installation of the .NET Core runtime and libraries.
For other issues, please use the following repos:
- For overall .NET Core SDK issues, file in the dotnet/toolset repo
- For ASP.NET issues, file in the aspnet/aspnetcore repo.
Note: Our Linux packages (.deb and .rpm) are put together slightly differently than the Windows and Mac specific installers. Instead of combining everything, we have separate component packages that depend on each other. If you're installing these directly from the installer files (via dpkg or similar), then you'll need to install them in the order presented above.
.NET Core is a .NET Foundation project.
There are many .NET related projects on GitHub.
- .NET home repo - links to 100s of .NET projects, from Microsoft and the community.
- ASP.NET Core home - the best place to start learning about ASP.NET Core.
This project has adopted the code of conduct defined by the Contributor Covenant to clarify expected behavior in our community. For more information, see the .NET Foundation Code of Conduct.
General .NET OSS discussions: .NET Foundation forums
- .NET Core source index / .NET Framework source index
- API Reference docs
- .NET API Catalog (incl. APIs from daily builds and API usage info)
- API docs writing guidelines - useful when writing /// comments
.NET (including the runtime repo) is licensed under the MIT license.