Introducing the JetBrains redistributable of MSBuild

Over the past year, JetBrains Rider has become the primary IDE for many .NET developers. Many of our users have been asking us about how they can develop and build their applications without having Visual Studio 2017 installed. The answer is simple on macOS and on Linux, where Mono can be installed. And for .NET Core projects, all we need is the .NET Core SDK which exists for Windows, macOS and Linux.

Things get a bit more interesting when developing and building apps for the full .NET Framework on Windows… Rider will use the tools that are available after installing the Microsoft Build Tools 2017, but these come with one caveat in their license agreement: a validly licensed copy of Visual Studio is required.

Since all we need from the build tools is MSBuild, which is MIT-licensed, we are providing a JetBrains redistributable of MSBuild that can be used freely.

Once downloaded and extracted on our machine, we can configure Rider to use it. From Rider’s settings, under Build, Execution, Deployment | Toolset and Build, then Use MSBuild version, we can specify the Custom MSBuild executable we just extracted.

Set custom MSBuild version in JetBrains Rider

Our redistributable of MSBuild is built from our GitHub fork of the official MSBuild repository. We’re not planning on creating a custom MSBuild version – we just want to provide an MIT-licensed build. In case you have any PR’s, head over to the original repository by Microsoft.

Note that our redistributable excludes some of the proprietary targets files, such as Microsoft.WebApplication.targets. The Mono project does have a stub that could help here.

In summary, to use Rider to develop full .NET framework applications on Windows without the need to have Visual Studio installed:

  1. Download and extract the JetBrains redistributable of MSBuild
  2. Download and install Microsoft .NET Framework Developer Pack 4.5.1 or later
  3. Configure Rider to use a custom MSBuild executable
  4. For any other application types, check the list of prerequisites for using Rider under Windows without Visual Studio

Download Rider now and give it a try with our redistributable of MSBuild. We’d love to hear your feedback!

Update June 15, 2018: Updated binaries to include fix for “The “GetReferenceNearestTargetFrameworkTask” task was not found.” when building app project with reference to library project if .NET Core cross-platform development workload not installed.

About Maarten Balliauw

Maarten Balliauw is a Developer Advocate at JetBrains, working on .NET tools. He focuses on .NET, Azure, web technologies and application performance. Maarten is a frequent speaker at various national and international events. In his free time, he brews his own beer. Follow him on Twitter or check his personal blog.
This entry was posted in How-To's and tagged , , , . Bookmark the permalink.

32 Responses to Introducing the JetBrains redistributable of MSBuild

  1. Denis Marinov says:

    Doesn’t the Dotnet SDK come with a MSBuild ( already?

  2. Vadym K says:

    Would be great to download MSBuild as we download drivers in datagrip – without leaving IDE.

  3. Christian Schuster says:

    Maybe I’m mistaken but wouldn’t the “Community” edition of the MSBuild tools suffice (I assume that counts as a validly licensed VS)?

  4. Yahor says:

    Can’t it be on the Nuget? So, will make it easier to upgrade?

  5. Adnan says:

    Can I build Setup project files .vdproj files? Because that is one of the main disaveteges from MSBuild.

    And what about missing NuGet packages? Are they automaticily downloaded?

    • Packages will be downloaded. For setup projects, you will need the targets for that on your machine as well.

      • Nate Guerin says:

        This is of interest to me as well. I’d love to be able to build setup projects using your version of MSBuild without installing VS.

        When you say that the targets for setup projects need to be on your machine, what do you mean exactly? Would it be possible to point us towards some documentation that might help us set this up?

        • MSBuild uses targets files (usually containing build tasks) to be able to build certain application types. For web apps, these targets are available with a bit of searching.

          For several other project types (e.g. Azure Cloud Services), the targets usually ship with the SDK provided by Microsoft.

          And lately, may targets are appearing on, and can be included in your project file instead of having to rely on the targets being installed on your machine. Some examples can be seen searching NuGet for “targets” or “msbuild”.

  6. Georg says:

    Thanks for providing the JetBrains redistributable of MSBuild! I tried switching to this version. Now the projects fail to load with the following error message: “5:40 PM Project ‘DbContextScope’ load failed: The SDK ‘Microsoft.NET.Sdk’ specified could not be found. C:\code\Backend\DbContextScope\DbContextScope.csproj at (0:0)”

    Content of “DbContextScope.csproj”


    It works perfectly fine when switching back to the MSBuild provided by the Microsoft Build Tools 2017. Any ideas?

  7. Sandor Drieënhuizen says:

    Too bad this leaves me stuck at C# 7.2 for now…

  8. Rhiannon Tully-Barr says:

    I’m having a minor issue using this MSBuild version: It’s not automatically detected by NuGet (despite being on my Path, and NuGet’s auto-detection claiming to use the version from the path by default). It’s finding the version included with the .NET developer pack instead.

    Any workarounds, or plans to include an installer in future so that NuGet is able to detect MSBuild?

  9. Jose Alvarez says:

    I´m having some problems trying to build my solution with multiple projects inside with this Redistributable MSBuild, but not with Visual Studio one.

    error CS0246: The type or namespace name ‘LiveJob’ could not be found (are you missing a using directive or
    an assembly reference?)


  10. Janatbek says:

    what about mono executable?
    how and where I can find it?

  11. Rhiannon says:


    Does this redistributable contain the 32-bit version of MSBuild only?
    I’m trying to build a project with it and am running into an error:

    error MSB4216: Could not run the “GenerateResource” task because MSBuild could not create or connect to a task host with runtime “CLR4” and architecture “x64”. Please ensure that
    (1) the requested runtime and/or architecture are available on the machine, and
    (2) that the required executable “C:\SDK\MSBuild\15.0\Bin\amd64\MSBuild.exe” exists and can be run.

    There is no Bin\amd64 folder in the redistributable, so I’m wondering if I need to point to the 64-bit MSBuild located elsewhere or if it is truly missing.

Leave a Reply to Sandor Drieënhuizen Cancel reply

Your email address will not be published. Required fields are marked *