Version Support
Apache Pekko uses Semantic Versioning 2.0.0.
Currently, the versions of the various Apache Pekko Modules are fairly closely synched up. This may not continue to be the case in future and we aim to keep this page up to date to try to describe what versions work with each other.
A separate but related topic is our set of Binary Compatibility rules.
Version 2.0.x Milestones
We have started releasing 2.0.0 milestone releases beginning with the core Pekko module and working through the modules that are most widely used. The milestone releases are only for testing purposes and to facilitate library maintainers. They are not meant to be used in production.
Due to quite a lot of deprecated code being removed in 2.0.x, it is unlikely that libs built against Pekko 1.x jars will work with Pekko 2.0.x.
Version 1.x
It is best to use the latest 1.x releases for all the Pekko modules out there.
We will continue to fix bugs and upgrade dependencies when they fix issues. Until the 2.0.0 full release is ready, we may add some enhancements and they will appear in minor releases.
Once the Pekko 2.0.0 full release is done, we will end active development in 1.x and only important bug fixes including security fixes will appear in new 1.x releases. Dependency upgrades will only be made for important bug fixes including security fixes.
We will backport fixes to the 1.x series on a best-effort basis. More complicated changes may not be possible to apply to 1.x and users who need such changes may need to upgrade to 2.x.
With 1.x, changes will normally only be made to the most recent 1.x release and won’t generally be backported to previous 1.x minor versions.
We will announce an end of support date in due course.
Migration Guides
We have pages dedicated to specific Pekko modules. If you are migrating from Akka, it might be best to migrate first to Pekko 1.0.x and to then upgrade to a newer version of Pekko when you are happy you have things working with 1.0.x.
When migrating between Pekko versions, it is worth checking if you are using deprecated code and to try to follow the notice instructions that appear in the Scala and Java docs. It is also worthwhile to read the Module Release Notes.