Man1 - nextcloud.1

nextcloud - File synchronisation desktop utility.

nextcloud(1) -------–—

nextcloud [/OPTIONS/…]

The nextCloud Client is a file synchronization desktop utility. It synchronizes files on your local computer, tablet, or handheld device with an nextCloud Server. If you make a change to the files on one device, the change is propagated to all other synchronized devices using the desktop synchronization clients.

Normally, you start the client by clicking on the desktop icon or by starting it from the client application menu. After starting, an nextCloud icon appears in the computer system tray or on your tablet or handheld device.

You have the option of starting your Nextcloud desktop client with the nextcloud command. The following options are supported:

*nextcloud -h or nextcloud –help*

Displays all command options.

The other options are:

–logwindow

Opens a window displaying log output.

*–logfile /<filename>/*

Write log output to the file specified. To write to stdout, specify - as the filename.

*–logdir /<name>/*

Writes each synchronization log output in a new file in the specified directory.

*–logexpire /<hours>/*

Removes logs older than the value specified (in hours). This command is used with –logdir.

–logflush

Clears (flushes) the log file after each write action.

–logdebug

Also output debug-level messages in the log (equivalent to setting the env var QT_LOGGING_RULES=“qt.*=true;*.debug=true”).

*–confdir /<dirname>/*

Uses the specified configuration directory.

–background

Launch the application in the background (i.e. without opening the main dialog).

The Nextcloud Client reads a configuration file. You can locate this configuration file as follows:

On Linux distributions:

$HOME/.config/Nextcloud/nextcloud.cfg

(no term)

On Microsoft Windows systems: :: %APPDATA%\Nextcloud\nextcloud.cfg

(no term)

On macOS systems: :: $HOME/Library/Preferences/Nextcloud/nextcloud.cfg

The configuration file contains settings using the Microsoft Windows .ini file format. You can overwrite changes using the Nextcloud configuration dialog.

NOTE:

#+begin_quote Use caution when making changes to the Nextcloud Client configuration file. Incorrect settings can produce unintended results.

#+end_quote

Some interesting values that can be set on the configuration file are:

_
[Nextcloud] section
_
Variable	Default	Meaning
_
remotePollInterval	30000	Specifies the poll time for the remote repository in milliseconds.
_
forceSyncInterval	7200000	The duration of no activity after which a synchronization run shall be triggered automatically.
_
fullLocalDiscoveryInterval	3600000	The interval after which the next synchronization will perform a full local discovery.
_
notificationRefreshInterval	300000	Specifies the default interval of checking for new server notifications in milliseconds.
_

_
[General] section
_
Variable	Default	Meaning
_
chunkSize	10000000 (10 MB)	Specifies the chunk size of uploaded files in bytes. The client will dynamically adjust this size within the maximum and minimum bounds (see below).
_
maxChunkSize	100000000 (100 MB)	Specifies the maximum chunk size of uploaded files in bytes.
_
minChunkSize	1000000 (1 MB)	Specifies the minimum chunk size of uploaded files in bytes.
_
targetChunkUploadDuration	6000 (1 minute)	Target duration in milliseconds for chunk uploads. The client adjusts the chunk size until each chunk upload takes approximately this long. Set to 0 to disable dynamic chunk sizing.
_
promptDeleteAllFiles	true	If a UI prompt should ask for confirmation if it was detected that all files and folders were deleted.
_
timeout	300	The timeout for network connections in seconds.
_
moveToTrash	false	If non-locally deleted files should be moved to trash instead of deleting them completely. This option only works on linux
_
showExperimentalOptions	false	Whether to show experimental options that are still undergoing testing in the user interface. Turning this on does not enable experimental behavior on its own. It does enable user inferface options that can be used to opt in to experimental features.
_
showMainDialogAsNormalWindow	false	Whether the main dialog should be shown as a normal window even if tray icons are available.
_

_
[Proxy] section
_
Variable	Default	Meaning
_
host	127.0.0.1	The address of the proxy server.
_
port	8080	The port were the proxy is listening.
_
type	2	0 for System Proxy.
_
1 for SOCKS5 Proxy.
_
2 for No Proxy.
_
3 for HTTP(S) Proxy.
_

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

nextcloudcmd(1)

The Nextcloud developers

2013-2021, The Nextcloud developers