Environment Variable Types

The following table describes the allowed values for an environment variable based on it’s type. If not stated otherwise, no quotes around values are needed.


Type Description & Examples

bool

A boolean value defined either by true or false.
OCIS_LOG_PRETTY=false

string

In general, only one allowed value.

  • Any allowed string like a path or name:
    OCIS_REVA_GATEWAY=com.owncloud.api.gateway

  • If predefined by a list of possible values - even from external sources, the exact value like:
    OCIS_LOG_LEVEL=error

  • If a value might contain blanks or special characters like with templates, embed the value in quotes:
    FRONTEND_OCS_ADDITIONAL_INFO_ATTRIBUTE='{{.Mail}}'
    STORAGE_USERS_OCIS_GENERAL_SPACE_ALIAS_TEMPLATE=
          '{{.SpaceType}}/{{.SpaceName | replace " " "-" | lower}}'

If a string contains commas, it is still treated as a single string and not as an array containing multiple strings like:
OCIS_LDAP_GROUP_BASE_DN=ou=groups,o=libregraph-idm
Some values defined as string are not defined as int on purpose to distinguish between 0 (zero) and ''(empty). For an example see GRAPH_SPACES_DEFAULT_QUOTA.

[]string

An array with multiple values allowed. The list is comma separated ONLY, no blanks or brackets of any kind:

  • FRONTEND_CHECKSUMS_SUPPORTED_TYPES=sha1,md5,adler32

  • The complete array can be put into quotes like:
    THUMBNAILS_RESOLUTIONS='16x16,32x32,64x64,128x128'

  • Though possible, avoid putting values in quotes as this can easily cause escaping issues:
    OCIS_CORS_ALLOW_HEADERS="\'Authorization\',\'Origin\',\'Content-Type\'"

int

An integer value with no other characters than numbers.
See int for the value range. Empty values default to 0 (zero):
WEB_CACHE_TTL=604800

uint

An unsigned integer value with no other characters than numbers.
See uint for the value range. Empty values default to 0 (zero):
SEARCH_CONTENT_EXTRACTION_SIZE_LIMIT=20971520

int64

A 64-bit integer value with no other characters than numbers.
See int64 for the value range. Empty values default to 0 (zero):
USERS_OWNCLOUDSQL_NOBODY=90

Duration

The duration can be set as a number followed by a time unit identifier like ms, s, m or h. Note that no other identifiers are allowed. Durations can be combined by multiple numbers and their identifiers.
Empty values default to 0 (zero):
OCIS_PERSISTENT_STORE_TTL=0s
OCIS_CACHE_TTL=336h0m0s