About RsyncOSX

Before installing and using RsyncOSX there are some important information to read and understand. The first document is how to get and install RsyncOSX. The second document is some information what RsyncOSX is and how to use the application. Please read the second document before using RsyncOSX.

Rsync is a file-based synchronization and backup tool. There is no custom solution for the backup archive. You can quit utilizing RsyncOSX (and rsync) at any time and still have access to all synchronized files. Be sure you understand the basics how rsync works before using RsyncOSX. There are also a changelog and some info about signing and notarizing of RsyncOSX.

RsyncOSX is also released as RsyncGUI on Apple Mac App Store. RsyncGUI only utilize the stock version of rsync in macOS. Because of that the snapshots feature not available in RsyncGUI. Neither is scheduled backups.

About bugs and crash?

What happens if bugs occurs during execution of tasks in RsyncOSX? The command line tool rsync is designed to continue where rsync is by any reason, stopped or killed. Users can abort execution of tasks at any time. To continue an aborted task execute the task again and rsync will restart and complete the task. This is also true if a bug in RsyncOSX occurs during execution of a task.

If RsyncOSX does halt or crash during operation there is no damage to files or deletion of files in the source. The source is only read during synchronize and snapshot tasks.

About restoring files to a temporary restore catalog

If you do a restore from the remote to the source, some files in the source might be deleted. This is due to how rsync works in synchronize mode. As a precaution never do a restore directly from the remote to the source, always do a restore to a temporary restore catalog.

Using RsyncOSX

The following are documents about using RsyncOSX:

Passwordless logins

Using RsyncOSX for backup to remote servers require to setup ssh passwordless login. What is ssh passwordless login? By using ssh private and public pair of keys enables a more secure method to login to remote servers without password. RsyncOSX can assist you in setting up passwordless logins or you can enable passwordless logins manually.

Versions of rsync

The default version of rsync in macOS is old (version 2.6.9, protocol version 29). Version 2.6.9 was released in nov 2006. The current release of rsync is version 3.1.3 protocol 31 released 28 January 2018. There are at least three options to get and install the current version of rsync for use in RsyncOSX:

  • get rsync-3.1.3.dmg from releases to install the latest version of rsync
  • install Xcode and download the rsync source from rsync.samba.org
    • required tools are gcc and make which are part of Xcode command line tool (you might be able to install Xcode command line tool only by downloading the tools from Apple Developer page)
    • untar the source archive and use make to compile and install, rsync compiles without any issues on macOS
  • install homebrew and then install rsync as part of homebrew

In RsyncOSX select user configuration and set path for optional version of rsync.

My own NAS setup

I have setup up my own NAS. I am doing backups by using RsyncOSX and sharing out disk by AFP and SMB.

RcloneOSX, a GUI for rclone

A intro to RcloneOSX, a GUI for rclone. The rclone changelog.

The Source

There are some documents about the source code

Written on April 15, 2018