Akka 1.6.0-beta8

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.

Using the v1.6 betas? Start here.

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 1.6.0-beta8 adds TLS certificate rotation without a restart on both DotNetty and Artery, brings Akka.Reminders into the repository, and fixes a PersistAll completion bug plus two recurring-reminder ordering bugs. Read the v1.6 getting started guide for the full upgrade path.

Akka.IO / TLS

  • TlsCertificateSource picks the certificate a node presents from a folder, a certificate store by common name, or a callback, and picks up a renewed certificate without a restart. A folder or store source is re-read in the background at most once every 10 seconds and the result is reused in between; a callback is called every time. Startup waits for the first look-up, and a source with nothing usable throws ConfigurationException so the node never binds. A connection that cannot get a certificate fails alone and the node stays up. (#8966, relates to #7663)
  • Certificate errors are logged at most once a minute per cause, so one bad certificate does not log a Warning for every connection. DotNetty and Artery now share Akka.IO.TlsCertificateRotation for that limiter, the startup check and the one-minute poll interval, but each transport keeps its own instance so one transport never hides another's errors. (#8982)
  • On Artery's provider path, a failed certificate look-up now surfaces as an internal TlsCertificateUnavailableException that wraps the original cause, instead of writing a flag into the caller's own exception object. The only visible difference is one more ---> level in the stack trace of Akka.Streams' "Restarting graph due to failure." warning. Fixed-certificate TLS and DotNetty are unaffected. (#8982)

Akka.Remote / DotNetty

  • DotNetty TLS certificates now rotate without a restart. DotNettySslSetup.FromSource, the HOCON keys certificate.common-name and certificate.path (a folder), SslOptions.CertificateSource and SslCertificateOptions.CommonName wire a TlsCertificateSource into the transport and Akka.Hosting. (#8967)
  • Artery rotates TLS certificates through the same TlsCertificateSource. Three new factories on ArteryTlsSettings - Mutual(TlsCertificateSource, TlsPeerPolicy), a two-policy Mutual overload, and ServerOnly(TlsCertificateSource, TlsPeerPolicy) - take a source, and the node asks it for a certificate each time it builds a connection. Akka.Remote.Hosting needs no new API: ArteryRemoteOptions.Tls takes the profile. A startup look-up with nothing usable throws ConfigurationException and the node never binds, and a connection that cannot get a certificate fails alone while the node stays up. (#8979, relates to #7663)
  • Behavior change: SslOptions.CustomValidator now runs when the certificate comes from SslOptions.CertificateOptions (a file Path or a Thumbprint). It used to run only with SslOptions.X509Certificate; with the other two it was silently ignored, so a security check you configured never ran. A validator that was ignored can now fail a TLS handshake, and on the dialing side a failed handshake shuts the ActorSystem down. With EnableSsl = true, a CustomValidator and no certificate in the options, WithRemoting now throws ConfigurationException. The certificate also loads when WithRemoting runs rather than when the ActorSystem starts, so a missing file or thumbprint fails earlier. See the v1.6 breaking-change ledger. (#8964)

Akka.Reminders (new module)

  • Akka.Reminders now ships from this repository as Akka.Reminders and its storage packages, replacing the standalone Aaron.Akka.Reminders packages. It provides durable, re-entrant reminders for Akka.Cluster.Sharding with SQL Server, PostgreSQL, SQLite and in-memory storage, a cluster-singleton scheduler, and Akka.Hosting integration. Migration: the package ID changed, so update your PackageReference and namespaces. (#8946)
  • Opt-in retry-until-acknowledged delivery: a reminder can require an explicit acknowledgement before it counts as delivered, with exponential backoff between attempts. The policy is persisted in all four storage backends, and existing signatures and default-policy wire layouts are unchanged. Opted-in schedules, responses and listings use versioned manifests, so upgrade every potential scheduler host and policy-message reader before enabling the feature - older schedulers must not take over while opted-in rows exist. Manual migration scripts for each provider live in src/contrib/reminders/docs/migrations/retry-policy/, and every provider and potential scheduler host must be recreated after migrating because schema capabilities are cached. (#8973)
  • An early send of a recurring reminder now ends every older live occurrence atomically with the newer delivery, suppresses those rows for the rest of the fetch pass, and prevents a stale row from writing them back as Pending. Previously only the previous occurrence was ended, so a series with an interval below MaxSlippage could deliver stale occurrences after a newer one during a shard-region outage. (#8971, #8976, fixes #8965)
  • That cleanup is capped at 256 older occurrences per send, nearest first. A 1 ms interval would otherwise put thousands of expiries in one commit, and a sub-millisecond interval could put millions into the scheduler's memory. Below roughly a 20 ms interval at the default 5 s MaxSlippage, an older occurrence more than 256 intervals back can still be delivered after a newer one during a shard-region outage. (#8975, #8976)

Akka

  • Unwatch now clears the sole watcher from an optimized actor state. DefaultActorState.RemoveWatchedBy never cleared its optimized slot, so a target kept a reference to an actor that had unwatched it. FullActorState already removed watchers correctly. No public API or wire-format change. (#8936)

Akka.Persistence

  • The PersistAll completion callback no longer runs when the journal rejects the batch. OnPersistRejected fired for each event and then the completion callback ran anyway, so a handler saw a completion for a batch that was never persisted. This affected all eight PersistAll/PersistAllAsync overloads. Journal write failures are unchanged: the actor stops before the completion's message is processed. (#8949, fixes #8948)

Akka.Remote / Artery

  • Artery's inbound stage now reports a framing error when a peer closes after a partial connection preamble, frame length or frame body, instead of silently completing the connection. Empty connections and complete frame boundaries still close cleanly, and cancellation and upstream failure keep their existing semantics. Artery is new in v1.6, so this changes unreleased behavior only. (#8956)

Serialization

  • Native module replacements can preserve legacy serializer type names through an optional type-alias map, so a ported serializer keeps reading data written under the original assembly-qualified name. Each declared name resolves to an existing module row using the declared type's assembly simple name and the existing strict name-matching rules; subclasses are not matched. Missing or ambiguous aliases, non-serializer types and conflicting registrations are rejected. No serializer rows, ids or configuration switches are added. (#8920)

Akka.Hosting

  • Akka.Hosting, Akka.Cluster.Hosting, Akka.Remote.Hosting, Akka.Persistence.Hosting and Akka.Persistence.Embedded.Hosting now ship their own module READMEs on nuget.org instead of the generic Akka.NET one. Relative links were rewritten to absolute GitHub permalinks because nuget.org cannot resolve relative paths. (#8945)

Docs

  • New TLS certificate rotation article covers folder, store and callback sources, when a renewed certificate is used, what happens when a look-up finds nothing usable, and the error-logging behavior. Both the DotNetty transport and Artery rotate certificates the same way. (#8968, relates to #7663)

Internal

  • MultiNodeSpec now terminates a replacement actor system when initialization fails, including on caller cancellation, and preserves the original exception. (#8955)
  • RemotePingPong validates delivery and compares authenticated TCP, and measures latency at a scheduled offered load with per-run reporting that separates generator lateness, dispatch delay, send-to-echo and scheduled-to-echo latency. (#8953, #8957)
  • Artery's DeathWatch ACK-loss test now witnesses TCP system-message retries by counting dropped ACKs per peer UID and cumulative sequence. (#8954)
  • ShardedDaemonProcessSpecs waits for sharded daemon restarts with one overall deadline instead of back-to-back 3-second waits, fixing a Windows CI timeout. (#8981)
  • Slopwatch upgraded to 0.5.0 with a regenerated schema-v2 baseline. (#8980)
  • The Serialization V2 port-comparison test kit now compares the root message's members in its structural fallback and checks the exact runtime type before the equality fast path, and supports shared system names. Test-only; no production API, bindings or wire bytes change. (#8916)

1 contributor since release 1.6.0-beta7

COMMITS LOC+ LOC- AUTHOR
22 44500 1088 Aaron Stannard

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 51 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