wal command lists WAL files available for a database or replica. This
command is not typically used in normal usage and is mainly used for debugging.
List by database
This command lists all WAL files across all replicas for a database specified in the Litestream configuration file:
litestream wal [arguments] DB_PATH
List by replica URL
This command lists all WAL files for a single replica URL. This approach is useful when you do not have a configuration file.
litestream wal [arguments] REPLICA_URL
-config PATH Specifies the configuration file. Defaults to /etc/litestream.yml -no-expand-env Disables environment variable expansion in configuration file. -replica NAME Optional, filters by replica. Only applies when listing database snapshots. -generation NAME Optional, filter by a specific generation.
Database WAL files
List all WAL files across all replicas for the
$ litestream wal /var/lib/db
Filter by replica name
Lists all WAL files for the
/var/lib/db database but filters by the
$ litestream wal -replica s3 /var/lib/db
Replica URL WAL files
Lists all WAL files for a single replica URL:
$ litestream wal s3://mybkt.litestream.io/db