nextcloud-desktop/doc/conffile.rst
Felix Weilbach efaccbd6fd Show main dialog as normal window if tray icons not available
Fixes #3307

Signed-off-by: Felix Weilbach <felix.weilbach@nextcloud.com>
2021-07-12 14:10:26 +00:00

10 KiB

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

On Linux distributions:

$HOME/.config/Nextcloud/nextcloud.cfg

On Microsoft Windows systems:

%APPDATA%\Nextcloud\nextcloud.cfg

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

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

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