# Using `BR`: Restoring Entire `TiDB` Cluster Data

+ (mandatory) **`br restore full`**
+ (optional) **`--storage:`** The backup storage path 
+ (optional) **`--ratelimit:`** The maximum speed per `TiKV` performing restore tasks (in `MiB/s`)
+ (optional) **`--log-file`:** Output log for `BR`

+ For example:
```
$ ~!@tiup br restore full@!~ \
    --pd "10.0.0.148:2379" \
    --storage "/backup" \
    --ratelimit 128 \
    --log-file restorefull.log

tiup is checking updates for component br ...
...
Full Restore <----------------------------- ----> 100.00%
[2022/11/06 18:25:40.206 +08:00] [INFO] [collector.go:69]
["Full Restore success summary"]
...
```
```
tidb> ~!@RESTORE DATABASE *@!~ FROM 'local:///backup'
   -> RATE_LIMIT = 128 MB/SECOND;
+-----------------+---------+--------------------+---------------------+---------------------+
| Destination     | Size    | BackupTS           | Queue Time          | Execution Time      |
+-----------------+---------+--------------------+---------------------+---------------------+
| local:///backup | 6655361 | 437185856207585287 | 2022-11-06 18:48:10 | 2022-11-06 18:48:10 |
+-----------------+---------+--------------------+---------------------+---------------------+
1 row in set (25.35 sec)
```
-------------------------------------------------------------
`BR` supports restoring snapshot backup on an empty cluster to restore the target cluster to the latest state when the snapshot is backed up.

Example: Restore the snapshot generated previously at `2022-11-06 18:06:23` from the `/backup` directory.