PLAKAR-SYNC(1)

📦 version 1.1.7, in nixos 26.05, nixpkgs unstable

💅 PLAKAR-SYNC(1) — the plakar-sync girlies' guide

okay so bestie, welcome to plakar-sync, one of the plakar commands, and honestly? it's giving ✨*matchmaker for repositories*✨. it synchronizes snapshots between Plakar repositories, and it does it flawlessly. no cap.

🌸 SYNOPSIS

plakar sync [-cache path] [-packfiles path] [snapshotID] to | from |
       with repository

like, that's the whole vibe up there ^^ read it carefully, she's picky about order 🎀

💖 DESCRIPTION

bestie. listen. the plakar sync command synchronizes snapshots between two Plakar repositories. that's it, that's the whole job, and she ate. 🔥

and here's the cute part: if you pass a specific snapshot ID, then only the snapshots with matching IDs get synchronized. so if you're like "girl, just this one," she's like "say less." 💅

also, plakar sync supports the location flags documented in plakar-query(7) — so you can precisely select which snapshots you want, like a little curator. use them, they're iconic. 🦋

the options are as follows, and yes we are going through every single one:

  • -cache path — specify a path where the vfs cache should live. and ooh, she has special values 👑: use the special value no to disable caching entirely, or the special value vfs to use the in-memory vfs cache — which, btw, is the default. so that's the main character setting, periodt.
  • -packfiles path — path where the temporary packfiles go, instead of building them in the default temporary directory. and if you specify the special value memory, then the packfiles are built in memory. no disk, no problem. ⭐ (note: the original says "build in memory," we're not fixing that typo, we're just vibing with it 🫶)

and now the arguments, aka the actual directions of the whole operation:

  • to | from | with — this specifies the direction of synchronization, and each one has its own personality:
    • to — synchronize snapshots from the local repository to the specified peer repository. like, you're sending them out into the world. bye bestie, slay over there. 🧚
    • from — synchronize snapshots from the specified peer repository to the local repository. receiving them. spoiling yourself. we love a self-care moment. 🌸
    • with — synchronize snapshots in both directions, ensuring both repositories are fully synchronized. mutual. reciprocal. the healthy relationship. 💜
  • repository — path to the peer repository you're synchronizing with. your plus-one. your other half. 🫶
fr fr: pick your direction deliberately — to, from, and with do genuinely different things and you don't want to find out the hard way 😭

✨ EXIT STATUS

the plakar-sync utility exits 0 on success, and >0 if an error occurs. clean and simple, iykyk. 💀

🎀 EXAMPLES

synchronize the snapshot abcd with a peer repository — look at her go:

$ plakar sync abcd to @peer

bi-directional synchronization with peer repository of recent snapshots — this one is so good, -since 7d giving main character energy 👑:

$ plakar sync -since 7d with @peer

synchronize all snapshots of @peer to @repo — a whole handoff, iconic:

$ plakar at @repo sync from @peer

🦋 SEE ALSO

literally go read them, they're both so good. 🔥

okay bestie, that's the page 💖 huge shoutout to the Debian edition, dated May 5, 2026 — that's the source/version and date energy you're getting, and honestly? she's a keeper. now go sync something and be iconic about it. 🌈✨💅

📦 where this page comes from