PLAKAR-RESTORE(1)

💅 PLAKAR-RESTORE(1) — the restore glow-up 💅

ok so this is the plakar-restore page from the General Commands Manual, and bestie, we're about to make restoring files make sense. no cap. 🫶

---

✨ NAME ✨

plakar-restore — restore files from a Plakar snapshot 🎀 (yes, the whole point: getting your stuff back)

🌸 SYNOPSIS 🌸

plakar restore [-category category] [-environment environment]
       [-job job] [-name name] [-perimeter perimeter]
       [-skip-permissions] [-tag tag] [-to directory] [-o option=value]
       [snapshotID:path ...]

💖 DESCRIPTION 💖

okay so picture this: the plakar restore command pulls files and directories at path out of a specified Plakar snapshot and drops them onto your local file system. iconic behavior honestly. 🦋

and like, the rules of the game are:

• if path is omitted, then all the files in the specified snapshotID are restored. full send. 💀
• if no snapshotID is provided, the command attempts to restore the current working directory from the last matching snapshot. literally so convenient.

The options are as follows: 👇

• -name string — only apply the command to snapshots that match name.
• -category string — only apply the command to snapshots that match category.
• -environment string — only apply the command to snapshots that match environment.
• -perimeter string — only apply the command to snapshots that match perimeter.
• -job string — only apply the command to snapshots that match job.
• -tag string — only apply the 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. no permission drama, just vibes. 🙈
• -to directory — specify the base directory to which the files will be restored. if omitted, files are restored to the current working directory. main character default energy. 👑
• -o option=value — can be used to pass extra arguments to the destination connector. the given option takes precedence over the configuration file. it said "i'm the priority here" and honestly? valid. ⭐

🌈 EXIT STATUS 🌈

the plakar-restore utility exits 0 on success, and >0 if an error occurs. so like, zero means slay, anything else means something went off. 😭

🔥 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 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

🧚 SEE ALSO 🧚

plakar(1), plakar-backup(1) — go read these too, iykyk 💜

---

that's the whole page bestie, go forth and restore responsibly. and fr fr, this one's brought to you by Debian, dated May 5, 2026 — the PLAKAR-RESTORE(1) of the group chat. 🍓💅✨