{
  "id": "backup-list",
  "title": "BACKUP LIST",
  "url": "https://redis.io/docs/latest/commands/backup-list/",
  "summary": "List the immutable backup file paths pinned so far.",
  "tags": [
    "docs",
    "develop",
    "stack",
    "oss",
    "rs",
    "rc",
    "oss",
    "kubernetes",
    "clients"
  ],
  "last_updated": "2026-07-30T08:54:30-07:00",
  "page_type": "content",
  "content_hash": "0e2342e1fb9692041750ea775ba696bbe704575bbe550353ac02e2521408a42b",
  "sections": [
    {
      "id": "overview",
      "title": "Overview",
      "role": "overview",
      "text": "Returns the absolute paths of the immutable backup files pinned so far."
    },
    {
      "id": "examples",
      "title": "Examples",
      "role": "example",
      "text": "While the backup is still in the `incrementing` state, only the BASE file is pinned:\n\n[code example]\n\nAfter [`BACKUP SEAL`](https://redis.io/docs/latest/commands/backup-seal), the INCR file and the manifest are pinned as well:\n\n[code example]"
    },
    {
      "id": "details",
      "title": "Details",
      "role": "content",
      "text": "`BACKUP LIST` reports the absolute paths of the files that have been pinned by hard links so far. This lets the data plane start uploading the BASE snapshot while Redis is still accumulating incremental writes, before the backup is sealed. After the backup is sealed, the list also includes the INCR file and the manifest.\n\nFor the full workflow, see [Redis persistence](https://redis.io/docs/latest/operate/oss_and_stack/management/persistence#online-backups-with-the-backup-command-family)."
    },
    {
      "id": "redis-software-and-redis-cloud-compatibility",
      "title": "Redis Software and Redis Cloud compatibility",
      "role": "content",
      "text": "| Redis<br />Software | Redis<br />Cloud | <span style=\"min-width: 9em; display: table-cell\">Notes</span> |\n|:----------------------|:-----------------|:------|\n| <span title=\"Not supported\">&#x274c; Standard</span><br /><span title=\"Not supported\"><nobr>&#x274c; Active-Active</nobr></span> | <span title=\"Not supported\">&#x274c; Standard</span><br /><span title=\"Not supported\"><nobr>&#x274c; Active-Active</nobr></span> |  |"
    },
    {
      "id": "return-information",
      "title": "Return information",
      "role": "returns",
      "text": "**RESP2:**\n\n[Array reply](../../develop/reference/protocol-spec#arrays): the absolute paths of the immutable files pinned so far.\n\n**RESP3:**\n\n[Array reply](../../develop/reference/protocol-spec#arrays): the absolute paths of the immutable files pinned so far."
    },
    {
      "id": "see-also",
      "title": "See also",
      "role": "related",
      "text": "[`BACKUP START`](https://redis.io/docs/latest/commands/backup-start/) | [`BACKUP SEAL`](https://redis.io/docs/latest/commands/backup-seal/) | [`BACKUP STATUS`](https://redis.io/docs/latest/commands/backup-status/) | [`BACKUP ABORT`](https://redis.io/docs/latest/commands/backup-abort/) | [`BACKUP CLEANUP`](https://redis.io/docs/latest/commands/backup-cleanup/)"
    },
    {
      "id": "related-topics",
      "title": "Related topics",
      "role": "related",
      "text": "- [Redis persistence](https://redis.io/docs/latest/operate/oss_and_stack/management/persistence)"
    }
  ],
  "examples": [
    {
      "id": "examples-ex0",
      "language": "plaintext",
      "code": "127.0.0.1:6379> BACKUP LIST\n1) \"/var/lib/redis/backupdir/appendonly.aof.3.base.rdb\"",
      "section_id": "examples"
    },
    {
      "id": "examples-ex1",
      "language": "plaintext",
      "code": "127.0.0.1:6379> BACKUP LIST\n1) \"/var/lib/redis/backupdir/appendonly.aof.3.base.rdb\"\n2) \"/var/lib/redis/backupdir/appendonly.aof.3.incr.aof\"\n3) \"/var/lib/redis/backupdir/appendonly.aof.manifest\"",
      "section_id": "examples"
    }
  ]
}