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 &gt; ~/bin/filesync-server-home &lt;&lt;'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 &middot; Copyright 2026 Nigel Horne &middot; GPL-2.0</p>
		<p><a href="https://metacpan.org/dist/App-FileSync">CPAN</a> &middot;
		<a href="https://github.com/nigelhorne/App-FileSync">GitHub</a> &middot;
		<a href="https://github.com/nigelhorne/App-FileSync/issues">Issues</a> &middot;
		<a href="changelog.html">Changes</a></p>
	</div>
</footer>
</body>
</html>



( run in 1.116 second using v1.01-cache-2.11-cpan-99fa8243a42 )