> For the complete documentation index, see [llms.txt](https://docs.catalyx.solutions/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.catalyx.solutions/catalyx-blockchain-manager/hyperledger-fabric/version-2.4/network-and-node-management/backup-and-restore.md).

# Backup and Restore

## Backup

### Architecture

On Fabric Console, you can back up any resource: peers, orderers, CAs, MSPs, and the system-channel genesis block.

You can decide to back up resources either **on-demand** or by scheduling a **periodic backup**. You can also specify how many backups to retain — once the threshold is reached, the backup operator automatically purges older versions.

The backup CRD has the following specs:

**1 — Resource:** Definition of the resource to back up. Examples:

* `peers.peerset.hyperledger.fabric/p1` — peer p1
* `orderers.orderingservice.hyperledger.fabric/o1` — orderer o1
* `fabriccas.ca.hyperledger.fabric/ca1` — fabric-ca ca1
* `configmaps/msp1` — msp msp1

**2 — Schedule:** Defines how often the backup process is carried out. Can be skipped for a one-time on-demand backup.

**3 — Retention:** Defines how many backup versions to retain. Only applicable for scheduled backups, as on-demand backups store a single version.

### Backup Process Flow

### How Does It Work?

The UI prompts you to select the resource to back up, the scheduling policy, and the retention count. The backup operator then:

{% stepper %}
{% step %}

#### Picks up the backup CRD

Schedules the backup, or creates a single backup for on-demand.
{% endstep %}

{% step %}

#### Backs up the resource

Backs up the resource manifest, any secondary resources owned by the resource, and the parent resources.
{% endstep %}

{% step %}

#### Handles an example peer backup

For example, backing up a peer that uses CouchDB: the operator backs up the peer manifest, takes a volume snapshot of its PVs, stores the CouchDB manifest, the associated secrets, and the peer set manifest.
{% endstep %}
{% endstepper %}

Scheduled backups repeat this process at the defined interval, storing multiple versions. The operator purges older versions once the retention limit is crossed.

***

## Restore

Once a backup is created, you can restore a resource to a particular backup version.

### Architecture

Unlike the backup process, restore does not have an operator but uses the Fabric Console APIs. From the Fabric Console UI, choose which resource to restore, select the backup and the version, and the resource is recreated (or deleted and restored to the requested version).

***

## Future Scope

* **Complete system backup** — Requires ordering of restore, similar to backing up a peer when it uses CouchDB.
* **Templating a restore process** — Will help launch predefined networks easily.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.catalyx.solutions/catalyx-blockchain-manager/hyperledger-fabric/version-2.4/network-and-node-management/backup-and-restore.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.