Beta Version
You're viewing documentation for version v1.1.0. Beta versions are subject to changes and may not represent the final stable release. Do not use in production environments.
restore
| PLAKAR-RESTORE(1) | General Commands Manual | PLAKAR-RESTORE(1) |
NAME
plakar-restore —
Restore files from a Plakar snapshot
SYNOPSIS
plakar restore | [-name name]
[-category category]
[-environment environment]
[-perimeter perimeter]
[-job job]
[-tag tag]
[-latest] [-before
date] [-since
date] [-quiet]
[-to directory]
[-skip-permissions]
[snapshotID:path ...] |
DESCRIPTION
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:
-namestring- Only apply command to snapshots that match name.
-categorystring- Only apply command to snapshots that match category.
-environmentstring- Only apply command to snapshots that match environment.
-perimeterstring- Only apply command to snapshots that match perimeter.
-jobstring- Only apply command to snapshots that match job.
-tagstring- Only apply command to snapshots that match tag.
-skip-permissions- Skip restoring file permissions and ownership during restore, defaulting to 0750 for directories and 0640 for files. It Fl to Ar directory Specify the base directory to which the files will be restored. If omitted, files are restored to the current working directory.
-quiet- Suppress output to standard input, only logging errors and warnings.
EXAMPLES
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
DIAGNOSTICS
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.
SEE ALSO
| July 3, 2025 | Plakar |
Found a bug or mistake in the documentation? Create an issue on GitHub