The Akka Persistence JDBC plugin allows for using JDBC-compliant databases as backend for Akka Persistence and Akka Persistence Query.

akka-persistence-jdbc writes journal and snapshot entries to a configured JDBC store. It implements the full akka-persistence-query API and is therefore very useful for implementing DDD-style application models using Akka and Scala for creating reactive applications.

Akka Persistence JDBC requires Akka 2.9.3 or later. It uses Slick 3.5.1 internally to access the database via JDBC, this does not require user code to make use of Slick.

Version history

Description Version Akka version
Required database schema migration, see Migration 5.4.0 Akka 2.6.+
New database schema, see Migration 5.0.0 Akka 2.6.+
First release within the Akka organization 4.0.0 Akka 2.6.+
Requires Akka 2.5.0 3.5.3+ Akka 2.5.23+ or 2.6.x

See the full release history at GitHub releases.

Module info

The Akka dependencies are available from Akka’s library repository. To access them there, you need to configure the URL for this repository.

resolvers += "Akka library repository".at("https://repo.akka.io/maven")
      <name>Akka library repository</name>
repositories {
    maven {
        url "https://repo.akka.io/maven"

Additionally, add the dependencies as below.

val AkkaVersion = "2.9.3"
val SlickVersion = "3.5.1"
libraryDependencies ++= Seq(
  "com.lightbend.akka" %% "akka-persistence-jdbc" % "5.4.1",
  "com.typesafe.akka" %% "akka-persistence-query" % AkkaVersion,
  "com.typesafe.slick" %% "slick" % SlickVersion,
  "com.typesafe.slick" %% "slick-hikaricp" % SlickVersion
def versions = [
  AkkaVersion: "2.9.3",
  SlickVersion: "3.5.1",
  ScalaBinary: "2.13"
dependencies {
  implementation "com.lightbend.akka:akka-persistence-jdbc_${versions.ScalaBinary}:5.4.1"
  implementation "com.typesafe.akka:akka-persistence-query_${versions.ScalaBinary}:${versions.AkkaVersion}"
  implementation "com.typesafe.slick:slick_${versions.ScalaBinary}:${versions.SlickVersion}"
  implementation "com.typesafe.slick:slick-hikaricp_${versions.ScalaBinary}:${versions.SlickVersion}"
Project Info: Akka Persistence JDBC
JDK versions
Eclipse Temurin JDK 11
Eclipse Temurin JDK 17
Eclipse Temurin JDK 21
Scala versions2.13.13, 3.3.3
JPMS module nameakka.persistence.jdbc
Readiness level
Supported, support is available from Lightbend
Since 5.1.0, 2022-10-05
Home pagehttps://doc.akka.io/docs/akka-persistence-jdbc/current/
Release notesGitHub releases
IssuesGitHub issues

Contribution policy

Contributions via GitHub pull requests are gladly accepted from their original author. Along with any pull requests, please state that the contribution is your original work and that you license the work to the project under the project’s open source license. Whether or not you state this explicitly, by submitting any copyrighted material via pull request, email, or other means you agree to license the material under the project’s open source license and warrant that you have the legal authority to do so.

Code of Conduct

Contributors all agree to follow the Lightbend Community Code of Conduct.


This source code is made available under the Business Source License 1.1

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.