Configuration File

Introduction

The Desktop App uses a configuration file. It has several sections for particular settings. You will find more sections in the configuration file than described here. Do not change any of those settings except support advises you to do so.

Location of the Configuration File

The location of the configuration file depends on the operating system used. You can locate this configuration file as follows:

System Location

Microsoft Windows

%APPDATA%\ownCloud\ownCloud.cfg

macOS

$HOME/Library/Preferences/ownCloud/ownCloud.cfg

Linux

$HOME/.config/ownCloud/ownCloud.cfg

The configuration file contains settings using the Microsoft Windows .ini file format. Some settings can be defined using the ownCloud Desktop App configuration dialog.

Use caution when making changes to the ownCloud Desktop App configuration file. Incorrect settings can produce unintended results.

Section [ownCloud]

See the Clarification of Terms Used for an in-depth explanation. Note that the default values are always set and used unless you change them.

Variable Default Meaning

remotePollInterval

30000
(30s)

The interval in milliseconds after the last sync the Desktop app polls the server for changes. If not set explicitly via the Desktop app, the Desktop app queries the server if a server-side default is present.

forceSyncInterval

7200000
(2h)

The interval in milliseconds after which a synchronization is triggered automatically if no regular synchronization activity took place. This enforcement ensures that there is a mandatory synchronization independent of the server’s polling response.

fullLocalDiscoveryInterval

3600000
(1h)

The interval in milliseconds after which the Desktop app will perform a full local discovery. Any changes found trigger a synchronization.

notificationRefreshInterval

300000
(5min)

The interval in milliseconds in which the Desktop app checks the server for new notifications.

Section [General]

Variable Default Meaning

chunkSize

10000000
(or 10 MB)

Specifies the initial chunk size of uploaded files in bytes. The Desktop App will dynamically adjust this size within the maximum and minimum bounds (see below).

promptDeleteAllFiles

true

If a UI prompt should ask for confirmation if it was detected that all files and folders were deleted.

crashReporter

true

Whether to show the crash reporter when a crash occurs.

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

Section [Proxy]

Variable Default Meaning

host

127.0.0.1

The address of the proxy server.

port

8080

The port where the proxy is listening.

type

2

* 0 for System Proxy
* 1 for SOCKS5 Proxy
* 2 for No Proxy
* 3 for HTTP(S) Proxy