Microsoft Orleans

Building Real-Time Orleans Applications with SignalR


Real-time applications allow users to receive updates and notifications in real-time, rather than having to refresh the page or make periodic requests to the server. This can be a powerful feature for Orleans applications, as it allows you to build interactive and responsive applications that can deliver timely and relevant information to users.

In this post, we will explore how to build real-time Orleans applications using SignalR, a real-time communication library for .NET. We will provide step-by-step instructions for setting up your development environment, creating your first real-time Orleans application, and deploying it to Azure.


Before getting started, you will need to have the following prerequisites:

  • An Azure account: If you don’t already have an Azure account, you can sign up for a free trial at
  • The SignalR NuGet package: To add the SignalR NuGet package to your project, run the following command: dotnet add package Microsoft.AspNetCore.SignalR.

Creating your first real-time Orleans application:

To create your first real-time Orleans application, follow these steps:

  • Create a new ASP.NET Core web application: To create a new ASP.NET Core web application, open a terminal window and run the following command: dotnet new webapp. This will create a new ASP.NET Core web application in the current directory.
  • Add the Orleans NuGet package: To add the Orleans NuGet package to your project, run the following command: dotnet add package Orleans.
  • Add SignalR to your application: To add SignalR to your application, you will need to configure the SignalR service and middleware in your application’s Startup class. To do this, modify the ConfigureServices method to add the SignalR service and the SignalR hub route:
public void ConfigureServices(IServiceCollection services)
    // Add SignalR service

    // Add SignalR hub route
    app.UseEndpoints(endpoints =>
  • Create a SignalR hub: To create a SignalR hub, create a new class that inherits from the Hub class and define your hub methods. For example:
public class MyHub : Hub
    public async Task SendMessage(string message)
        await Clients.All.SendAsync("ReceiveMessage", message);

In this example, the SendMessage method sends a message to all connected clients by calling the SendAsync method on the Clients object.

  • Create an Orleans grain: To create an Orleans grain, create a new class that implements the IGrain interface and define your grain logic. You can use the IClientProxy interface to send messages to the SignalR hub from your grain, as shown below:
  • Deploy your application to Azure: To deploy your application to Azure, you will need to create an Azure App Service and deploy your code to it. You can do this using the Azure Functions Core Tools or the Azure portal.


By following the steps outlined in this post, you can build and deploy real-time Orleans applications using SignalR. With SignalR, you can build interactive and responsive Orleans applications that deliver timely and relevant information to users in real-time. Whether you are building chat applications, gaming applications, or other types of real-time applications, SignalR is a powerful tool that can help you deliver a seamless and engaging user experience.

That being said, it’s important to keep in mind that real-time applications can consume more resources and require more careful planning and optimization compared to traditional applications. As such, it’s important to carefully consider the performance and scalability implications of using SignalR in your Orleans applications, and to use best practices such as message batching and connection management to optimize the performance of your applications.

By following best practices and using the tools and techniques discussed in this post, you can build reliable and scalable real-time Orleans applications with SignalR.