Environment Variables

Introduction

The behavior of the Desktop App can be controlled using environment variables.

The values of the environment variables override those in the configuration file.
Most environment variables only exist for debugging or testing purposes. They are not officially supported and may change from one version to the next. If you find yourself relying on a setting that is only available through an environment variable, please file a bug report.

Available Environment Variables

Setting Default Description

OWNCLOUD_NO_TUS

Set to any value to disable uploads using the tus protocol

OWNCLOUD_TIMEOUT

300

The timeout for network connections in seconds.

OWNCLOUD_CRITICAL_FREE_SPACE_BYTES

50*1000*1000 bytes

The minimum disk space needed for operation. A fatal error is raised if less free space is available.

OWNCLOUD_FREE_SPACE_BYTES

250*1000*1000 bytes

Downloads that would reduce the free space below this value are skipped. More information available under the "Low Disk Space" section.

OWNCLOUD_MAX_PARALLEL

6

Maximum number of parallel jobs.

OWNCLOUD_BLACKLIST_TIME_MIN

25

Minimum timeout, in seconds, for blacklisted files.

OWNCLOUD_BLACKLIST_TIME_MAX

24*60*60
(or one day)

Maximum timeout, in seconds, for blacklisted files.

OWNCLOUD_HTTP2_ENABLED

depends on Qt version

Force-enable ("1") or force-disable ("0") HTTP2 support. Note that HTTP2 use also depends on whether the server supports it.

OWNCLOUD_SQLITE_JOURNAL_MODE

depends on filesystem

Set a specific sqlite journal mode.

OWNCLOUD_SQLITE_LOCKING_MODE

EXCLUSIVE

Set a specific sqlite locking mode.

OWNCLOUD_SQLITE_TEMP_STORE

unset

Set the given temp_store on the sqlite database.

OWNCLOUD_DISABLE_CHECKSUM_UPLOAD

unset

Set to disable computing checksums for uploaded files.

OWNCLOUD_CONTENT_CHECKSUM_TYPE

SHA1

Select the file checksumming algorithm. "Adler32", "MD5", "SHA1", "SHA256", "SHA3-256" are valid, but not all have server support.

OWNCLOUD_UPLOAD_CONFLICT_FILES

unset

Set to "1" to enable uploading conflict files to the server.

OWNCLOUD_OVERRIDE_SERVER_URL

unset

Set to override a previously configured/branded server URL

OCC_UPDATE_URL

unset

This value can be set in the environment of the client to let the client choose a different update URL for testing purposes.

QT_LOGGING_RULES

unset

This value can be used to control the log content, see examples at Control Log Content and Controlling Messages.