nextcloudcmd(1)

Usage

nextcloudcmd [OPTIONS ...] sourcedir nextcloudurl

Overview

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.

NOTE:

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.

Options

--path: 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.

-n: Use netrc(5) for login.

--non-interactive: Do not prompt for questions.

--silent, --s: Inhibits verbose log output.

--trust: 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)

-h: Sync hidden files,do not ignore them

Examples

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

$ nextcloudcmd --httpproxy http://192.168.178.1:8080 --path /Music \
              $HOME/media/music \
              https://server/nextcloud

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 http://192.168.178.1:8080 --path /Music \
              $HOME/media/music \
              ownclouds://server/nextcloud

Releases

3 releases since Debian 11 (Bullseye); the text changed 2 times.

11
12
13

--exclude since Debian 13 (Trixie); --httpproxy since Debian 13 (Trixie); --max-sync-retries since Debian 13 (Trixie); --non-interactive since Debian 13 (Trixie); --password since Debian 13 (Trixie); --path since Debian 13 (Trixie); --s since Debian 13 (Trixie); --silent since Debian 13 (Trixie); --trust since Debian 13 (Trixie); --unsyncedfolders since Debian 13 (Trixie); --user since Debian 13 (Trixie); -h since Debian 13 (Trixie); -n since Debian 13 (Trixie); -p since Debian 13 (Trixie); -u since Debian 13 (Trixie).

Referred to by