nextcloud-desktop/man/nextcloudcmd.1.rst

Ignoring revisions in .git-blame-ignore-revs. Click here to bypass and see the normal blame view.

98 lines
2.6 KiB
ReStructuredText
Raw Normal View History

2017-11-27 22:53:04 +03:00
:orphan:
nextcloudcmd(1)
2017-11-27 22:53:04 +03:00
—————
SYNOPSIS
========
*nextcloudcmd* [`OPTIONS`...] sourcedir nextcloudurl
2017-11-27 22:53:04 +03:00
DESCRIPTION
===========
nextcloudcmd is the command line tool used for the nextCloud file synchronization
2017-11-27 22:53:04 +03:00
desktop utility.
Contrary to the :manpage:`nextcloud(1)` GUI client, `nextcloudcmd` only performs
a single sync run and then exits. In so doing, `nextcloudcmd` replaces the
2017-11-27 22:53:04 +03:00
`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.
2017-11-27 22:53:04 +03:00
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
2017-11-27 22:53:04 +03:00
a scheme. See ``Examples`` for details.
OPTIONS
=======
``—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
Example
=======
To synchronize the nextCloud directory ``Music`` to the local directory ``media/music``
2017-11-27 22:53:04 +03:00
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 \
2017-11-27 22:53:04 +03:00
$HOME/media/music \
https://server/nextcloud/remote.php/webdav/Music
2017-11-27 22:53:04 +03:00
``nextcloudcmd`` will enquire user name and password, unless they have
2017-11-27 22:53:04 +03:00
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 \
2017-11-27 22:53:04 +03:00
$HOME/media/music \
nextclouds://server/nextcloud/remote.php/webdav/Music
2017-11-27 22:53:04 +03:00
BUGS
====
Please report bugs at https://github.com/nextcloud/client/issues.
2017-11-27 22:53:04 +03:00
SEE ALSO
========
:manpage:`nextcloud(1)`