App-FileSync
view release on metacpan or search on metacpan
website/html/index.html view on Meta::CPAN
deltas when the other side holds an older copy.</p>
</li>
<li class="card">
<h3>Conflicts are kept</h3>
<p>The newer mtime wins; the loser is preserved beside it as
<code>report.conflict-laptop-1-20261022T101500Z.txt</code>, never silently
discarded.</p>
</li>
<li class="card">
<h3>Deletions are recoverable</h3>
<p>Removed files go to a per-repo trash, kept for 30 days by default.
<code>filesync restore</code> puts a path back, or lists every version.</p>
</li>
<li class="card">
<h3>Snapshots for replicas</h3>
<p>A replica can take a daily snapshot of its tree, by hard link or by
copy, and roll back to a date. Fourteen are kept by default.</p>
</li>
<li class="card">
<h3>Boring to operate</h3>
<p>JSON configuration and run logs you can read with <code>cat</code>,
people-readable messages from a catalogue, and distinct exit codes for
cron.</p>
</li>
</ul>
<h2>A repo in six commands</h2>
<p>Two machines are involved: the server, which holds the master, and each
client, which holds a copy. Install App::FileSync on both. The example keeps
the master in the server account's home directory, so nothing runs as root.</p>
<pre><code># on the server, once
filesync-admin --root ~/filesync repo create documents
# on the server, once: filesync-server needs the same --root
cat > ~/bin/filesync-server-home <<'EOF'
#!/bin/sh
exec /usr/local/bin/filesync-server --root "$HOME/filesync" "$@"
EOF
chmod +x ~/bin/filesync-server-home
# on each client, once
filesync init --repo documents --root /home/foo/Documents \
--server foo@srv --server-command /home/foo/bin/filesync-server-home
# on each client, whenever you like
filesync sync --repo documents --dry-run
filesync sync --repo documents</code></pre>
<p>The client reports its host name as its id; there is nothing else to name.
An id is not a login, and it does not divide the repo: every client of a repo
syncs the whole tree.</p>
<h2>Where to go next</h2>
<ul class="grid">
<li class="card">
<h3><a href="quickstart.html">Quick start</a></h3>
<p>Server and client setup, the first sync, cron, Windows, and a
backup-and-restore drill.</p>
</li>
<li class="card">
<h3><a href="commands.html">Commands</a></h3>
<p>Every option of <code>filesync</code>, <code>filesync-admin</code>
and <code>filesync-server</code>, and what each exit code means.</p>
</li>
<li class="card">
<h3><a href="settings.html">Settings</a></h3>
<p>Process-wide settings, the client's repo list, the server's per-repo
policy, and where each value came from.</p>
</li>
<li class="card">
<h3><a href="how-it-works.html">How it works</a></h3>
<p>The session, the line-delimited JSON protocol, deltas, conflicts,
locking and the layout on disk.</p>
</li>
</ul>
</main>
<footer class="site-footer">
<div class="wrap">
<p>App::FileSync 0.002.0 · Copyright 2026 Nigel Horne · GPL-2.0</p>
<p><a href="https://metacpan.org/dist/App-FileSync">CPAN</a> ·
<a href="https://github.com/nigelhorne/App-FileSync">GitHub</a> ·
<a href="https://github.com/nigelhorne/App-FileSync/issues">Issues</a> ·
<a href="changelog.html">Changes</a></p>
</div>
</footer>
</body>
</html>
( run in 1.116 second using v1.01-cache-2.11-cpan-99fa8243a42 )