Scroll to navigation

sy(1) General Commands Manual sy(1)


sy - secure file sync software for arbitrary storage backends


sy [-l|--localdir=<path>] [--log=<path>] [-v]
[-vv] [--loglevel=<level>] [--print]
[-d|--debug] [-h|--help] <command> [<args>]


Syncany is an open-source cloud storage and filesharing application. It allows users to backup and share certain folders of their workstations using any kind of storage.

Main sync commands:
init Initialize the current folder as a Syncany folder
connect Connect the current folder to an existing Syncany repository
up Detect local changes and upload to repository
down Detect remote changes and apply locally

Other commands:
status Detect and print local changes
ls-remote Detect and print remote changes
ls List and filter the current and past file tree.
cleanup Remove old versions from the local database and the repo
restore Restore the given file paths from the remote repository
genlink Create a syncany:// link from an existing local folder
plugin List, install and remove storage backend plugins
update Manage and check for application updates
daemon Start and stop the background process (daemon)
watch Automatically sync the local folder (in the foreground)

Short command descriptions and options can be found below. Detailed explanations can be queried with `sy <command> --help`.

An extensive user guide with many examples is also available on the Syncany website:


-l, --localdir=<path>

Use <path> instead of the current directory as local sync folder. Syncany searches for a ´.syncany´ folder in the given and all parent directories.

-d, --debug

Sets the log level to ALL, and print the log to the console. Alias to: --loglevel=ALL --print

-h, --help

Print this help screen and exit.

-v, -vv

Print application version exit.


Log output to the file given by <path>. If - is given, the output will be logged to STDOUT (default).


Change log level to <level>. Level can be either of the following: OFF, SEVERE, WARNING, INFO, FINE, FINER, FINEST, ALL


Print the log to the console (in addition to the log file).


Written by Philipp C. Heckel and many others


Please report bugs to the GitHub issues page at


Syncany 0.4.9-alpha, Distributed under GPLv3, Copyright (c) 2011-2015 Philipp C. Heckel