Akka.Persistence 1.5.42

Prefix Reserved
dotnet add package Akka.Persistence --version 1.5.42
                    
NuGet\Install-Package Akka.Persistence -Version 1.5.42
                    
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.Persistence" Version="1.5.42" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="Akka.Persistence" Version="1.5.42" />
                    
Directory.Packages.props
<PackageReference Include="Akka.Persistence" />
                    
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.Persistence --version 1.5.42
                    
#r "nuget: Akka.Persistence, 1.5.42"
                    
#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.Persistence&version=1.5.42
                    
Install Akka.Persistence as a Cake Addin
#tool nuget:?package=Akka.Persistence&version=1.5.42
                    
Install Akka.Persistence as a Cake Tool

Akka.NET

Akka.NET logo

Discord NuGet Nuget

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.

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:

  1. 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.
  2. 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.
  3. Event-Driven Programming - actors make it easy to build event-driven applications, as actors' message-processing routines naturally express these types of designs.
  4. 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.
  5. Location Transparency - Akka.Remote makes it simple for actors in remote processes to transparently communicate with each other.
  6. 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.
  7. 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
NuGet Pack Build Status
.NET Framework Unit Tests Build Status
.NET Unit Tests (Windows) Build Status
.NET Unit Tests (Linux) Build Status
.NET MultiNode Tests (Windows) Build Status
.NET MultiNode Tests (Linux) Build Status
Docs Build Status

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.Hosting

Akka.Hosting includes the base Akka NuGet package and also provides an easy interface to integrate Akka.NET with the most-used parts of the Microsoft.Extensions ecosystem: Configuration, Logging, Hosting, and DependencyInjection. We encourage developers to adopt it.

And if you need F# support:

PM> Install-Package Akka.FSharp

Akka.NET Project Templates

To create your own Akka.NET projects using our templates (Akka.Templates), install them via the dotnet CLI:

dotnet new install "Akka.Templates::*"

This will make our templates available via dotnet new on the CLI and as new project templates inside any .NET IDE such as Visual Studio or JetBrains Rider. You can view the full list of templates included in our package here: https://github.com/akkadotnet/akkadotnet-templates#available-templates

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:

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.

NuGet packages (47)

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

Package Downloads
Akka.Cluster.Sharding

Sharded actors with managed lifecycle for Akka.NET cluster. Used to distribute state in a fault-tolerant, consistent fashion over an Akka.NET cluster.

Akka.Persistence.Sql.Common

Akka.NET Persistence ADO.NET middleware

Akka.Persistence.Query

Stream based query interface for persistence journal plugins for Akka.NET

Akka.Persistence.Hosting

Akka.Persistence Microsoft.Extensions.Hosting support.

Akka.Persistence.Query.Sql

Akka.NET streams support for ADO.NET Persistence middleware.

GitHub repositories (4)

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

Repository Stars
ThembisileNGQ/Akkatecture
a cqrs and event sourcing framework for dotnet core using akka.net
axzxs2001/Asp.NetCoreExperiment
原来所有项目都移动到**OleVersion**目录下进行保留。新的案例装以.net 5.0为主,一部分对以前案例进行升级,一部分将以前的工作经验总结出来,以供大家参考!
Aaronontheweb/InMemoryCQRSReplication
Akka.NET Reference Architecture - CQRS + Sharding + In-Memory Replication
Horusiath/AkkaCQRS
Event sourcing example build on Akka.NET with persistence plugin
Version Downloads Last updated
1.5.42 804 5/21/2025
1.5.41 3,472 5/6/2025
1.5.40 31,315 3/24/2025
1.5.39 8,091 3/14/2025
1.5.38 51,905 2/17/2025
1.5.37 49,508 1/23/2025
1.5.36 2,954 1/22/2025
1.5.35 10,846 1/13/2025
1.5.34 3,756 1/7/2025
1.5.33 23,080 12/23/2024
1.5.32 23,187 12/4/2024
1.5.31 30,677 11/11/2024
1.5.30 73,624 10/3/2024
1.5.29 16,695 10/1/2024
1.5.28 65,036 9/4/2024
1.5.28-beta1 606 8/23/2024
1.5.27.1 110,378 7/26/2024
1.5.27 1,229 7/25/2024
1.5.27-beta2 430 7/3/2024
1.5.27-beta1 388 7/3/2024
1.5.26 155,678 6/27/2024
1.5.25 113,948 6/14/2024
1.5.24 13,820 6/7/2024
1.5.23 1,574 6/6/2024
1.5.22 3,378 6/3/2024
1.5.21 6,713 5/28/2024
1.5.20 56,165 4/29/2024
1.5.19 20,513 4/15/2024
1.5.18 54,127 3/12/2024
1.5.17.1 15,046 3/2/2024
1.5.17 1,882 2/29/2024
1.5.16 44,116 1/29/2024
1.5.15 60,874 1/10/2024
1.5.14 47,065 11/3/2023
1.5.13 130,118 9/18/2023
1.5.13-beta1 1,258 8/25/2023
1.5.12 101,541 8/2/2023
1.5.11 4,586 7/27/2023
1.5.10 10,497 7/25/2023
1.5.9 15,836 7/17/2023
1.5.8 56,179 6/15/2023
1.5.7 43,960 5/17/2023
1.5.6 14,260 5/8/2023
1.5.5 36,878 5/4/2023
1.5.4 50,002 4/25/2023
1.5.3 5,266 4/20/2023
1.5.2 56,314 4/6/2023
1.5.1 39,036 3/15/2023
1.5.0 47,827 3/2/2023
1.5.0-beta6 1,884 3/1/2023
1.5.0-beta5 1,294 3/1/2023
1.5.0-beta4 1,424 2/28/2023
1.5.0-beta3 2,100 2/27/2023
1.5.0-beta2 2,240 2/23/2023
1.5.0-beta1 1,382 2/20/2023
1.5.0-alpha4 1,797 2/1/2023
1.5.0-alpha3 1,696 11/15/2022
1.5.0-alpha2 1,374 10/17/2022
1.5.0-alpha1 8,334 8/22/2022
1.4.51 30,411 6/28/2023
1.4.50 6,924 3/15/2023
1.4.49 37,502 1/27/2023
1.4.49-beta1 1,414 1/11/2023
1.4.48 58,423 1/5/2023
1.4.47 15,848 12/9/2022
1.4.46 48,353 11/15/2022
1.4.45 41,449 10/19/2022
1.4.44 10,364 10/17/2022
1.4.43 48,818 9/27/2022
1.4.42 9,422 9/23/2022
1.4.41 174,405 8/31/2022
1.4.40 61,229 7/22/2022
1.4.39 105,075 6/1/2022
1.4.38 46,529 5/6/2022
1.4.37 19,817 4/14/2022
1.4.36 28,189 4/5/2022
1.4.35 98,685 3/18/2022
1.4.34 17,486 3/7/2022
1.4.33 23,753 2/14/2022
1.4.32 44,763 1/18/2022
1.4.31 80,422 12/21/2021
1.4.30 4,229 12/20/2021
1.4.29 5,543 12/13/2021
1.4.28 71,409 11/10/2021
1.4.27 65,559 10/11/2021
1.4.26 8,845 9/28/2021
1.4.25 53,418 9/8/2021
1.4.24 15,086 8/17/2021
1.4.23 7,032 8/10/2021
1.4.22 9,317 8/5/2021
1.4.21 39,408 6/16/2021
1.4.21-beta1 2,280 6/4/2021
1.4.20 38,535 5/12/2021
1.4.19 27,859 4/28/2021
1.4.18 32,842 3/23/2021
1.4.17 13,942 3/10/2021
1.4.16 50,436 1/22/2021
1.4.15 7,196 1/20/2021
1.4.14 25,005 12/30/2020
1.4.13 7,243 12/16/2020
1.4.12 70,292 11/16/2020
1.4.11 23,595 11/5/2020
1.4.10 53,038 8/20/2020
1.4.9 27,087 7/21/2020
1.4.8 63,607 6/17/2020
1.4.7 17,018 5/27/2020
1.4.6 13,033 5/12/2020
1.4.5 19,399 4/29/2020
1.4.4 51,767 3/31/2020
1.4.3 14,391 3/18/2020
1.4.2 13,796 3/13/2020
1.4.1 53,797 3/11/2020
1.4.1-rc3 3,891 3/10/2020
1.4.1-rc2 2,608 3/10/2020
1.4.1-rc1 4,425 2/28/2020
1.4.0-beta4 3,846 1/28/2020
1.4.0-beta3 9,006 10/30/2019
1.4.0-beta2 5,329 9/23/2019
1.4.0-beta1 3,971 7/19/2019
1.3.19 430 5/2/2024
1.3.18 26,066 3/9/2020
1.3.17 57,161 12/20/2019
1.3.16 16,205 11/14/2019
1.3.15 87,775 9/23/2019
1.3.14 44,299 7/30/2019
1.3.13 55,551 4/30/2019
1.3.12 37,022 3/14/2019
1.3.11 38,854 12/18/2018
1.3.10 93,853 11/2/2018
1.3.9 88,055 8/23/2018
1.3.8 27,595 6/5/2018
1.3.7 19,016 5/15/2018
1.3.6 9,254 4/17/2018
1.3.5 24,717 2/22/2018
1.3.4 7,656 2/1/2018
1.3.3 7,328 1/19/2018
1.3.2 40,623 10/21/2017
1.3.1 26,964 9/5/2017
1.3.0 14,497 8/11/2017
1.2.3.43-beta 6,637 7/10/2017
1.2.3.41-beta 2,989 7/10/2017
1.2.2.40-beta 6,111 6/28/2017
1.2.2.39-beta 2,877 6/28/2017
1.2.1.38-beta 5,846 6/23/2017
1.2.1.37-beta 2,950 6/23/2017
1.2.0.36-beta 16,503 4/13/2017
1.2.0.35-beta 2,886 4/13/2017
1.2.0.34-beta 2,819 4/12/2017
1.2.0.33-beta 2,999 4/12/2017
1.1.3.32-beta 15,514 1/23/2017
1.1.3.31-beta 3,095 1/23/2017
1.1.2.30-beta 20,958 9/22/2016
1.1.2.29-beta 3,167 9/22/2016
1.1.1.28-beta 8,278 7/16/2016
1.1.1.27-beta 2,898 7/16/2016
1.1.0.26-beta 3,319 7/7/2016
1.0.8.25-beta 4,292 4/26/2016
1.0.8.24-beta 2,210 4/26/2016
1.0.7.18-beta 2,661 4/6/2016
1.0.6.17-beta 10,220 1/18/2016
1.0.6.16-beta 1,751 1/18/2016
1.0.5.15-beta 11,399 12/3/2015
1.0.5.14-beta 1,979 12/3/2015
1.0.4.12-beta 3,408 8/8/2015
1.0.3-beta 2,218 6/12/2015
1.0.2.9-beta 2,088 6/3/2015
1.0.1-pre1504282013 2,169 4/28/2015
1.0.0-pre1504092226 1,642 4/9/2015
1.0.0-dev1504032244 1,543 4/3/2015
0.8.0-pre1502120115 3,049 2/12/2015

Akka.NET v1.5.42 contains several bug fixes and also adds new quality of life features to `Akka.IO.Tcp`, `Akka.Persistence`, `Akka.Pattern`, and `Akka.Cluster.Tools.DistributedPubSub`.

* [IO.Tcp: Cleanup API](https://github.com/akkadotnet/akka.net/pull/7621)
* [IO.Tcp: Fix `TcpListener` connection queue problem](https://github.com/akkadotnet/akka.net/pull/7621)
* [Persistence: Allow user to use supervision strategy on journal and snapshot store](https://github.com/akkadotnet/akka.net/pull/7595)
* [Core: Add cancellation token to `CircuitBreaker` API to signal timed out operations](https://github.com/akkadotnet/akka.net/pull/7624)
* [Persistence: Change all `CircuitBreaker` protected method API to use cancellation token](https://github.com/akkadotnet/akka.net/pull/7624)
* [Core: Leverage Exception...when pattern](https://github.com/akkadotnet/akka.net/pull/7614)
* [IO.Tcp: Add `TcpListenerStatistics` and subscription methods](https://github.com/akkadotnet/akka.net/pull/7633)
* [Cluster.Tools: Modernize `DistributedPubSub` code](https://github.com/akkadotnet/akka.net/pull/7640)
* [Cluster.Tools: Optimize `DistributedPubSub` memory allocation](https://github.com/akkadotnet/akka.net/pull/7642)
* [Cluster.Tools: Improve `DistributedPubSub` `DeadLetter` log message](https://github.com/akkadotnet/akka.net/pull/7646)
* [Core: Refactor immutable collection builders to use simpler `CreateBuilder` pattern](https://github.com/akkadotnet/akka.net/pull/7656)
* [IO.Tcp: Redesign `TcpConnection`](https://github.com/akkadotnet/akka.net/pull/7637)
* [Cluster.Tools: Add `PublishWithAck` feature to `DistributedPubSub`](https://github.com/akkadotnet/akka.net/pull/7652)

> [!WARNING]
>
> This release contains several public API breaking changes to Akka.IO.Tcp and Akka.Persistence

**Akka.Pattern.CircuitBreaker**

Backward compatible API changes:
* New `.WithCircuitBreaker()` APIs were added that changes the protected function delegate to accept a new `CancellationToken` argument.
* Old `.WithCircuitBreaker()` APIs were marked as obsolete.

**Akka.Cluster.Tools.DistributedPubSub**

The documentation for the new `PublishWithAck` feature can be read [here](https://getakka.net/articles/clustering/distributed-publish-subscribe.html#publishwithack)

Backward compatible API changes:
* There is a new `DistributedPubSubSettings` constructor that leverages the new `PublishWithAck` feature. The old constructor is marked as obsolete.

**Akka.Persistence**

The documentation for the new supervision strategy for journal and snapshot-store feature can be read [here](https://getakka.net/articles/persistence/storage-plugins.html#controlling-journal-or-snapshot-crash-behavior)

Breaking API changes:

Due to changes in `CircuitBreaker.WithCircuitBreaker()` APIs, several `Akka.Persistence` journal and snapshot-store were changed in a breaking manner. You will need to consider these changes if you have your own specific `Akka.Persistence` plugin implementation and needed to upgrade to this version of Akka.

* AsyncWriteJournal
  * `DeleteMessagesToAsync()`
  * `ReadHighestSequenceNrAsync()`
  * `WriteMessagesAsync`
* SnapshotStore
  * Both `DeleteAsync()` methods
  * `LoadAsync()`
  * `SaveAsync()`

**Akka.IO.Tcp**

The Akka.IO.Tcp has been redesigned to improve its reliability, visibility, and performance. This, unfortunately, requires some breaking changes to be introduced into the code base.

New features:
* The `TcpListener` actor now accepts a new `SubscribeToTcpListenerStats` message. Subscribers will receive regular `TcpListenerStatistics` metrics report from the `TcpListener`.
* The new `UnsubscribeFromTcpListenerStats` message can be used to unsubscribe from the `TcpListener`

Backward compatible changes:
* The `Akka.IO.Tcp.Bind` command now contain a new settable `TcpSettings` property.
* The `Akka.IO.Tcp.Connect` command now contain a new settable `TcpSettings` property.
* The `Akka.IO.TcpSettings` class have several of its unused properties deprecated and/or changed:
  * The `ReceivedMessageSizeLimit` property has been deprecated, replaced with the new `MaxFrameSizeBytes` property.
  * New `ReceiveBufferSize` property added.
  * New `SendBufferSize` property added.

Breaking API changes:
* `Akka.IO.Tcp.Instance` static field has been removed.
* `Akka.IO.TcpExt.BufferPool` static property has been removed.

To [see the full set of changes in Akka.NET v1.5.42, click here](https://github.com/akkadotnet/akka.net/milestone/125?closed=1).

5 contributors since release 1.5.41

| COMMITS | LOC+ | LOC- | AUTHOR              |
|---------|------|------|---------------------|
| 15      | 3480 | 2864 | Aaron Stannard      |
| 5       | 1711 | 713  | Gregorius Soedharmo |
| 4       | 72   | 100  | Simon Cropp         |
| 1       | 172  | 51   | Arjen Smits         |
| 1       | 16   | 60   | JuYoung Kim         |