Akka 1.5.75

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.

No packages depend on Akka.

Akka.NET v1.5.75 adds restart-free TLS certificate rotation for the DotNetty transport, fixes two certificate-validation gaps that silently disabled security checks, backports two Akka.Persistence ordering fixes, and brings Akka.Reminders to the 1.5 line as Akka.Reminders.* packages.

Upgrading from Aaron.Akka.Reminders? The package IDs are now Akka.Reminders, Akka.Reminders.Sql, Akka.Reminders.SqlServer, Akka.Reminders.PostgreSql and Akka.Reminders.Sqlite, and the module shares the Akka.NET version number. Change your package references; stored data is read-compatible, proven by a golden-database spec against data written by the released Aaron.Akka.Reminders 1.5.73 packages.

Two behavior changes to check before upgrading. CertificateValidation.ValidateHostname(expectedHostname) and SslOptions.CustomValidator now actually enforce what they were configured to enforce. Both were silently no-ops in earlier versions, so a peer that used to connect may now fail the TLS handshake. See the Akka.Remote / TLS section below.

Akka.Remote / TLS

  • Rotate DotNetty TLS certificates without a restart - A node can now pick up a renewed TLS certificate with no restart. Set akka.remote.dot-netty.tcp.ssl.certificate.common-name to find the certificate in a store by name, or point ssl.certificate.path at a folder of PKCS#12/PEM files, and place the renewed certificate beside the old one. New connections use it within about 10 seconds; open connections keep the certificate they started with. In code, use DotNettySslSetup.FromSource with TlsCertificateSource, or SslOptions.CertificateSource in Akka.Hosting. Existing TLS setups are unchanged. Behavior change: a certificate source checks that the certificate is allowed for the role. With require-mutual-authentication = true (the default) the certificate must allow both client and server authentication. X509Certificate, a single-file Path and a Thumbprint are not checked this way, so a certificate that worked before may be skipped with a warning when moved to a source, and a node with no other usable certificate does not start.
  • Add TlsCertificateSource for TLS certificate rotation - The new Akka.IO.TlsCertificateSource resolves a certificate from a store common name, a thumbprint, a single file, or a folder of files, and re-checks it once a minute. A certificate that cannot be used is judged again at the next look-up, so granting access to a private key later is picked up. The source never disposes a certificate it has published. PEM files need the net6.0 target; the netstandard2.0 build skips them and logs why.
  • Security fix: CertificateValidation.ValidateHostname(expectedHostname) now enforces the expected hostname - In v1.5.74 and earlier this validator logged a warning and did not compare expectedHostname with the certificate, so a node that used it to check inbound client certificates accepted every client certificate. It now rejects any certificate that does not match the name, by the rules of .NET's X509Certificate2.MatchesHostname. Behavior change: a certificate that does not match now fails the TLS handshake, and on the dialing side that shuts the ActorSystem down with exit code 79. Only nodes that opt in are affected: validate-certificate-hostname defaults to false. A certificate whose subject alternative name extension holds a malformed entry is rejected, as in 1.6. ValidateHostname() without an argument is unchanged.
  • Security fix: SslOptions.CustomValidator in Akka.Remote.Hosting now applies when the certificate is set by file path or thumbprint - In earlier versions the validator only ran when SslOptions.X509Certificate was set, and was otherwise ignored without a warning. Behavior change: the validator now runs, so a peer it rejects fails the TLS handshake. A CustomValidator with no certificate in the options now fails at startup with a ConfigurationException, and the certificate loads when WithRemoting runs rather than when the ActorSystem starts.
  • Log an unexpected failure of the once-a-minute TLS certificate check - The check's catch block swallowed any unexpected exception without a trace. The source already logs every failure it expects, so anything reaching this catch is a bug, and it now logs a warning. The node keeps its current certificate, as before.

Akka.Reminders

  • Port Akka.Reminders to v1.5 - Akka.Reminders now ships on the 1.5 line, dual-targeted at netstandard2.0 and net10.0 so it reaches .NET Framework 4.8 through .NET 10. This is a port rather than a backport: the module is new to 1.5, so the whole thing was re-targeted onto the branch. It ships five packages — Akka.Reminders, Akka.Reminders.Sql, Akka.Reminders.SqlServer, Akka.Reminders.PostgreSql and Akka.Reminders.Sqlite — renamed from Aaron.Akka.Reminders* and now sharing the Akka.NET version number. A golden-database spec proves the new packages read data written by the released Aaron.Akka.Reminders 1.5.73 packages. AOT is not supported on Akka.NET 1.5, so the module carries no AOT annotations here. The module ships no reference.conf and no MultiNode specs; serializer registration goes through the Akka.Hosting API, so HOCON-only users have no configuration surface for it.
  • End every older live occurrence when a newer one is sent - A recurring reminder could deliver an older occurrence after a newer one when its interval was well below MaxSlippage and its shard region was missing for a while and then came back. The recipient got the newer occurrence and then the older one, and both acknowledgements succeeded. When the newest occurrence of a series moves to AwaitingAck, every older live occurrence of that series now expires in the same storage commit. Fixes #8965.
  • Cap the older occurrences one send ends at 256 - The fix above expires ceil(earliness / interval) older occurrences per early send with no upper bound, and Reminders accepts any interval above zero. A 1 ms interval put about 5,000 expiries in one commit, and a sub-millisecond interval could put millions into the scheduler's memory. The cap is 256 per send, nearest first. No interval of about 20 ms or more at the default 5 s MaxSlippage can reach it. Below that, during a shard region outage, an older occurrence more than 256 intervals back can still be sent after a newer one; failure-modes.md documents the limit.

Akka.Persistence

Docs

  • TLS certificate rotation article - New article covering how a node picks its certificate and when a renewed one is used, how to rotate, changing an existing setup, trust by CA and name, loading from Azure Key Vault, rotating with a rolling restart, and troubleshooting. It leads with Akka.Hosting, then HOCON, then code. security.md now says which certificate options can rotate without a restart, and no longer claims that revocation is checked, which the DotNetty transport does not do. A follow-up (#8970) corrected the article's note about CustomValidator, which does apply to thumbprint and single-file certificates since #8963.

Build and tests

  • Skip the simultaneous-disassociate graceful-close spec on .NET Framework - On net48 the tests load Akka.Remote's netstandard2.0 build, where HalfClose falls back to a full close. When both sides disassociate at once, one side can close while the other's frames are still unread and its kernel sends an RST, so the spec failed intermittently. The two sibling "no reset" tests in the class already skip on .NET Framework for the same reason. This changes no product code.
  • Akka.Reminders CI lane - The new module adds a Linux-only net_tests_reminders_linux lane with its own Incrementalist config, because Akka.Reminders.Migration.Tests starts SQL Server and PostgreSQL containers unconditionally and the Windows agents have no Docker. src/contrib/reminders/** is excluded from the Windows test configs.

1 contributor since release 1.5.74

COMMITS LOC+ LOC- AUTHOR
13 40157 552 Aaron Stannard

To see the full set of changes in Akka.NET v1.5.75, click here.

Version Downloads Last updated
1.6.0-beta8 1 11/18/2026
1.6.0-beta7 11 11/10/2026
1.6.0-beta6 13 11/07/2026
1.6.0-beta5 13 11/05/2026
1.6.0-beta4 21 10/28/2026
1.6.0-beta3 26 10/07/2026
1.6.0-beta2 29 10/07/2026
1.6.0-beta1 28 10/02/2026
1.5.75 1 11/17/2026
1.5.74 13 11/05/2026
1.5.73 30 10/06/2026
1.5.72 29 10/04/2026
1.5.71 33 08/28/2026
1.5.70 52 07/04/2026
1.5.70-beta2 33 07/02/2026
1.5.70-beta1 36 06/25/2026
1.5.69 37 06/14/2026
1.5.68 42 05/19/2026
1.5.67 57 04/26/2026
1.5.66 54 04/26/2026
1.5.65 52 04/12/2026
1.5.64 50 04/02/2026
1.5.63 52 03/26/2026
1.5.62 41 03/05/2026
1.5.61 55 03/02/2026
1.5.60 51 02/10/2026
1.5.59 58 01/28/2026
1.5.58 52 01/11/2026
1.5.57 64 12/12/2025
1.5.57-beta2 57 12/11/2025
1.5.57-beta1 58 12/11/2025
1.5.56 59 12/11/2025
1.5.55 57 12/13/2025
1.5.54 61 12/11/2025
1.5.53 52 12/14/2025
1.5.52 52 12/13/2025
1.5.51 56 12/13/2025
1.5.50 9 09/30/2026
1.5.49 48 12/12/2025
1.5.48 53 12/11/2025
1.5.47 53 12/12/2025
1.5.46 9 09/27/2026
1.5.45 10 10/06/2026
1.5.44 14 09/30/2026
1.5.43 51 12/11/2025
1.5.42 62 12/11/2025
1.5.41 58 12/11/2025
1.5.40 65 12/11/2025
1.5.39 56 12/11/2025
1.5.38 14 09/28/2026
1.5.37 62 12/15/2025
1.5.36 51 12/13/2025
1.5.35 12 10/06/2026
1.5.34 55 12/12/2025
1.5.33 43 12/12/2025
1.5.32 20 09/28/2026
1.5.31 67 12/11/2025
1.5.30 7 10/06/2026
1.5.29 65 12/11/2025
1.5.28 9 09/28/2026
1.5.28-beta1 19 10/06/2026
1.5.27.1 10 09/29/2026
1.5.27 46 12/11/2025
1.5.27-beta2 55 12/11/2025
1.5.27-beta1 55 12/11/2025
1.5.26 61 12/11/2025
1.5.25 12 10/06/2026
1.5.24 12 09/29/2026
1.5.23 9 10/06/2026
1.5.22 40 12/12/2025
1.5.21 10 09/28/2026
1.5.20 13 09/28/2026
1.5.19 55 12/11/2025
1.5.18 10 10/05/2026
1.5.17.1 53 12/12/2025
1.5.17 57 12/12/2025
1.5.16 13 10/02/2026
1.5.15 11 09/28/2026
1.5.14 57 12/12/2025
1.5.13 10 09/29/2026
1.5.13-beta1 7 09/30/2026
1.5.12 62 12/11/2025
1.5.11 59 12/11/2025
1.5.10 55 12/10/2025
1.5.9 54 12/11/2025
1.5.8 67 12/12/2025
1.5.7 59 12/11/2025
1.5.6 13 10/06/2026
1.5.5 34 12/13/2025
1.5.4 14 10/02/2026
1.5.3 8 10/06/2026
1.5.2 48 12/11/2025
1.5.1 6 10/08/2026
1.5.0 19 09/27/2026
1.5.0-beta6 60 12/14/2025
1.5.0-beta5 50 12/13/2025
1.5.0-beta4 14 09/28/2026
1.5.0-beta3 8 10/06/2026
1.5.0-beta2 57 12/14/2025
1.5.0-beta1 8 10/06/2026
1.5.0-alpha4 13 10/06/2026
1.5.0-alpha3 56 12/11/2025
1.5.0-alpha2 57 12/12/2025
1.5.0-alpha1 16 09/30/2026
1.4.51 41 12/13/2025
1.4.50 13 10/03/2026
1.4.49 57 12/12/2025
1.4.49-beta1 62 12/11/2025
1.4.48 57 12/11/2025
1.4.47 12 10/01/2026
1.4.46 50 12/12/2025
1.4.45 9 10/06/2026
1.4.44 52 12/11/2025
1.4.43 54 12/11/2025
1.4.42 9 10/06/2026
1.4.41 51 12/13/2025
1.4.40 15 09/27/2026
1.4.39 10 09/28/2026
1.4.38 10 10/06/2026
1.4.37 10 10/06/2026
1.4.36 52 12/15/2025
1.4.35 9 10/02/2026
1.4.34 49 12/13/2025
1.4.33 11 09/30/2026
1.4.32 56 12/12/2025
1.4.31 57 12/11/2025
1.4.30 61 12/12/2025
1.4.29 57 12/11/2025
1.4.28 13 09/28/2026
1.4.27 10 10/03/2026
1.4.26 52 12/13/2025
1.4.25 56 12/12/2025
1.4.24 11 09/30/2026
1.4.23 56 12/11/2025
1.4.22 63 12/11/2025
1.4.21 15 09/29/2026
1.4.21-beta1 57 12/12/2025
1.4.20 52 12/15/2025
1.4.19 66 12/15/2025
1.4.18 15 10/10/2026
1.4.17 16 09/29/2026
1.4.16 62 12/12/2025
1.4.15 56 12/11/2025
1.4.14 16 10/09/2026
1.4.13 12 09/29/2026
1.4.12 9 10/07/2026
1.4.11 55 12/15/2025
1.4.10 59 12/15/2025
1.4.9 15 10/01/2026
1.4.8 49 12/12/2025
1.4.7 73 12/11/2025
1.4.6 63 12/10/2025
1.4.5 9 10/06/2026
1.4.4 61 12/12/2025
1.4.3 9 10/02/2026
1.4.2 42 12/12/2025
1.4.1 14 09/30/2026
1.4.1-rc3 16 09/28/2026
1.4.1-rc2 13 09/29/2026
1.4.1-rc1 57 12/14/2025
1.4.0 55 12/14/2025
1.4.0-beta4 50 12/16/2025
1.4.0-beta3 50 12/13/2025
1.4.0-beta2 12 10/06/2026
1.4.0-beta1 15 10/04/2026
1.3.19 61 12/11/2025
1.3.18 58 12/12/2025
1.3.17 46 12/10/2025
1.3.16 15 09/28/2026
1.3.15 54 12/11/2025
1.3.14 57 12/11/2025
1.3.13 62 12/11/2025
1.3.12 55 12/11/2025
1.3.11 56 12/11/2025
1.3.10 50 12/15/2025
1.3.9 58 12/11/2025
1.3.8 68 12/12/2025
1.3.7 51 12/12/2025
1.3.6 51 12/12/2025
1.3.5 10 09/30/2026
1.3.4 11 10/06/2026
1.3.3 41 12/15/2025
1.3.2 13 10/07/2026
1.3.1 56 12/12/2025
1.3.0 62 12/15/2025
1.2.3 7 10/03/2026
1.2.2 13 10/02/2026
1.2.1 53 12/11/2025
1.2.0 59 12/12/2025
1.1.3 59 12/15/2025
1.1.2 58 12/15/2025
1.1.1 51 12/14/2025
1.1.0 63 12/11/2025
1.0.8 12 10/03/2026
1.0.7 60 12/11/2025
1.0.6 60 12/11/2025
1.0.5 12 10/01/2026
1.0.4 62 12/12/2025
1.0.3 11 10/02/2026
1.0.2 60 12/11/2025
1.0.1 8 10/06/2026
1.0.0 13 10/01/2026
1.0.0-dev1504032244 10 10/06/2026
0.8.0 54 12/15/2025
0.7.1 55 12/11/2025
0.7.0 56 12/14/2025
0.6.4 58 12/11/2025
0.6.3 11 10/06/2026
0.6.2 52 12/11/2025
0.6.1 16 10/06/2026
0.6.0 55 12/11/2025
0.5.8 55 12/12/2025
0.5.2 55 12/12/2025
0.5.0 59 12/11/2025
0.2.1-beta 60 12/11/2025
0.2.0-beta 6 10/06/2026