Documentation Download GitHub

Running Unisync on Windows

This guide is a collection of tips and notes for using Unisync on Windows.

Internal SSH Client

Since most Windows installations don't have an SSH client included, many Windows users use a third-party client like PuTTY. Unisync makes some accomodations for this. First, it includes a built-in SSH client for connecting to the remote side where you don't have one. This is the default connection method on Windows (but can be changed with the method= config setting).


The PuTTY SSH client comes with a tool called Pageant, commonly used on Windows for managing SSH keys. Unisync automatically detects that Pageant is running, and will try its keys for any SSH connections. This only works when method=internalssh (which is default on Windows).

Windows and Symlinks

Windows technically has symlink support, but it's disabled by default. Therefore, unisync on Windows also disables symlink syncing by default. If you've enabled symlinks in Windows, you can also enable them in unisync with symlinks=on. See the Configuring Unisync documentation for more.

Windows Servers and DirectTLS

If your "remote" side is also on Windows, you may not have an SSH server installed. In that case, you'll need to use unisync's directtls mode to connect instead. You should see the Unisync Without SSH documentation for more on this.