Microsoft.Orleans.Runtime 10.3.1
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.
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.Clustering.Redis
Microsoft Orleans Clustering implementation that uses Redis
|
2 |
|
Microsoft.Orleans.Clustering.Redis
Microsoft Orleans Clustering implementation that uses Redis
|
1 |
|
Orleans.Clustering.Kubernetes
Microsoft Orleans clustering provider backed by Kubernetes
|
1 |
.NET 10.0
- Microsoft.Orleans.Core (>= 10.3.1)
- Microsoft.Extensions.DependencyInjection.Abstractions (>= 10.0.5)
- Polly.Extensions (>= 8.6.5)
- Microsoft.AspNetCore.Connections.Abstractions (>= 10.0.3)
- Microsoft.CodeAnalysis.Analyzers (>= 3.11.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)
- Polly (>= 8.6.4)
- Microsoft.Extensions.DependencyModel (>= 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)
- Microsoft.Extensions.Hosting (>= 10.0.5)
.NET 8.0
- Microsoft.CodeAnalysis.Analyzers (>= 3.11.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)
- Microsoft.AspNetCore.Connections.Abstractions (>= 8.0.24)
- Polly.Extensions (>= 8.6.5)
- Polly (>= 8.6.4)
- Microsoft.Orleans.Core (>= 10.3.1)
| Version | Downloads | Last updated |
|---|---|---|
| 10.3.1 | 1 | 09/21/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 | 0 | 07/12/2024 |
| 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 | 0 | 02/23/2024 |
| 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 |