Installation

Install Nimbus and its dependencies in your .NET project

Prerequisites

• .NET 9
• NuGet Package Manager

Install Core Packages

Install the core Nimbus package:

dotnet add package Nimbus
dotnet add package Nimbus.InfrastructureContracts
dotnet add package Nimbus.MessageContracts

Or via Package Manager Console:

Install-Package Nimbus
Install-Package Nimbus.InfrastructureContracts
Install-Package Nimbus.MessageContracts

Choose a Transport

Select and install one or more transport packages based on your needs:

Azure Service Bus

dotnet add package Nimbus.Transports.AzureServiceBus

Use case: Production-grade cloud messaging with enterprise features

Redis

dotnet add package Nimbus.Transports.Redis

Use case: Fast messaging for development, testing, and production scenarios

AMQP

dotnet add package Nimbus.Transports.AMQP

Use case: Open standard AMQP 1.0 transport, tested with ActiveMQ Artemis

In-Process

dotnet add package Nimbus.Transports.InProcess

Use case: Unit testing and integration testing without external dependencies

Additional Packages

Dependency Injection

For Autofac integration:

dotnet add package Nimbus.Containers.Autofac

Serialization

For JSON serialization (DataContract is included by default):

dotnet add package Nimbus.Serializers.Json

Logging

Choose your preferred logging framework:

# For Serilog
dotnet add package Nimbus.Logger.Serilog

# For Log4net
dotnet add package Nimbus.Logger.Log4net

Large Messages

For handling large messages with Azure Blob Storage:

dotnet add package Nimbus.LargeMessages.Azure

Verify Installation

Create a simple test to verify Nimbus is installed correctly:

using Nimbus;
using Nimbus.MessageContracts;

public class TestCommand : IBusCommand
{
    public string Message { get; set; }
}

// If this compiles, Nimbus is installed correctly!

Next Steps

Now that Nimbus is installed, let’s send your first message:

→ Send Your First Message