Migration Guide 2.6.x to 2.7.x

The license for using Akka in production has been changed to Business Source License v1.1. Why We Are Changing the License for Akka explains the reasons and a detailed FAQ is available to answer many of the questions that you may have about the license change.

Akka 2.7.x is binary backwards compatible with 2.6.x with the ordinary exceptions listed in the Binary Compatibility Rules.

No configuration changes are needed for updating an application from Akka 2.6.x to 2.7.x.

Rolling updates of Akka Cluster from Akka 2.6.x to 2.7.x is fully supported.

No deprecated features or APIs have been removed in Akka 2.7.x.

Dependency updates


The Jackson dependency for Serialization with Jackson has been updated to 2.13.4 in Akka 2.7.0. That bump includes many fixes and changes to Jackson, but it should not introduce any incompatibility in serialized format.

Default configuration changes

Persistence plugin-dispatcher

The default plugin-dispatcher for Akka Persistence plugins has been changed to use the ordinary akka.actor.default-dispatcher.

Previously it used a PinnedDispatcher, which wasn’t a good default choice and most plugins have already overridden that setting.

Found an error in this documentation? The source code for this page can be found here. Please feel free to edit and contribute a pull request.