Perform Point-In-Time-Recovery (PITR) in Valkey/Redis

This article explains how you can perform Point-in-time-Recovery (PITR) in Valkey/Redis.

Requirements

To perform PITR, you need to have append-only logging enabled.

By default, AOF in Valkey/Redis only records the operations that have been executed against the instance, not when they were executed. For that, we need to enable the aof-timestamp-enabled parameter.

So your Valkey/Redis instance needs to have the following parameters:

A little refresher on append-only logging in Valkey/Redis

AOF persistence logs every write operation received by the server. These operations can then be replayed again at server startup, reconstructing the original dataset. Commands are logged using the same format as the Valkey protocol itself.

Valkey/Redis writes the commands to AOF files in plaintext, so if you only need to remove an accidental command (i.e., FLUSHDB), or there are corrupted commands in the append-only logs, you can simply open the AOF file and fix/delete it.

A more comprehensive documentation on Valkey/Redis serialization format can be found on the official Valkey documentation.

Determine the timestamps you can restore to

So, because AOF will be rewritten when its size reaches the value defined by auto-aof-rewrite-*, if you do not have backups of the append-only logs available, you can only restore up to the point when AOF rewrite started. While the auto rewrite process can be disabled (by setting auto-aof-rewrite-percentage to 0), if you opt to do so, you will need to monitor the server’s storage closely and take action to ensure it is not completely filled.

You can identify the available restore points by grepping the AOF file for the string #TS:

To quickly convert the timestamps in AOF files into human-readable dates, we can use the commands below

• Lines in AOF files are terminated by CRLF, so you might have difficulty parsing the timestamps if you write a script for it. To solve that, we can just remove the line terminator using tr:

Truncate the AOF to your chosen timestamp

After identifying the timestamp you wish to restore to, we can use the command valkey-check-aof to truncate the AOF file to that point. For example, if I wanted to restore to the timestamp 1764918201 (2025-12-05 07:03:21):

We can then check the result by grepping the AOF file again for timestamps

Start the service

After truncating, we can start the service as normal, and confirm that valkey-server can read the truncated AOF file by viewing its log:

Conclusion

Valkey/Redis Point-in-Time Recovery (PITR) is achieved exclusively through the Append Only File (AOF) mechanism with timestamping enabled.

The final process is:

1. Select  a timestamp embedded within the AOF using valkey-check-aof to truncate the AOF file precisely to the chosen time
2.  Then, restart the service to load the truncated AOF, which restores the database state to the specified point in time.