NEXTCLOUDCMD(1) Nextcloud Client Manual NEXTCLOUDCMD(1)

nextcloudcmd - Command line Nextcloud client tool. nextcloudcmd(1) —————

nextcloudcmd [OPTIONS...] sourcedir nextcloudurl

nextcloudcmd is the command line tool used for the nextCloud file synchronization desktop utility.

Contrary to the nextcloud(1) GUI client, nextcloudcmd only performs a single sync run and then exits. In so doing, nextcloudcmd replaces the ocsync binary used for the same purpose in earlier releases.

A sync run synchronizes a single local directory using a WebDAV share on a remote nextCloud server.

To invoke the command line client, provide the local and the remote repository: The first parameter is the local directory. The second parameter is the server URL.


Prior to the 1.6 release of nextcloudcmd, the tool only accepted owncloud:// or ownclouds:// in place of http:// and https:// as a scheme. See Examples for details.
Overrides default remote root folder to a specific subfolder on the server(e.g.: /Documents would sync the Documents subfolder on the server)
—user, -u [user]
Use user as the login name.
—password, -p [password]
Use password as the password.
Use netrc (5) for login.
Do not prompt for questions.
—silent, —s
Inhibits verbose log output.
Trust any SSL certificate, including invalid ones.
—httpproxy http://[user@pass:]<server>:<port>
Uses server as HTTP proxy.
—exclude [file]
Exclude list file
—unsyncedfolders [file]
File containing the list of unsynced folders (selective sync)
—max-sync-retries [n]
Retries maximum n times (defaults to 3)
Sync hidden files,do not ignore them

To synchronize the nextCloud directory Music to the local directory media/music through a proxy listening on port 8080 on the gateway machine, the command line would be:

$ nextcloudcmd —httpproxy --path /Music \
              $HOME/media/music \

nextcloudcmd will enquire user name and password, unless they have been specified on the command line or -n (see netrc(5)) has been passed.

Using the legacy scheme, it would be:

$ nextcloudcmd —httpproxy --path /Music \
              $HOME/media/music \

Please report bugs at


The Nextcloud developers

2013-2024, The Nextcloud developers

April 24, 2024 3.13