{
  "schema_version": 2,
  "id": "operate/rs/references/cli-utilities/rladmin/recover",
  "title": "rladmin recover",
  "url": "https://redis.io/docs/latest/operate/rs/references/cli-utilities/rladmin/recover/",
  "summary": "Recovers databases in recovery mode.",
  "tags": [
    "docs",
    "operate",
    "rs"
  ],
  "last_updated": "2026-09-24T10:14:21+01:00",
  "page_type": "content",
  "content_hash": "df65091290dc3bff7960f9634446e0c95ddaf973bf08b24ffd8c6d5a998dbc61",
  "sections": [
    {
      "id": "overview",
      "title": "Overview",
      "role": "overview",
      "text": "Recovers databases in recovery mode after events such as cluster failure, and restores the databases' configurations and data from stored persistence files. See [Recover a failed database](https://redis.io/docs/latest/operate/rs/databases/recover) for detailed instructions.\n\nDatabase persistence files are stored in `/var/opt/redislabs/persist/redis/` by default, but you can specify a different directory to use for database recovery with [`rladmin node <id> recovery_path set <path>`](https://redis.io/docs/latest/operate/rs/references/cli-utilities/rladmin/node/recovery-path)."
    },
    {
      "id": "recover-all",
      "title": "`recover all`",
      "role": "content",
      "text": "Recovers all databases in recovery mode.\n\n[code example]"
    },
    {
      "id": "parameters",
      "title": "Parameters",
      "role": "parameters",
      "text": "| Parameters         | Type/Value | Description                                 |\n|--------------------|------------|---------------------------------------------|\n| only_configuration |            | Recover database configuration without data |"
    },
    {
      "id": "returns",
      "title": "Returns",
      "role": "returns",
      "text": "Returns `Completed successfully` if the database was recovered. Otherwise, returns an error."
    },
    {
      "id": "example",
      "title": "Example",
      "role": "example",
      "text": "[code example]"
    },
    {
      "id": "recover-db",
      "title": "`recover db`",
      "role": "content",
      "text": "Recovers a specific database in recovery mode.\n\n[code example]"
    },
    {
      "id": "parameters-1",
      "title": "Parameters",
      "role": "parameters",
      "text": "| Parameters         | Type/Value           | Description                                 |\n|--------------------|----------------------|---------------------------------------------|\n| db                 | db:\\<id\\> <br />name | Database to recover                         |\n| only_configuration |                      | Recover database configuration without data |"
    },
    {
      "id": "returns-1",
      "title": "Returns",
      "role": "returns",
      "text": "Returns `Completed successfully` if the database was recovered. Otherwise, returns an error."
    },
    {
      "id": "example-1",
      "title": "Example",
      "role": "example",
      "text": "[code example]"
    },
    {
      "id": "recover-list",
      "title": "`recover list`",
      "role": "content",
      "text": "Shows a list of all databases that are currently in recovery mode.\n\n[code example]"
    },
    {
      "id": "parameters-2",
      "title": "Parameters",
      "role": "parameters",
      "text": "None"
    },
    {
      "id": "returns-2",
      "title": "Returns",
      "role": "returns",
      "text": "Displays a list of all recoverable databases. If no databases are in recovery mode, returns `No recoverable databases found`."
    },
    {
      "id": "example-2",
      "title": "Example",
      "role": "example",
      "text": "[code example]"
    },
    {
      "id": "recover-s3_import",
      "title": "`recover s3_import`",
      "role": "content",
      "text": "Imports current database snapshot files from an AWS S3 bucket to a directory on the node.\n\n[code example]"
    },
    {
      "id": "parameters-3",
      "title": "Parameters",
      "role": "parameters",
      "text": "| Parameters           | Type/Value | Description                                                      |\n|----------------------|------------|------------------------------------------------------------------|\n| s3_bucket            | string     | S3 bucket name                                                   |\n| s3_prefix            | string     | S3 object prefix                                                 |\n| s3_access_key_id     | string     | S3 access key ID                                                 |\n| s3_secret_access_key | string     | S3 secret access key                                             |\n| import_path           | filepath   | Local import path where all database snapshots will be imported  |"
    },
    {
      "id": "returns-3",
      "title": "Returns",
      "role": "returns",
      "text": "Returns `Completed successfully` if the database files were imported. Otherwise, returns an error."
    },
    {
      "id": "example-3",
      "title": "Example",
      "role": "example",
      "text": "[code example]"
    }
  ],
  "examples": [
    {
      "id": "recover-all-ex0",
      "language": "sh",
      "code": "rladmin recover all\n        [ only_configuration ]",
      "section_id": "recover-all"
    },
    {
      "id": "example-ex0",
      "language": "plaintext",
      "code": "$ rladmin recover all\n  0% [ 0 recovered | 0 failed ] |         | Elapsed Time: 0:00:00[first-db (db:1) recovery] Initiated.[second-db (db:2) recovery] Initiated.\n 50% [ 0 recovered | 0 failed ] |###      | Elapsed Time: 0:00:04[first-db (db:1) recovery] Completed successfully\n 75% [ 1 recovered | 0 failed ] |######   | Elapsed Time: 0:00:06[second-db (db:2) recovery] Completed successfully\n100% [ 2 recovered | 0 failed ] |#########| Elapsed Time: 0:00:08",
      "section_id": "example"
    },
    {
      "id": "recover-db-ex0",
      "language": "sh",
      "code": "rladmin recover db { db:<id> | <name> }\n        [ only_configuration ]",
      "section_id": "recover-db"
    },
    {
      "id": "example-1-ex0",
      "language": "plaintext",
      "code": "$ rladmin recover db db:1\n  0% [ 0 recovered | 0 failed ] |      | Elapsed Time: 0:00:00[demo-db (db:1) recovery] Initiated.\n 50% [ 0 recovered | 0 failed ] |###   | Elapsed Time: 0:00:00[demo-db (db:1) recovery] Completed successfully\n100% [ 1 recovered | 0 failed ] |######| Elapsed Time: 0:00:02",
      "section_id": "example-1"
    },
    {
      "id": "recover-list-ex0",
      "language": "sh",
      "code": "rladmin recover list",
      "section_id": "recover-list"
    },
    {
      "id": "example-2-ex0",
      "language": "sh",
      "code": "$ rladmin recover list\nDATABASES IN RECOVERY STATE:\nDB:ID  NAME  TYPE   SHARDS  REPLICATION  PERSISTENCE  STATUS\ndb:5   tr01  redis  1       enabled      aof          missing-files\ndb:6   tr02  redis  4       enabled      snapshot     ready",
      "section_id": "example-2"
    },
    {
      "id": "recover-s3_import-ex0",
      "language": "sh",
      "code": "rladmin recover s3_import\n                s3_bucket <bucket name>\n                [ s3_prefix <prefix> ]\n                s3_access_key_id <access key>\n                s3_secret_access_key <secret access key>\n                import_path <path>",
      "section_id": "recover-s3_import"
    },
    {
      "id": "example-3-ex0",
      "language": "sh",
      "code": "rladmin recover s3_import s3_bucket <bucket-name> s3_prefix <s3-prefix>/ s3_access_key_id <access-key> s3_secret_access_key <secret-access-key> import_path /tmp",
      "section_id": "example-3"
    }
  ]
}