NEXTCLOUDCMD(1)

NAME
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.

NOTE:
        Prior to the 1.6 release of nextcloudcmd, the tool only accepted nextcloud:// or nextclouds:// in place of http:// and https:// as a scheme. See Examples for details.

    —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.

    —nonshib
        Uses Non Shibboleth WebDAV Authentication

    —davpath [path]
        Overrides the WebDAV Path with path

    —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

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 \
                      $HOME/media/music \
                      https://server/nextcloud/remote.php/webdav/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 http://192.168.178.1:8080 \
                      $HOME/media/music \
                      nextclouds://server/nextcloud/remote.php/webdav/Music

Please report bugs at https://github.com/nextcloud/client/issues.

nextcloud(1)

AUTHOR
The Nextcloud developers

COPYRIGHT
2013-2025, The Nextcloud developers