Microsoft.Orleans.Runtime 10.4.0
Microsoft Orleans Runtime
Introduction
Microsoft Orleans Runtime is the core server-side component of Orleans. It hosts and executes grains, manages grain lifecycles, and provides all the runtime services necessary for a functioning Orleans server (silo).
Getting Started
To use this package, install it via NuGet:
dotnet add package Microsoft.Orleans.Runtime
This package is automatically included when you reference the Orleans Server metapackage.
Grain construction
Generated grain registrations preserve public constructor metadata for activation in trimmed and NativeAOT applications. The default grain activator uses dependency injection to select a public constructor, honors ActivatorUtilitiesConstructorAttribute, and resolves dependencies from each activation's service scope. Manual grain configuration uses GrainTypeOptions.AddClass(typeof(MyGrain)); manual manifest configuration uses TypeManifestOptions.AddInterfaceImplementation(typeof(MyGrain)). Both preserve the same constructor metadata. Direct Classes collection access and construction of a GrainClassMap from an arbitrary dictionary require callers to preserve constructors separately and emit trimming warnings.
File grain storage
The runtime includes a file-based grain storage provider for local, single-silo development and testing. It stores one binary file per grain state record and uses persisted ETags for optimistic concurrency.
using Orleans.Persistence.FileStorage;
siloBuilder.AddFileGrainStorage(
options: options => options.RootDirectory = Path.Combine(
AppContext.BaseDirectory,
"Orleans",
"GrainState"));
Example - Configuring a Silo
using Microsoft.Extensions.Hosting;
using Orleans.Configuration;
using Orleans.Hosting;
var builder = Host.CreateApplicationBuilder(args)
.UseOrleans(siloBuilder =>
{
siloBuilder
.UseLocalhostClustering();
});
await builder.Build().RunAsync();
Documentation
For more comprehensive documentation, please refer to:
Feedback & Contributing
- If you have any issues or would like to provide feedback, please open an issue on GitHub
- Join our community on Discord
- Follow the @msftorleans Twitter account for Orleans announcements
- Contributions are welcome! Please review our contribution guidelines
- This project is licensed under the MIT license
Showing the top 20 packages that depend on Microsoft.Orleans.Runtime.
| Packages | Downloads |
|---|---|
|
Microsoft.Orleans.TestingHost
Microsoft Orleans library for hosting a silo in a testing project.
|
2 |
|
Microsoft.Orleans.Persistence.AzureStorage
Microsoft Orleans persistence providers backed by Azure Storage
|
2 |
|
Microsoft.Orleans.Server
Collection of Microsoft Orleans libraries and files needed on the server.
|
2 |
|
Microsoft.Orleans.Persistence.Memory
In-memory storage for Microsoft Orleans
|
1 |
|
Microsoft.Orleans.Streaming
Streaming library for Microsoft Orleans used both on the client and server.
|
1 |
|
Microsoft.Orleans.TestingHost
Microsoft Orleans library for hosting a silo in a testing project.
|
1 |
|
Microsoft.Orleans.Server
Collection of Microsoft Orleans libraries and files needed on the server.
|
1 |
|
Microsoft.Orleans.Reminders.AzureStorage
Microsoft Orleans reminders provider backed by Azure Table Storage
|
1 |
|
Microsoft.Orleans.Clustering.AzureStorage
Microsoft Orleans clustering provider backed by Azure Table Storage
|
1 |
|
Microsoft.Orleans.Reminders
Reminders library for Microsoft Orleans used on the server.
|
1 |
.NET 10.0
- Microsoft.Orleans.Core (>= 10.4.0)
- Polly (>= 8.6.4)
- Polly.Extensions (>= 8.6.5)
- Microsoft.AspNetCore.Connections.Abstractions (>= 10.0.3)
- Microsoft.CodeAnalysis.Analyzers (>= 5.9.0)
- Microsoft.CodeAnalysis.Common (>= 5.0.0)
- Microsoft.CodeAnalysis.Workspaces.Common (>= 5.0.0)
- Microsoft.Extensions.Configuration (>= 10.0.5)
- Microsoft.Extensions.Configuration.Abstractions (>= 10.0.5)
- Microsoft.Extensions.Configuration.Binder (>= 10.0.5)
- Microsoft.Extensions.Configuration.Json (>= 10.0.5)
- Microsoft.Extensions.DependencyInjection (>= 10.0.5)
- Microsoft.Extensions.DependencyInjection.Abstractions (>= 10.0.5)
- Microsoft.Extensions.DependencyModel (>= 10.0.5)
- Microsoft.Extensions.Hosting (>= 10.0.5)
- Microsoft.Extensions.Hosting.Abstractions (>= 10.0.5)
- Microsoft.Extensions.Logging (>= 10.0.5)
- Microsoft.Extensions.Logging.Abstractions (>= 10.0.5)
- Microsoft.Extensions.Logging.Console (>= 10.0.5)
- Microsoft.Extensions.Logging.Debug (>= 10.0.5)
- Microsoft.Extensions.ObjectPool (>= 10.0.5)
- Microsoft.Extensions.Options (>= 10.0.5)
- Microsoft.Extensions.Options.ConfigurationExtensions (>= 10.0.5)
- Newtonsoft.Json (>= 13.0.4)
- System.IO.Hashing (>= 10.0.3)
- System.Memory.Data (>= 10.0.3)
.NET 8.0
- Microsoft.Orleans.Core (>= 10.4.0)
- Polly (>= 8.6.4)
- Polly.Extensions (>= 8.6.5)
- Microsoft.AspNetCore.Connections.Abstractions (>= 8.0.24)
- Microsoft.CodeAnalysis.Analyzers (>= 5.9.0)
- Microsoft.CodeAnalysis.Common (>= 4.5.0)
- Microsoft.CodeAnalysis.Workspaces.Common (>= 4.5.0)
- Microsoft.Extensions.Configuration (>= 8.0.0)
- Microsoft.Extensions.Configuration.Abstractions (>= 8.0.0)
- Microsoft.Extensions.Configuration.Binder (>= 8.0.2)
- Microsoft.Extensions.Configuration.Json (>= 8.0.1)
- Microsoft.Extensions.DependencyInjection (>= 8.0.1)
- Microsoft.Extensions.DependencyInjection.Abstractions (>= 8.0.2)
- Microsoft.Extensions.DependencyModel (>= 8.0.2)
- Microsoft.Extensions.Hosting (>= 8.0.1)
- Microsoft.Extensions.Hosting.Abstractions (>= 8.0.1)
- Microsoft.Extensions.Logging (>= 8.0.1)
- Microsoft.Extensions.Logging.Abstractions (>= 8.0.3)
- Microsoft.Extensions.Logging.Console (>= 8.0.1)
- Microsoft.Extensions.Logging.Debug (>= 8.0.1)
- Microsoft.Extensions.ObjectPool (>= 8.0.24)
- Microsoft.Extensions.Options (>= 8.0.2)
- Microsoft.Extensions.Options.ConfigurationExtensions (>= 8.0.0)
- Newtonsoft.Json (>= 13.0.4)
- System.IO.Hashing (>= 10.0.3)
- System.IO.Pipelines (>= 8.0.0)
- System.Memory.Data (>= 8.0.1)
| Version | Downloads | Last updated |
|---|---|---|
| 10.4.0 | 2 | 10/10/2026 |
| 10.3.1 | 0 | 08/28/2026 |
| 10.3.0 | 0 | 08/27/2026 |
| 10.3.0-rc.1 | 0 | 08/25/2026 |
| 10.2.2 | 0 | 07/21/2026 |
| 10.2.2-rc.2 | 0 | 07/15/2026 |
| 10.2.2-rc.1 | 0 | 07/10/2026 |
| 10.2.1 | 0 | 06/24/2026 |
| 10.2.1-preview.1 | 0 | 06/19/2026 |
| 10.2.0 | 0 | 06/12/2026 |
| 10.1.1-preview.1 | 0 | 05/13/2026 |
| 10.1.0 | 0 | 04/14/2026 |
| 10.0.1 | 0 | 02/07/2026 |
| 10.0.0 | 0 | 01/20/2026 |
| 10.0.0-rc.2 | 0 | 12/31/2025 |
| 9.2.1 | 0 | 07/16/2025 |
| 9.2.0 | 0 | 07/14/2025 |
| 9.2.0-preview3 | 0 | 06/10/2025 |
| 9.2.0-preview2 | 0 | 06/04/2025 |
| 9.2.0-preview1 | 0 | 04/04/2025 |
| 9.1.2 | 0 | 02/13/2025 |
| 9.0.1 | 0 | 11/23/2024 |
| 9.0.0 | 0 | 11/14/2024 |
| 8.2.0 | 1 | 10/11/2026 |
| 8.2.0-preview1 | 0 | 05/22/2024 |
| 8.1.0 | 0 | 04/17/2024 |
| 8.1.0-preview3 | 0 | 03/11/2024 |
| 8.1.0-preview2 | 1 | 10/10/2026 |
| 8.1.0-preview1 | 0 | 02/13/2024 |
| 8.0.0 | 0 | 01/05/2024 |
| 8.0.0-rc2 | 0 | 12/20/2023 |
| 8.0.0-rc1 | 0 | 12/04/2023 |
| 7.2.7 | 0 | 10/15/2024 |
| 7.2.6 | 0 | 03/09/2024 |
| 7.2.5 | 0 | 02/22/2024 |
| 7.2.4 | 0 | 12/02/2023 |
| 7.2.3 | 0 | 11/03/2023 |
| 7.2.2 | 0 | 10/16/2023 |
| 7.2.1 | 0 | 07/11/2023 |
| 7.2.0 | 0 | 07/07/2023 |
| 7.1.2 | 0 | 04/19/2023 |
| 7.1.1 | 0 | 03/23/2023 |
| 7.1.0 | 0 | 02/01/2023 |
| 7.0.0 | 0 | 11/08/2022 |
| 7.0.0-rc2 | 0 | 10/19/2022 |