> V1.0.3 rc.2 > Commands > Plakar restore
Version v1.0.3-rc.2

restore

PLAKAR-RESTORE(1)General Commands ManualPLAKAR-RESTORE(1)

plakar-restoreRestore files from a Plakar snapshot

plakar restore[-name name] [-category category] [-environment environment] [-perimeter perimeter] [-job job] [-tag tag] [-latest] [-before date] [-since date] [-concurrency number] [-quiet] [-to directory] [snapshotID:path ...]

The plakar restore command is used to restore files and directories at path from a specified Plakar snapshot to the local file system. If path is omitted, then all the files in the specified snapshotID are restored. If no snapshotID is provided, the command attempts to restore the current working directory from the last matching snapshot.

The options are as follows:

string
Only apply command to snapshots that match name.
string
Only apply command to snapshots that match category.
string
Only apply command to snapshots that match environment.
string
Only apply command to snapshots that match perimeter.
string
Only apply command to snapshots that match job.
string
Only apply command to snapshots that match tag.
number
Set the maximum number of parallel tasks for faster processing. Defaults to 8 * CPU count + 1.
directory
Specify the base directory to which the files will be restored. If omitted, files are restored to the current working directory.
Suppress output to standard input, only logging errors and warnings.

Restore all files from a specific snapshot to the current directory:

$ plakar restore abc123

Restore to a specific directory:

$ plakar restore -to /mnt/ abc123

Restore latest snapshot to a specific directory:

$ plakar restore -latest -to /mnt/ abc123

Restore specific path to a specific directory:

$ plakar restore -to /mnt/ abc123:/etc/apache2

Restore to a specific destination:

$ plakar restore -to @s3target abc123

Restore specific path to a specific destination :

$ plakar restore -to  @s3target abc123:/etc/apache2

The plakar-restore utility exits 0 on success, and >0 if an error occurs.

0
Command completed successfully.
>0
An error occurred, such as a failure to locate the snapshot or a destination directory issue.

plakar(1), plakar-backup(1)

July 3, 2025Plakar