findify / akka-persistence-s3   0.1.1

MIT License GitHub

Amazon S3 Snapshot Store Plugin for Akka Persistence

Scala versions: 2.12 2.11

Amazon S3 Snapshot Store Plugin for Akka Persistence

An Akka Persistence snapshot store backed by Amazon S3. This is a forked version of an abandoned plugin by TanUkkii007 with some new features.

Please note that this module only provides Snapshot plugin.


This package is available for Scala 2.11/2.12 (on Java 8). To install using SBT, add these statements to your build.sbt:

libraryDependencies += "io.findify" %% "akka-persistence-s3" % "0.1.1"

On maven, update your pom.xml in the following way:

    // add this entry to <dependencies/>


akka.persistence.snapshot-store.plugin = "s3-snapshot-store"

  aws-access-key-id = <your key>
  aws-secret-access-key = <your secret>
  region = "us-west-2"
  endpoint = "default"
  options {
    path-style-access = false
    chunked-encoding-disabled = false

s3-snapshot-store {
  bucket-name = "snapshot"
  prefix = "some/dir/" 
  extension = "ss"
  max-load-attempts = 3

S3 key structure

A snapshot object is saved with following key format.

<persistenceId>/<reverse sequenceNr>-<timestamp>.<extension>

Note that sequenceNr is reversed to optimize performance for partitioning. See