Menu

.Net/C# RabbitMQ Client Library Build Instructions

This section describes the process for obtaining a copy of the RabbitMQ .Net/C# RabbitMQ client library source code, as well as instructions for building the .Net/C# client libraries from source.

Obtaining the source

  • Either download a released source code distribution from the download page, or
  • Check the code out directly from our GitHub repositories: 
    git clone https://github.com/rabbitmq/rabbitmq-dotnet-client.git

Required Libraries and Tools

To build the .NET/C# client libraries on Windows, you will need

  • Microsoft's .NET 4.0 or later
  • Microsoft Visual Studio® 2015 or later (optional, Community edition is fine)

Building the source

On Windows, with Visual Studio

To build the source with Visual Studio you need to:

  • Run build.bat. This will perform the required code generation as well as building a release version of the code.
  • Open RabbitMQDotNetClient.sln in Visual Studio. That may fail if the version of Visual Studio used is different from the one that created the solution file. In most such cases this can be corrected by opening the solution file in a text editor and adjusting the Format Version number at the beginning.
  • Build the solution.

On Windows, without Visual Studio

To build the source without Visual Studio:

  • Run build.bat. This will perform the required code generation as well as building a release version of the code.

On Linux

The library can be built on Linux with Mono, but only with Mono version 3.8 and later. You can obtain the latest versions of Mono at mono-project.com

Once you have installed a suitable version of Mono, and obtained the RabbitMQ .Net/C# RabbitMQ client library source code, to build the library you should:

  • Run build.sh. This will perform the required code generation as well as building a release version of the code.

Getting Help and Providing Feedback

If you have questions about the contents of this guide or any other topic related to RabbitMQ, don't hesitate to ask them on the RabbitMQ mailing list.

Help Us Improve the Docs <3

If you'd like to contribute an improvement to the site, its source is available on GitHub. Simply fork the repository and submit a pull request. Thank you!