bckWinRsync/client/windows-helpers/README.md

Windows Client Tooling Setup

This folder holds helpers you run on the Windows host that will be pulled by the Proxmox orchestrator.

1. Prerequisites on Windows

• Run PowerShell with Administrative privileges.
• Ensure OpenSSH.Client is available (Windows ships with it by default on modern builds).
• Copy a portable rsync.exe (and its DLLs) to windows-helpers/assets/rsync.zip so the setup script can expand it into C:\BackupClient\bin.

2. Run the helper

1. Open PowerShell in this folder.
2. Execute .uild\setup_openssh_rsync.ps1 (adjust path if you copy the scripts elsewhere) with optional parameters:

   .\setup_openssh_rsync.ps1 -InstallDir C:\BackupClient -RsyncZipPath .\assets\rsync.zip
   

3. The script:
   • installs/starts the OpenSSH Server feature, sets sshd to auto-start and opens port 22.
   • creates C:\BackupClient and copies the rsync binary into C:\BackupClient\bin.

3. Post-setup checks

• sshd should be running (Get-Service sshd).
• The firewall rule BackupClient SSH allows inbound TCP 22 on private/domain networks.
• From the Proxmox server, ssh backupuser@<windows_ip> succeeds and the rsync.exe inside C:\BackupClient\bin can be invoked.

4. Notes

• Keep the rsync.exe bundle in the installer so the orchestrator can invoke rsync --server over SSH.
• Store any helper scripts and configuration files near the packaged client so the scheduler toggle and future automation can find them.