Akka.Cluster.Sharding 1.5.0-alpha3

Prefix Reserved

This is a prerelease version of Akka.Cluster.Sharding.

There is a newer version of this package available.
See the version list below for details.

dotnet add package Akka.Cluster.Sharding --version 1.5.0-alpha3

NuGet\Install-Package Akka.Cluster.Sharding -Version 1.5.0-alpha3

This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.

<PackageReference Include="Akka.Cluster.Sharding" Version="1.5.0-alpha3" />

For projects that support PackageReference, copy this XML node into the project file to reference the package.

<PackageVersion Include="Akka.Cluster.Sharding" Version="1.5.0-alpha3" />
                    

                            Directory.Packages.props

<PackageReference Include="Akka.Cluster.Sharding" />
                    

                            Project file

For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.

paket add Akka.Cluster.Sharding --version 1.5.0-alpha3

The NuGet Team does not provide support for this client. Please contact its maintainers for support.

#r "nuget: Akka.Cluster.Sharding, 1.5.0-alpha3"

#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.

#addin nuget:?package=Akka.Cluster.Sharding&version=1.5.0-alpha3&prerelease
                    

                            Install Akka.Cluster.Sharding as a Cake Addin

#tool nuget:?package=Akka.Cluster.Sharding&version=1.5.0-alpha3&prerelease
                    

                            Install Akka.Cluster.Sharding as a Cake Tool

The NuGet Team does not provide support for this client. Please contact its maintainers for support.

Akka.NET

Akka.NET logo

Akka.NET is a .NET port of the popular Akka project from the Scala / Java community. We are an idiomatic .NET implementation of the actor model built on top of the .NET Common Language Runtime.

Website: https://getakka.net/
Twitter 🐦: AkkaDotNet
Discussions 📣: Akka.NET GitHub Discussions
Chat 💬: Akka.NET on Discord
StackOverflow ✔️: Akka.NET on StackOverflow

Akka.NET is a .NET Foundation project.

.NET Foundation Logo

How is Akka.NET Used?

Akka.NET can be used in-process or inside large, distributed real-time systems; we support a wide variety of use cases.

Akka.NET can be used to solve the following types of problems:

Concurrency - Akka.NET actors only process messages one-at-a-time and they do so in first in, first out (FIFO) order; this means that any application state internal to an actor is automatically thread-safe without having to use locks or any other shared-memory synchronization mechanisms.
Stream Processing - Akka.NET actors and Akka.Streams make it easy to build streaming applications, used for processing incoming streams of data or incoming streams of live events such as UI or network events inside native applications.
Event-Driven Programming - actors make it easy to build event-driven applications, as actors' message-processing routines naturally express these types of designs.
Event Sourcing and CQRS - Akka.Persistence, used by actors to make their state re-entrant and recoverable across restarts or migrations between nodes, natively supports event sourcing. Akka.Persistence.Query can be used to compute CQRS-style projections and materialized views from Akka.Persistence data.
Location Transparency - Akka.Remote makes it simple for actors in remote processes to transparently communicate with each other.
Highly Available, Fault-Tolerant Distributed Systems - Akka.Cluster, Akka.Cluster.Sharding, and other tools built on top of Akka.Cluster make it possible to build highly available and fault-tolerant distributed systems by leveraging peer-to-peer programming models with topology-aware message routing and distribution.
Low Latency, High Throughput - Akka.NET aims to be low latency and high throughput, processing 10s millions of messages per second in-memory and hundreds of thousands of messages per second over remote connections.

Where Can I Learn Akka.NET?

You can start by taking the Akka.NET Bootcamp, but there are many other great learning resources for Akka.NET Online.

Build Status

Stage	Status
Build
NuGet Pack
.NET Framework Unit Tests
.NET Framework MultiNode Tests
.NET Core (Windows) Unit Tests
.NET Core (Linux) Unit Tests
.NET Core (Windows) MultiNode Tests
.NET Core (Linux) MultiNode Tests
Docs

Install Akka.NET via NuGet

If you want to include Akka.NET in your project, you can install it directly from NuGet

To install Akka.NET Distributed Actor Framework, run the following command in the Package Manager Console

PM> Install-Package Akka
PM> Install-Package Akka.Remote

And if you need F# support:

PM> Install-Package Akka.FSharp

Builds

Please see Building Akka.NET.

To access nightly Akka.NET builds, please see the instructions here.

Support

If you need help getting started with Akka.NET, there's a number of great community resources online:

Subscribe to the Akka.NET project feed on Twitter: https://twitter.com/AkkaDotNet (@AkkaDotNet)
Join the Akka.NET project Gitter chat: https://gitter.im/akkadotnet/akka.net
Ask Akka.NET questions on Stack Overflow: http://stackoverflow.com/questions/tagged/akka.net

If you and your company are interested in getting professional Akka.NET support, you can contact Petabridge for dedicated Akka.NET support.

Product	Compatible and additional computed target framework versions.
.NET	net5.0 was computed. net5.0-windows was computed. net6.0 is compatible. net6.0-android was computed. net6.0-ios was computed. net6.0-maccatalyst was computed. net6.0-macos was computed. net6.0-tvos was computed. net6.0-windows was computed. net7.0 was computed. net7.0-android was computed. net7.0-ios was computed. net7.0-maccatalyst was computed. net7.0-macos was computed. net7.0-tvos was computed. net7.0-windows was computed. net8.0 was computed. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. net9.0 was computed. net9.0-android was computed. net9.0-browser was computed. net9.0-ios was computed. net9.0-maccatalyst was computed. net9.0-macos was computed. net9.0-tvos was computed. net9.0-windows was computed. net10.0 was computed. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed.
.NET Core	netcoreapp2.0 was computed. netcoreapp2.1 was computed. netcoreapp2.2 was computed. netcoreapp3.0 was computed. netcoreapp3.1 was computed.
.NET Standard	netstandard2.0 is compatible. netstandard2.1 was computed.
.NET Framework	net461 was computed. net462 was computed. net463 was computed. net47 was computed. net471 was computed. net472 was computed. net48 was computed. net481 was computed.
MonoAndroid	monoandroid was computed.
MonoMac	monomac was computed.
MonoTouch	monotouch was computed.
Tizen	tizen40 was computed. tizen60 was computed.
Xamarin.iOS	xamarinios was computed.
Xamarin.Mac	xamarinmac was computed.
Xamarin.TVOS	xamarintvos was computed.
Xamarin.WatchOS	xamarinwatchos was computed.

Compatible target framework(s)

Included target framework(s) (in package)

Learn more about Target Frameworks and .NET Standard.

.NETStandard 2.0
- Akka.Cluster.Tools (>= 1.5.0-alpha3)
- Akka.Coordination (>= 1.5.0-alpha3)
- Akka.DistributedData (>= 1.5.0-alpha3)
- Akka.DistributedData.LightningDB (>= 1.5.0-alpha3)
- Akka.Persistence (>= 1.5.0-alpha3)
net6.0
- Akka.Cluster.Tools (>= 1.5.0-alpha3)
- Akka.Coordination (>= 1.5.0-alpha3)
- Akka.DistributedData (>= 1.5.0-alpha3)
- Akka.DistributedData.LightningDB (>= 1.5.0-alpha3)
- Akka.Persistence (>= 1.5.0-alpha3)

NuGet packages (18)

Showing the top 5 NuGet packages that depend on Akka.Cluster.Sharding:

Package	Downloads
Akka.Cluster.Hosting Akka.Cluster and Akka.Cluster.Sharding Microsoft.Extensions.Hosting support.	713.2K
Petabridge.Cmd.Cluster.Sharding Akka.Cluster.Sharding Petabridge.Cmd palettes for shard management and monitoring.	348.0K
wyvern.entity Package Description	169.5K
Akkling.Cluster.Sharding F# wrapper library for Akka.NET cluster sharding module.	42.8K
Akkatecture.Clustering clustering library for akkatecture to enable distributed scenarios	32.6K

GitHub repositories (4)

Showing the top 4 popular GitHub repositories that depend on Akka.Cluster.Sharding:

Repository	Stars
petabridge/akkadotnet-code-samples Akka.NET professional reference code samples	558
ThembisileNGQ/Akkatecture a cqrs and event sourcing framework for dotnet core using akka.net	526
Aaronontheweb/InMemoryCQRSReplication Akka.NET Reference Architecture - CQRS + Sharding + In-Memory Replication	143
Horusiath/AkkaCQRS Event sourcing example build on Akka.NET with persistence plugin	103

Version	Downloads	Last updated
1.5.41	695	5/6/2025
1.5.40	20,395	3/24/2025
1.5.39	4,268	3/14/2025
1.5.38	37,911	2/17/2025
1.5.37	21,403	1/23/2025
1.5.36	2,112	1/22/2025
1.5.35	6,249	1/13/2025
1.5.34	2,432	1/7/2025
1.5.33	24,561	12/23/2024
1.5.32	12,084	12/4/2024
1.5.31	14,372	11/11/2024
1.5.30	34,662	10/3/2024
1.5.29	1,971	10/1/2024
1.5.28	51,646	9/4/2024
1.5.28-beta1	139	8/23/2024
1.5.27.1	96,919	7/26/2024
1.5.27	850	7/25/2024
1.5.27-beta2	121	7/3/2024
1.5.27-beta1	96	7/3/2024
1.5.26	71,140	6/27/2024
1.5.25	89,561	6/14/2024
1.5.24	6,016	6/7/2024
1.5.23	1,060	6/6/2024
1.5.22	2,185	6/3/2024
1.5.21	3,946	5/28/2024
1.5.20	28,120	4/29/2024
1.5.19	14,730	4/15/2024
1.5.18	39,890	3/12/2024
1.5.17.1	9,114	3/2/2024
1.5.17	1,168	2/29/2024
1.5.16	22,973	1/29/2024
1.5.15	32,438	1/10/2024
1.5.14	29,804	11/3/2023
1.5.13	76,241	9/18/2023
1.5.13-beta1	449	8/25/2023
1.5.12	22,243	8/2/2023
1.5.11	3,472	7/27/2023
1.5.10	8,375	7/25/2023
1.5.9	8,793	7/17/2023
1.5.8	36,320	6/15/2023
1.5.7	23,679	5/17/2023
1.5.6	10,518	5/8/2023
1.5.5	37,579	5/4/2023
1.5.4	13,148	4/25/2023
1.5.3	3,179	4/20/2023
1.5.2	18,808	4/6/2023
1.5.1	8,974	3/15/2023
1.5.0	12,207	3/2/2023
1.5.0-beta6	1,016	3/1/2023
1.5.0-beta5	569	3/1/2023
1.5.0-beta4	661	2/28/2023
1.5.0-beta3	742	2/27/2023
1.5.0-beta2	591	2/23/2023
1.5.0-beta1	622	2/20/2023
1.5.0-alpha4	971	2/1/2023
1.5.0-alpha3	816	11/15/2022
1.5.0-alpha2	697	10/17/2022
1.5.0-alpha1	702	8/22/2022
1.4.51	10,839	6/28/2023
1.4.50	4,804	3/15/2023
1.4.49	16,053	1/27/2023
1.4.49-beta1	627	1/11/2023
1.4.48	29,104	1/5/2023
1.4.47	10,405	12/9/2022
1.4.46	26,422	11/15/2022
1.4.45	23,586	10/19/2022
1.4.44	2,985	10/17/2022
1.4.43	11,702	9/27/2022
1.4.42	2,646	9/23/2022
1.4.41	135,400	8/31/2022
1.4.40	14,057	7/22/2022
1.4.39	86,738	6/1/2022
1.4.38	43,179	5/6/2022
1.4.37	11,379	4/14/2022
1.4.36	10,084	4/5/2022
1.4.35	22,307	3/18/2022
1.4.34	7,915	3/7/2022
1.4.33	8,335	2/14/2022
1.4.32	13,732	1/18/2022
1.4.31	29,564	12/21/2021
1.4.30	2,029	12/20/2021
1.4.29	2,433	12/13/2021
1.4.28	51,113	11/10/2021
1.4.27	45,916	10/11/2021
1.4.26	5,051	9/28/2021
1.4.25	6,064	9/8/2021
1.4.24	8,899	8/17/2021
1.4.23	3,917	8/10/2021
1.4.22	6,293	8/5/2021
1.4.21	19,729	6/16/2021
1.4.21-beta1	912	6/4/2021
1.4.20	14,807	5/12/2021
1.4.19	14,633	4/28/2021
1.4.18	11,105	3/23/2021
1.4.17	6,499	3/10/2021
1.4.16	29,549	1/22/2021
1.4.15	2,773	1/20/2021
1.4.14	10,688	12/30/2020
1.4.13	3,500	12/16/2020
1.4.12	19,325	11/16/2020
1.4.11	12,777	11/5/2020
1.4.10	19,111	8/20/2020
1.4.9	15,446	7/21/2020
1.4.8	48,379	6/17/2020
1.4.7	6,015	5/27/2020
1.4.6	7,033	5/12/2020
1.4.5	4,693	4/29/2020
1.4.4	9,365	3/31/2020
1.4.3	5,352	3/18/2020
1.4.2	4,608	3/13/2020
1.4.1	9,506	3/11/2020
1.4.1-rc3	1,052	3/10/2020
1.4.1-rc2	870	3/10/2020
1.4.1-rc1	1,290	2/28/2020
1.4.0-beta4	2,493	1/28/2020
1.4.0-beta3	7,061	10/30/2019
1.4.0-beta2	3,848	9/23/2019
1.4.0-beta1	2,638	7/19/2019
1.4.0-beta	1,094	10/30/2019
1.3.19-beta	80	5/2/2024
1.3.18-beta	10,694	3/9/2020
1.3.17-beta	6,803	12/20/2019
1.3.16-beta	2,976	11/14/2019
1.3.15-beta	4,625	9/23/2019
1.3.14-beta	7,348	7/30/2019
1.3.13-beta	19,476	4/30/2019
1.3.12-beta	12,812	3/14/2019
1.3.11-beta	10,638	12/18/2018
1.3.10-beta	83,609	11/2/2018
1.3.9-beta68	41,071	8/23/2018
1.3.9-beta67	1,273	8/23/2018
1.3.9-beta	1,209	8/30/2018
1.3.8-beta66	8,963	6/5/2018
1.3.8-beta65	1,501	6/5/2018
1.3.7-beta64	2,109	5/15/2018
1.3.7-beta63	1,582	5/15/2018
1.3.6-beta62	3,558	4/17/2018
1.3.6-beta61	1,415	4/17/2018
1.3.5-beta60	8,939	2/22/2018
1.3.5-beta59	1,450	2/22/2018
1.3.4-beta58	1,737	2/1/2018
1.3.4-beta57	1,557	2/1/2018
1.3.3-beta56	1,622	1/19/2018
1.3.3-beta55	1,588	1/19/2018
1.3.2-beta54	20,512	10/21/2017
1.3.2-beta53	1,464	10/21/2017
1.3.2-beta	2,314	10/24/2017
1.3.1-beta52	2,292	9/5/2017
1.3.1-beta51	1,435	9/5/2017
1.3.0-beta50	1,518	8/18/2017
1.3.0-beta48	1,406	8/17/2017
1.3.0-beta47	1,468	8/17/2017
1.3.0-beta46	1,459	8/11/2017
1.2.3.43-beta	3,028	7/10/2017
1.2.3.41-beta	1,463	7/10/2017
1.2.2.40-beta	1,513	6/28/2017
1.2.2.39-beta	1,424	6/28/2017
1.2.1.38-beta	1,463	6/23/2017
1.2.1.37-beta	1,501	6/23/2017
1.2.0.36-beta	10,940	4/13/2017
1.2.0.35-beta	1,685	4/13/2017
1.2.0.34-beta	1,408	4/12/2017
1.2.0.33-beta	2,052	4/12/2017
1.1.3.32-beta	2,760	1/23/2017
1.1.3.31-beta	1,655	1/23/2017
1.1.2.30-beta	3,161	9/22/2016
1.1.2.29-beta	1,798	9/22/2016
1.1.1.28-beta	1,578	7/16/2016
1.1.1.27-beta	1,534	7/16/2016
1.1.0.26-beta	1,587	7/7/2016
1.0.8.25-beta	3,287	4/26/2016
1.0.8.24-beta	1,559	4/26/2016
1.0.7.18-beta	1,575	4/6/2016

Akka.NET v1.5.0-alpha3 is a security patch for Akka.NET v1.5.0-alpha2 but also includes some other fixes.
Security Advisory**: Akka.NET v1.5.0-alpha2 and earlier depend on an old System.Configuration.ConfigurationManager version 4.7.0 which transitively depends on System.Common.Drawing v4.7.0. The System.Common.Drawing v4.7.0 is affected by a remote code execution vulnerability [GHSA-ghhp-997w-qr28](https://github.com/advisories/GHSA-ghhp-997w-qr28).
We have separately created a security advisory for [Akka.NET Versions < 1.4.46 and < 1.5.0-alpha3 to track this issue](https://github.com/akkadotnet/akka.net/security/advisories/GHSA-gpv5-rp6w-58r8).
Fixes and Updates**
[Akka: Revert ConfigurationException due to binary incompatibility](https://github.com/akkadotnet/akka.net/pull/6204)
[Akka: Upgrade to Newtonsoft.Json 13.0.1 as minimum version](https://github.com/akkadotnet/akka.net/pull/6230) - resolves security issue.
[Akka: Upgrade to System.Configuration.ConfigurationManager 6.0.1](https://github.com/akkadotnet/akka.net/pull/6229) - resolves security issue.
[Akka: Upgrade to Google.Protobuf 3.21.9](https://github.com/akkadotnet/akka.net/pull/6217)
[Akka.Cluster.Tools: Make sure that `DeadLetter`s published by `DistributedPubSubMediator` contain full context of topic](https://github.com/akkadotnet/akka.net/pull/6212)
[Akka.Streams: Remove suspicious code fragment in ActorMaterializer](https://github.com/akkadotnet/akka.net/pull/6216)
[Akka.IO: Report cause for Akka/IO TCP `CommandFailed` events](https://github.com/akkadotnet/akka.net/pull/6221)
[Akka.Cluster.Metrics: Improve CPU/Memory metrics collection at Akka.Cluster.Metrics](https://github.com/akkadotnet/akka.net/pull/6225) - built-in metrics are now much more accurate.
You can see the [full set of tracked issues for Akka.NET v1.5.0 here](https://github.com/akkadotnet/akka.net/milestone/7).