Topic Recovery

This feature requires an enterprise license. To get a trial license key or extend your trial period, generate a new trial license key. To purchase a license, contact Redpanda Sales.

If Redpanda has enterprise features enabled and it cannot find a valid license, restrictions apply.

When you create a topic, you can use remote recovery to download the topic data from object storage. This is useful when you need to restore a single topic in Tiered Storage that was accidentally deleted from a cluster.

While performing topic recovery, avoid adding additional load (such as produces, consumes, lists or additional recovery operations) to the target cluster. Doing so could destabilize the recovery process and result in either an unsuccessful or corrupted recovered topic.

Prerequisites

You must have:

  • Tiered Storage enabled on your Redpanda cluster.

  • Remote read (redpanda.remote.read) enabled on the topic you want to recover.

Limitations

  • Remote recovery is only safe when no other clusters are writing to the same bucket or container.

  • If you disable redpanda.remote.read after remote recovery, previously downloaded data will not be used to serve requests.

Recover a topic

To create a new topic using remote recovery, in which the recovered topic can read and write in the cloud:

rpk topic create <topic_name> -c redpanda.remote.recovery=true -c redpanda.remote.write=true -c redpanda.remote.read=true

To create a new topic using remote recovery, while also disabling the redpanda.remote.write property:

rpk topic create <topic_name> -c redpanda.remote.recovery=true -c redpanda.remote.write=false -c redpanda.remote.read=true