rsync.wa Documentation

rsync.wa is a local-first operations console for one-way rsync workflows (remote -> local) with strong safety defaults, retry behavior, diagnostics, and setup helpers.

60-Second Start

1. Get the app:
2. Git clone:

git clone https://github.com/pkhodo/rsyncwebapp.git
cd rsyncwebapp

1. Start:
2. macOS: double-click bin/get-started.command
3. Windows: double-click bin/get-started-windows.bat
4. Linux:

./bin/quickstart.sh

1. Open:

http://rsync.localhost:<port>

8787 is the default. If it is busy, startup auto-selects another free local port.

Documentation Map

• User Docs:
• Web App Guide
• Ops & Security:
• Architecture
• Security Audit
• Maintainer Docs:
• Migrations
• UX Voice
• Apple Signing (optional)

Safety Model

• One-way default semantics (remote -> local)
• Absolute path validation for remote and local
• Mirror mode requires explicit delete confirmation
• Dangerous rsync args blocked
• API bound to localhost by default

Support Data Locations

• Jobs: profiles/jobs.json
• Locations: profiles/locations.json
• Runtime metadata: state/rsync-webapp.db
• Service state: state/service-settings.json
• Logs: state/logs/