name: olore-dotnet-orleans-latest description: Local .NET Orleans documentation reference (latest). Use for virtual actor model, grains, silos, distributed systems, cluster management, persistence, streams, and timers in .NET.
.NET Orleans Documentation
Microsoft Orleans documentation. Use for virtual actor model, grains, silos, distributed systems, cluster management, persistence, streams, and timers in .NET.
Quick Reference
| Task | Entry Point |
|---|---|
| New to Orleans | contents/overview.md |
| First app | contents/quickstarts/build-your-first-orleans-app.md |
| Grain fundamentals | contents/grains/index.md |
| Silo/client configuration | contents/host/configuration-guide/index.md |
| Grain persistence | contents/grains/grain-persistence/index.md |
| Streaming | contents/streaming/index.md |
| Deployment | contents/deployment/index.md |
| Testing | contents/implementation/testing.md |
| NuGet packages | contents/resources/nuget-packages.md |
| Version migration | contents/migration-guide.md |
When to use
Use this skill when the user asks about:
- Grains: defining, registering, calling, lifecycle, identity, placement, versioning
- Grain persistence and storage providers (Azure, Cosmos DB, DynamoDB, ADO.NET)
- Grain event sourcing with JournaledGrain
- Timers, reminders, and grain cancellation
- Transactions, interceptors, observers, and request context
- Silos: configuration, hosting, lifecycle, heterogeneous deployments
- Client configuration and connecting to Orleans clusters
- Serialization configuration and customization
- Orleans streaming APIs, stream providers, and broadcast channels
- Deployment to Azure (App Service, Container Apps), Kubernetes, Service Fabric
- Cluster management, load balancing, and grain directory internals
- Unit testing Orleans applications
- Migrating between Orleans major versions (7.0 → 10.0)
- .NET Aspire integration with Orleans
How to find information
- First, read
TOC.mdfor complete file listing organized by directory - Identify relevant section based on user's question
- Read specific files for details
TOC.md contains all files organized by directory - always check it first.