added parameter default values

based on a source code analysis (looking for getSystemValue() function) I added the default values of the prameters

Update config.sample.php

replaced three backticks by two.

applied various fixes

- removed default value for 'objectstore' because it has not default value.
- removed default value for 'tempdirectory' because it is unset.
- changed default value for 'theme' to "Defaults to the theming app which is shipped since Nextcloud 9"
- fixed typo in default value of 'minimum.supported.desktop.version', after double-checking the version
  number in /apps/dav/lib/Connector/Sabre/BlockLegacyClientPlugin.php:71.

Signed-off-by: Juergen Edner <juergen@eisfair.org>
This commit is contained in:
j-ed 2017-01-16 15:25:02 +01:00 committed by Morris Jobke
parent 4009d3db03
commit cd84cba32b
No known key found for this signature in database
GPG Key ID: 9CE5ED29E7FCD38A
1 changed files with 192 additions and 32 deletions

View File

@ -74,8 +74,10 @@ $CONFIG = array(
/** /**
* Where user files are stored; this defaults to ``data/`` in the Nextcloud * Where user files are stored. The SQLite database is also stored here, when
* directory. The SQLite database is also stored here, when you use SQLite. * you use SQLite.
*
* Default to ``data/`` in the Nextcloud directory.
*/ */
'datadirectory' => '/var/www/nextcloud/data', 'datadirectory' => '/var/www/nextcloud/data',
@ -93,7 +95,8 @@ $CONFIG = array(
* - sqlite (SQLite3) * - sqlite (SQLite3)
* - mysql (MySQL/MariaDB) * - mysql (MySQL/MariaDB)
* - pgsql (PostgreSQL) * - pgsql (PostgreSQL)
* - oci (Oracle) *
* Defaults to ``sqlite``
*/ */
'dbtype' => 'sqlite', 'dbtype' => 'sqlite',
@ -126,6 +129,8 @@ $CONFIG = array(
/** /**
* Prefix for the Nextcloud tables in the database. * Prefix for the Nextcloud tables in the database.
*
* Default to ``oc_``
*/ */
'dbtableprefix' => '', 'dbtableprefix' => '',
@ -134,6 +139,8 @@ $CONFIG = array(
* Indicates whether the Nextcloud instance was installed successfully; ``true`` * Indicates whether the Nextcloud instance was installed successfully; ``true``
* indicates a successful installation, and ``false`` indicates an unsuccessful * indicates a successful installation, and ``false`` indicates an unsuccessful
* installation. * installation.
*
* Defaults to ``false``
*/ */
'installed' => false, 'installed' => false,
@ -151,6 +158,8 @@ $CONFIG = array(
* French. It overrides automatic language detection on public pages like login * French. It overrides automatic language detection on public pages like login
* or shared items. User's language preferences configured under "personal -> * or shared items. User's language preferences configured under "personal ->
* language" override this setting after they have logged in. * language" override this setting after they have logged in.
*
* Defaults to ``en``
*/ */
'default_language' => 'en', 'default_language' => 'en',
@ -160,6 +169,8 @@ $CONFIG = array(
* gallery. You can use a comma-separated list of app names, so if the first * gallery. You can use a comma-separated list of app names, so if the first
* app is not enabled for a user then Nextcloud will try the second one, and so * app is not enabled for a user then Nextcloud will try the second one, and so
* on. If no enabled apps are found it defaults to the Files app. * on. If no enabled apps are found it defaults to the Files app.
*
* Defaults to ``files``
*/ */
'defaultapp' => 'files', 'defaultapp' => 'files',
@ -173,6 +184,8 @@ $CONFIG = array(
* ``true`` enables avatars, or user profile photos. These appear on the User * ``true`` enables avatars, or user profile photos. These appear on the User
* page, on user's Personal pages and are used by some apps (contacts, mail, * page, on user's Personal pages and are used by some apps (contacts, mail,
* etc). ``false`` disables them. * etc). ``false`` disables them.
*
* Defaults to ``true``
*/ */
'enable_avatars' => true, 'enable_avatars' => true,
@ -183,21 +196,25 @@ $CONFIG = array(
'allow_user_to_change_display_name' => true, 'allow_user_to_change_display_name' => true,
/** /**
* Lifetime of the remember login cookie, which is set when the user clicks the * Lifetime of the remember login cookie, which is set when the user clicks
* ``remember`` checkbox on the login screen. The default is 15 days, expressed * the ``remember`` checkbox on the login screen.
* in seconds. *
* Defaults to ``60*60*24*15`` seconds (15 days)
*/ */
'remember_login_cookie_lifetime' => 60*60*24*15, 'remember_login_cookie_lifetime' => 60*60*24*15,
/** /**
* The lifetime of a session after inactivity; the default is 24 hours, * The lifetime of a session after inactivity.
* expressed in seconds. *
* Defaults to ``60*60*24`` seconds (24 hours)
*/ */
'session_lifetime' => 60 * 60 * 24, 'session_lifetime' => 60 * 60 * 24,
/** /**
* Enable or disable session keep-alive when a user is logged in to the Web UI. * Enable or disable session keep-alive when a user is logged in to the Web UI.
* Enabling this sends a "heartbeat" to the server to keep it from timing out. * Enabling this sends a "heartbeat" to the server to keep it from timing out.
*
* Defaults to ``true``
*/ */
'session_keepalive' => true, 'session_keepalive' => true,
@ -205,6 +222,8 @@ $CONFIG = array(
* Enforce token authentication for clients, which blocks requests using the user * Enforce token authentication for clients, which blocks requests using the user
* password for enhanced security. Users need to generate tokens in personal settings * password for enhanced security. Users need to generate tokens in personal settings
* which can be used as passwords on their clients. * which can be used as passwords on their clients.
*
* Defaults to ``false``
*/ */
'token_auth_enforced' => false, 'token_auth_enforced' => false,
@ -212,6 +231,8 @@ $CONFIG = array(
* Whether the bruteforce protection shipped with Nextcloud should be enabled or not. * Whether the bruteforce protection shipped with Nextcloud should be enabled or not.
* *
* Disabling this is discouraged for security reasons. * Disabling this is discouraged for security reasons.
*
* Defaults to ``true``
*/ */
'auth.bruteforce.protection.enabled' => true, 'auth.bruteforce.protection.enabled' => true,
@ -219,6 +240,8 @@ $CONFIG = array(
* The directory where the skeleton files are located. These files will be * The directory where the skeleton files are located. These files will be
* copied to the data directory of new users. Leave empty to not copy any * copied to the data directory of new users. Leave empty to not copy any
* skeleton files. * skeleton files.
*
* Defaults to ``core/skeleton`` in the Nextcloud directory.
*/ */
'skeletondirectory' => '/path/to/nextcloud/core/skeleton', 'skeletondirectory' => '/path/to/nextcloud/core/skeleton',
@ -259,11 +282,15 @@ $CONFIG = array(
/** /**
* FROM address that overrides the built-in ``sharing-noreply`` and * FROM address that overrides the built-in ``sharing-noreply`` and
* ``lostpassword-noreply`` FROM addresses. * ``lostpassword-noreply`` FROM addresses.
*
* Defaults to different from addresses depending on the feature.
*/ */
'mail_from_address' => 'nextcloud', 'mail_from_address' => 'nextcloud',
/** /**
* Enable SMTP class debugging. * Enable SMTP class debugging.
*
* Defaults to ``false``
*/ */
'mail_smtpdebug' => false, 'mail_smtpdebug' => false,
@ -282,6 +309,8 @@ $CONFIG = array(
* *
* For ``qmail`` the binary is /var/qmail/bin/sendmail, and it must be installed * For ``qmail`` the binary is /var/qmail/bin/sendmail, and it must be installed
* on your Unix system. * on your Unix system.
*
* Defaults to ``sendmail``
*/ */
'mail_smtpmode' => 'sendmail', 'mail_smtpmode' => 'sendmail',
@ -290,11 +319,15 @@ $CONFIG = array(
* server host. This may contain multiple hosts separated by a semi-colon. If * server host. This may contain multiple hosts separated by a semi-colon. If
* you need to specify the port number append it to the IP address separated by * you need to specify the port number append it to the IP address separated by
* a colon, like this: ``127.0.0.1:24``. * a colon, like this: ``127.0.0.1:24``.
*
* Defaults to ``127.0.0.1``
*/ */
'mail_smtphost' => '127.0.0.1', 'mail_smtphost' => '127.0.0.1',
/** /**
* This depends on ``mail_smtpmode``. Specify the port for sending mail. * This depends on ``mail_smtpmode``. Specify the port for sending mail.
*
* Defaults to ``25``
*/ */
'mail_smtpport' => 25, 'mail_smtpport' => 25,
@ -302,36 +335,48 @@ $CONFIG = array(
* This depends on ``mail_smtpmode``. This sets the SMTP server timeout, in * This depends on ``mail_smtpmode``. This sets the SMTP server timeout, in
* seconds. You may need to increase this if you are running an anti-malware or * seconds. You may need to increase this if you are running an anti-malware or
* spam scanner. * spam scanner.
*
* Defaults to ``10`` seconds
*/ */
'mail_smtptimeout' => 10, 'mail_smtptimeout' => 10,
/** /**
* This depends on ``mail_smtpmode``. Specify when you are using ``ssl`` or * This depends on ``mail_smtpmode``. Specify when you are using ``ssl`` or
* ``tls``, or leave empty for no encryption. * ``tls``, or leave empty for no encryption.
*
* Defaults to ``''`` (empty string)
*/ */
'mail_smtpsecure' => '', 'mail_smtpsecure' => '',
/** /**
* This depends on ``mail_smtpmode``. Change this to ``true`` if your mail * This depends on ``mail_smtpmode``. Change this to ``true`` if your mail
* server requires authentication. * server requires authentication.
*
* Defaults to ``false``
*/ */
'mail_smtpauth' => false, 'mail_smtpauth' => false,
/** /**
* This depends on ``mail_smtpmode``. If SMTP authentication is required, choose * This depends on ``mail_smtpmode``. If SMTP authentication is required, choose
* the authentication type as ``LOGIN`` (default) or ``PLAIN``. * the authentication type as ``LOGIN`` or ``PLAIN``.
*
* Defaults to ``LOGIN``
*/ */
'mail_smtpauthtype' => 'LOGIN', 'mail_smtpauthtype' => 'LOGIN',
/** /**
* This depends on ``mail_smtpauth``. Specify the username for authenticating to * This depends on ``mail_smtpauth``. Specify the username for authenticating to
* the SMTP server. * the SMTP server.
*
* Defaults to ``''`` (empty string)
*/ */
'mail_smtpname' => '', 'mail_smtpname' => '',
/** /**
* This depends on ``mail_smtpauth``. Specify the password for authenticating to * This depends on ``mail_smtpauth``. Specify the password for authenticating to
* the SMTP server. * the SMTP server.
*
* Default to ``''`` (empty string)
*/ */
'mail_smtppassword' => '', 'mail_smtppassword' => '',
@ -371,6 +416,8 @@ $CONFIG = array(
* expression for the remote IP address. For example, defining a range of IP * expression for the remote IP address. For example, defining a range of IP
* addresses starting with ``10.0.0.`` and ending with 1 to 3: * addresses starting with ``10.0.0.`` and ending with 1 to 3:
* ``^10\.0\.0\.[1-3]$`` * ``^10\.0\.0\.[1-3]$``
*
* Defaults to ``''`` (empty string)
*/ */
'overwritecondaddr' => '', 'overwritecondaddr' => '',
@ -379,6 +426,8 @@ $CONFIG = array(
* are generated within Nextcloud using any kind of command line tools (cron or * are generated within Nextcloud using any kind of command line tools (cron or
* occ). The value should contain the full base URL: * occ). The value should contain the full base URL:
* ``https://www.example.com/nextcloud`` * ``https://www.example.com/nextcloud``
*
* Defaults to ``''`` (empty string)
*/ */
'overwrite.cli.url' => '', 'overwrite.cli.url' => '',
@ -404,6 +453,8 @@ $CONFIG = array(
* *
* - `mod_rewrite` is installed * - `mod_rewrite` is installed
* - `mod_env` is installed * - `mod_env` is installed
*
* Defaults to ``''`` (empty string)
*/ */
'htaccess.RewriteBase' => '/', 'htaccess.RewriteBase' => '/',
@ -420,12 +471,16 @@ $CONFIG = array(
/** /**
* The URL of your proxy server, for example ``proxy.example.com:8081``. * The URL of your proxy server, for example ``proxy.example.com:8081``.
*
* Defaults to ``''`` (empty string)
*/ */
'proxy' => '', 'proxy' => '',
/** /**
* The optional authentication for the proxy to use to connect to the internet. * The optional authentication for the proxy to use to connect to the internet.
* The format is: ``username:password``. * The format is: ``username:password``.
*
* Defaults to ``''`` (empty string)
*/ */
'proxyuserpwd' => '', 'proxyuserpwd' => '',
@ -466,6 +521,8 @@ $CONFIG = array(
* delete when exceeds D2 days * delete when exceeds D2 days
* * ``disabled`` * * ``disabled``
* trash bin auto clean disabled, files and folders will be kept forever * trash bin auto clean disabled, files and folders will be kept forever
*
* Defaults to ``auto``
*/ */
'trashbin_retention_obligation' => 'auto', 'trashbin_retention_obligation' => 'auto',
@ -505,6 +562,8 @@ $CONFIG = array(
* keep versions for at least D1 days and delete when exceeds D2 days * keep versions for at least D1 days and delete when exceeds D2 days
* * ``disabled`` * * ``disabled``
* versions auto clean disabled, versions will be kept forever * versions auto clean disabled, versions will be kept forever
*
* Defaults to ``auto``
*/ */
'versions_retention_obligation' => 'auto', 'versions_retention_obligation' => 'auto',
@ -519,17 +578,23 @@ $CONFIG = array(
* Checks an app before install whether it uses private APIs instead of the * Checks an app before install whether it uses private APIs instead of the
* proper public APIs. If this is set to true it will only allow to install or * proper public APIs. If this is set to true it will only allow to install or
* enable apps that pass this check. * enable apps that pass this check.
*
* Defaults to ``false``
*/ */
'appcodechecker' => true, 'appcodechecker' => true,
/** /**
* Check if Nextcloud is up-to-date and shows a notification if a new version is * Check if Nextcloud is up-to-date and shows a notification if a new version is
* available. * available.
*
* Defaults to ``true``
*/ */
'updatechecker' => true, 'updatechecker' => true,
/** /**
* URL that Nextcloud should use to look for updates * URL that Nextcloud should use to look for updates
*
* Defaults to ``https://updates.nextcloud.com/updater_server/``
*/ */
'updater.server.url' => 'https://updates.nextcloud.com/updater_server/', 'updater.server.url' => 'https://updates.nextcloud.com/updater_server/',
@ -546,6 +611,8 @@ $CONFIG = array(
/** /**
* Is Nextcloud connected to the Internet or running in a closed network? * Is Nextcloud connected to the Internet or running in a closed network?
*
* Defaults to ``true``
*/ */
'has_internet_connection' => true, 'has_internet_connection' => true,
@ -559,6 +626,8 @@ $CONFIG = array(
* Allows Nextcloud to verify a working .well-known URL redirects. This is done * Allows Nextcloud to verify a working .well-known URL redirects. This is done
* by attempting to make a request from JS to * by attempting to make a request from JS to
* https://your-domain.com/.well-known/caldav/ * https://your-domain.com/.well-known/caldav/
*
* Defaults to ``true``
*/ */
'check_for_working_wellknown_setup' => true, 'check_for_working_wellknown_setup' => true,
@ -568,6 +637,8 @@ $CONFIG = array(
* If it is not, then any options controlled by ``.htaccess``, such as large * If it is not, then any options controlled by ``.htaccess``, such as large
* file uploads, will not work. It also runs checks on the ``data/`` directory, * file uploads, will not work. It also runs checks on the ``data/`` directory,
* which verifies that it can't be accessed directly through the Web server. * which verifies that it can't be accessed directly through the Web server.
*
* Defaults to ``true``
*/ */
'check_for_working_htaccess' => true, 'check_for_working_htaccess' => true,
@ -578,6 +649,8 @@ $CONFIG = array(
* all options via the Web interface. Furthermore, when updating Nextcloud * all options via the Web interface. Furthermore, when updating Nextcloud
* it is required to make the configuration file writable again for the update * it is required to make the configuration file writable again for the update
* process. * process.
*
* Defaults to ``false``
*/ */
'config_is_read_only' => false, 'config_is_read_only' => false,
@ -591,11 +664,14 @@ $CONFIG = array(
* If syslogging is desired, set this parameter to ``syslog``. * If syslogging is desired, set this parameter to ``syslog``.
* Setting this parameter to ``errorlog`` will use the PHP error_log function * Setting this parameter to ``errorlog`` will use the PHP error_log function
* for logging. * for logging.
*
* Defaults to ``file``
*/ */
'log_type' => 'file', 'log_type' => 'file',
/** /**
* Log file path for the Nextcloud logging type. * Log file path for the Nextcloud logging type.
*
* Defaults to ``[datadirectory]/nextcloud.log`` * Defaults to ``[datadirectory]/nextcloud.log``
*/ */
'logfile' => '/var/log/nextcloud.log', 'logfile' => '/var/log/nextcloud.log',
@ -603,6 +679,8 @@ $CONFIG = array(
/** /**
* Loglevel to start logging at. Valid values are: 0 = Debug, 1 = Info, 2 = * Loglevel to start logging at. Valid values are: 0 = Debug, 1 = Info, 2 =
* Warning, 3 = Error, and 4 = Fatal. The default value is Warning. * Warning, 3 = Error, and 4 = Fatal. The default value is Warning.
*
* Defaults to ``2``
*/ */
'loglevel' => 2, 'loglevel' => 2,
@ -637,12 +715,16 @@ $CONFIG = array(
/** /**
* This uses PHP.date formatting; see http://php.net/manual/en/function.date.php * This uses PHP.date formatting; see http://php.net/manual/en/function.date.php
*
* Defaults to ``Y-m-d\TH:i:sO`` (ISO8601)
*/ */
'logdateformat' => 'F d, Y H:i:s', 'logdateformat' => 'F d, Y H:i:s',
/** /**
* The default timezone for logfiles is UTC. You may change this; see * The timezone for logfiles. You may change this; see
* http://php.net/manual/en/timezones.php * http://php.net/manual/en/timezones.php
*
* Defaults to ``UTC``
*/ */
'logtimezone' => 'Europe/Berlin', 'logtimezone' => 'Europe/Berlin',
@ -654,6 +736,8 @@ $CONFIG = array(
/** /**
* Log successful cron runs. * Log successful cron runs.
*
* Defaults to ``true``
*/ */
'cron_log' => true, 'cron_log' => true,
@ -663,6 +747,8 @@ $CONFIG = array(
* = 100 * 1024 * 1024 bytes). A new logfile is created with a new name when the * = 100 * 1024 * 1024 bytes). A new logfile is created with a new name when the
* old logfile reaches your limit. If a rotated log file is already present, it * old logfile reaches your limit. If a rotated log file is already present, it
* will be overwritten. * will be overwritten.
*
* Defaults to ``0`` (no rotation)
*/ */
'log_rotate_size' => false, 'log_rotate_size' => false,
@ -676,6 +762,11 @@ $CONFIG = array(
/** /**
* This section is for configuring the download links for Nextcloud clients, as * This section is for configuring the download links for Nextcloud clients, as
* seen in the first-run wizard and on Personal pages. * seen in the first-run wizard and on Personal pages.
*
* Defaults to
* * Desktop client: ``https://nextcloud.com/install/#install-clients``
* * Android client: ``https://play.google.com/store/apps/details?id=com.nextcloud.client``
* * iOS client : ``https://itunes.apple.com/us/app/nextcloud/id1125420102?mt=8``
*/ */
'customclient_desktop' => 'customclient_desktop' =>
'https://nextcloud.com/install/#install-clients', 'https://nextcloud.com/install/#install-clients',
@ -692,6 +783,8 @@ $CONFIG = array(
/** /**
* When enabled, admins may install apps from the Nextcloud app store. * When enabled, admins may install apps from the Nextcloud app store.
*
* Defaults to ``true``
*/ */
'appstoreenabled' => true, 'appstoreenabled' => true,
@ -733,16 +826,22 @@ $CONFIG = array(
* *
* Valid values are ``true``, to enable previews, or * Valid values are ``true``, to enable previews, or
* ``false``, to disable previews * ``false``, to disable previews
*
* Defaults to ``true``
*/ */
'enable_previews' => true, 'enable_previews' => true,
/** /**
* The maximum width, in pixels, of a preview. A value of ``null`` means there * The maximum width, in pixels, of a preview. A value of ``null`` means there
* is no limit. * is no limit.
*
* Defaults to ``2048``
*/ */
'preview_max_x' => 2048, 'preview_max_x' => 2048,
/** /**
* The maximum height, in pixels, of a preview. A value of ``null`` means there * The maximum height, in pixels, of a preview. A value of ``null`` means there
* is no limit. * is no limit.
*
* Defaults to ``2048``
*/ */
'preview_max_y' => 2048, 'preview_max_y' => 2048,
/** /**
@ -750,26 +849,30 @@ $CONFIG = array(
* preview system generates blurry previews, you might want to consider setting * preview system generates blurry previews, you might want to consider setting
* a maximum scale factor. By default, pictures are upscaled to 10 times the * a maximum scale factor. By default, pictures are upscaled to 10 times the
* original size. A value of ``1`` or ``null`` disables scaling. * original size. A value of ``1`` or ``null`` disables scaling.
*
* Defaults to ``2``
*/ */
'preview_max_scale_factor' => 10, 'preview_max_scale_factor' => 10,
/** /**
* max file size for generating image previews with imagegd (default behaviour) * max file size for generating image previews with imagegd (default behaviour)
* If the image is bigger, it'll try other preview generators, * If the image is bigger, it'll try other preview generators, but will most
* but will most likely show the default mimetype icon * likely show the default mimetype icon. Set to -1 for no limit.
* *
* Value represents the maximum filesize in megabytes * Defaults to ``50`` megabytes
* Default is 50
* Set to -1 for no limit
*/ */
'preview_max_filesize_image' => 50, 'preview_max_filesize_image' => 50,
/** /**
* custom path for LibreOffice/OpenOffice binary * custom path for LibreOffice/OpenOffice binary
*
* Defaults to ``''`` (empty string)
*/ */
'preview_libreoffice_path' => '/usr/bin/libreoffice', 'preview_libreoffice_path' => '/usr/bin/libreoffice',
/** /**
* Use this if LibreOffice/OpenOffice requires additional arguments. * Use this if LibreOffice/OpenOffice requires additional arguments.
*
* Defaults to ``''`` (empty string)
*/ */
'preview_office_cl_parameters' => 'preview_office_cl_parameters' =>
' --headless --nologo --nofirststartwizard --invisible --norestore '. ' --headless --nologo --nofirststartwizard --invisible --norestore '.
@ -778,17 +881,6 @@ $CONFIG = array(
/** /**
* Only register providers that have been explicitly enabled * Only register providers that have been explicitly enabled
* *
* The following providers are enabled by default:
*
* - OC\Preview\PNG
* - OC\Preview\JPEG
* - OC\Preview\GIF
* - OC\Preview\BMP
* - OC\Preview\XBitmap
* - OC\Preview\MarkDown
* - OC\Preview\MP3
* - OC\Preview\TXT
*
* The following providers are disabled by default due to performance or privacy * The following providers are disabled by default due to performance or privacy
* concerns: * concerns:
* *
@ -818,6 +910,17 @@ $CONFIG = array(
* - OC\Preview\MSOffice2007 * - OC\Preview\MSOffice2007
* - OC\Preview\OpenDocument * - OC\Preview\OpenDocument
* - OC\Preview\StarOffice * - OC\Preview\StarOffice
*
* Defaults to the following providers:
*
* - OC\Preview\BMP
* - OC\Preview\GIF
* - OC\Preview\JPEG
* - OC\Preview\MarkDown
* - OC\Preview\MP3
* - OC\Preview\PNG
* - OC\Preview\TXT
* - OC\Preview\XBitmap
*/ */
'enabledPreviewProviders' => array( 'enabledPreviewProviders' => array(
'OC\Preview\PNG', 'OC\Preview\PNG',
@ -841,6 +944,8 @@ $CONFIG = array(
* existence and marks them as ready to be cleaned up. The number is always * existence and marks them as ready to be cleaned up. The number is always
* minutes. Setting it to 0 disables the feature. * minutes. Setting it to 0 disables the feature.
* See command line (occ) methods ``ldap:show-remnants`` and ``user:delete`` * See command line (occ) methods ``ldap:show-remnants`` and ``user:delete``
*
* Defaults to ``51`` minutes
*/ */
'ldapUserCleanupInterval' => 51, 'ldapUserCleanupInterval' => 51,
@ -854,6 +959,8 @@ $CONFIG = array(
* Replaces the default Comments Manager Factory. This can be utilized if an * Replaces the default Comments Manager Factory. This can be utilized if an
* own or 3rdParty CommentsManager should be used that for instance uses the * own or 3rdParty CommentsManager should be used that for instance uses the
* filesystem instead of the database to keep the comments. * filesystem instead of the database to keep the comments.
*
* Defaults to ``\OC\Comments\ManagerFactory``
*/ */
'comments.managerFactory' => '\OC\Comments\ManagerFactory', 'comments.managerFactory' => '\OC\Comments\ManagerFactory',
@ -861,6 +968,8 @@ $CONFIG = array(
* Replaces the default System Tags Manager Factory. This can be utilized if an * Replaces the default System Tags Manager Factory. This can be utilized if an
* own or 3rdParty SystemTagsManager should be used that for instance uses the * own or 3rdParty SystemTagsManager should be used that for instance uses the
* filesystem instead of the database to keep the comments. * filesystem instead of the database to keep the comments.
*
* Defaults to ``\OC\SystemTag\ManagerFactory``
*/ */
'systemtags.managerFactory' => '\OC\SystemTag\ManagerFactory', 'systemtags.managerFactory' => '\OC\SystemTag\ManagerFactory',
@ -878,12 +987,16 @@ $CONFIG = array(
* doing some maintenance work, you need to set the value of the maintenance * doing some maintenance work, you need to set the value of the maintenance
* parameter to true. Please keep in mind that users who are already logged-in * parameter to true. Please keep in mind that users who are already logged-in
* are kicked out of Nextcloud instantly. * are kicked out of Nextcloud instantly.
*
* Defaults to ``false``
*/ */
'maintenance' => false, 'maintenance' => false,
/** /**
* When set to ``true``, the Nextcloud instance will be unavailable for all * When set to ``true``, the Nextcloud instance will be unavailable for all
* users who are not in the ``admin`` group. * users who are not in the ``admin`` group.
*
* Defaults to ``false``
*/ */
'singleuser' => false, 'singleuser' => false,
@ -894,6 +1007,8 @@ $CONFIG = array(
/** /**
* Extra SSL options to be used for configuration. * Extra SSL options to be used for configuration.
*
* Defaults to an empty array.
*/ */
'openssl' => array( 'openssl' => array(
'config' => '/absolute/location/of/openssl.cnf', 'config' => '/absolute/location/of/openssl.cnf',
@ -927,6 +1042,8 @@ $CONFIG = array(
* Memory caching backend for locally stored data * Memory caching backend for locally stored data
* *
* * Used for host-specific data, e.g. file paths * * Used for host-specific data, e.g. file paths
*
* Defaults to ``none``
*/ */
'memcache.local' => '\OC\Memcache\APCu', 'memcache.local' => '\OC\Memcache\APCu',
@ -935,6 +1052,8 @@ $CONFIG = array(
* *
* * Used for installation-specific data, e.g. database caching * * Used for installation-specific data, e.g. database caching
* * If unset, defaults to the value of memcache.local * * If unset, defaults to the value of memcache.local
*
* Defaults to ``none``
*/ */
'memcache.distributed' => '\OC\Memcache\Memcached', 'memcache.distributed' => '\OC\Memcache\Memcached',
@ -994,6 +1113,8 @@ $CONFIG = array(
* ``$user`` is the current user. When specified, the format will change to * ``$user`` is the current user. When specified, the format will change to
* ``$cache_path/$user`` where ``$cache_path`` is the configured cache directory * ``$cache_path/$user`` where ``$cache_path`` is the configured cache directory
* and ``$user`` is the user. * and ``$user`` is the user.
*
* Defaults to ``''`` (empty string)
*/ */
'cache_path' => '', 'cache_path' => '',
@ -1002,8 +1123,10 @@ $CONFIG = array(
* garbage collection (in seconds). Increase this value if users have * garbage collection (in seconds). Increase this value if users have
* issues uploading very large files via the Nextcloud Client as upload isn't * issues uploading very large files via the Nextcloud Client as upload isn't
* completed within one day. * completed within one day.
*
* Defaults to ``60*60*24`` (1 day)
*/ */
'cache_chunk_gc_ttl' => 86400, // 60*60*24 = 1 day 'cache_chunk_gc_ttl' => 60*60*24,
/** /**
* Using Object Store with Nextcloud * Using Object Store with Nextcloud
@ -1065,6 +1188,8 @@ $CONFIG = array(
* Replaces the default Share Provider Factory. This can be utilized if * Replaces the default Share Provider Factory. This can be utilized if
* own or 3rdParty Share Providers be used that for instance uses the * own or 3rdParty Share Providers be used that for instance uses the
* filesystem instead of the database to keep the share information. * filesystem instead of the database to keep the share information.
*
* Defaults to ``\OC\Share20\ProviderFactory``
*/ */
'sharing.managerFactory' => '\OC\Share20\ProviderFactory', 'sharing.managerFactory' => '\OC\Share20\ProviderFactory',
@ -1125,6 +1250,11 @@ $CONFIG = array(
* - mysql (MySQL) * - mysql (MySQL)
* - pgsql (PostgreSQL) * - pgsql (PostgreSQL)
* - oci (Oracle) * - oci (Oracle)
*
* Defaults to the following databases:
* - sqlite (SQLite3)
* - mysql (MySQL)
* - pgsql (PostgreSQL)
*/ */
'supportedDatabases' => array( 'supportedDatabases' => array(
'sqlite', 'sqlite',
@ -1153,17 +1283,23 @@ $CONFIG = array(
* Blacklist a specific file or files and disallow the upload of files * Blacklist a specific file or files and disallow the upload of files
* with this name. ``.htaccess`` is blocked by default. * with this name. ``.htaccess`` is blocked by default.
* WARNING: USE THIS ONLY IF YOU KNOW WHAT YOU ARE DOING. * WARNING: USE THIS ONLY IF YOU KNOW WHAT YOU ARE DOING.
*
* Defaults to ``array('.htaccess')``
*/ */
'blacklisted_files' => array('.htaccess'), 'blacklisted_files' => array('.htaccess'),
/** /**
* Define a default folder for shared files and folders other than root. * Define a default folder for shared files and folders other than root.
*
* Defaults to ``/``
*/ */
'share_folder' => '/', 'share_folder' => '/',
/** /**
* If you are applying a theme to Nextcloud, enter the name of the theme here. * If you are applying a theme to Nextcloud, enter the name of the theme here.
* The default location for themes is ``nextcloud/themes/``. * The default location for themes is ``nextcloud/themes/``.
*
* Defaults to the theming app which is shipped since Nextcloud 9
*/ */
'theme' => '', 'theme' => '',
@ -1182,12 +1318,16 @@ $CONFIG = array(
* When changing this, note that older unsupported versions of the Nextcloud desktop * When changing this, note that older unsupported versions of the Nextcloud desktop
* client may not function as expected, and could lead to permanent data loss for * client may not function as expected, and could lead to permanent data loss for
* clients or other unexpected results. * clients or other unexpected results.
*
* Defaults to ``2.0.0``
*/ */
'minimum.supported.desktop.version' => '2.0.0', 'minimum.supported.desktop.version' => '2.0.0',
/** /**
* EXPERIMENTAL: option whether to include external storage in quota * EXPERIMENTAL: option whether to include external storage in quota
* calculation, defaults to false. * calculation, defaults to false.
*
* Defaults to ``false``
*/ */
'quota_include_external_storage' => false, 'quota_include_external_storage' => false,
@ -1202,6 +1342,8 @@ $CONFIG = array(
* *
* 1 -> Check each file or folder at most once per request, recommended for * 1 -> Check each file or folder at most once per request, recommended for
* general use if outside changes might happen. * general use if outside changes might happen.
*
* Defaults to ``0``
*/ */
'filesystem_check_changes' => 0, 'filesystem_check_changes' => 0,
@ -1210,18 +1352,24 @@ $CONFIG = array(
* same storage as the upload target. Setting this to false will store the part * same storage as the upload target. Setting this to false will store the part
* files in the root of the users folder which might be required to work with certain * files in the root of the users folder which might be required to work with certain
* external storage setups that have limited rename capabilities. * external storage setups that have limited rename capabilities.
*
* Defaults to ``true``
*/ */
'part_file_in_storage' => true, 'part_file_in_storage' => true,
/** /**
* Where ``mount.json`` file should be stored, defaults to ``data/mount.json`` * Where ``mount.json`` file should be stored, defaults to ``data/mount.json``
* in the Nextcloud directory. * in the Nextcloud directory.
*
* Defaults to ``data/mount.json`` in the Nextcloud directory.
*/ */
'mount_file' => '/var/www/nextcloud/data/mount.json', 'mount_file' => '/var/www/nextcloud/data/mount.json',
/** /**
* When ``true``, prevent Nextcloud from changing the cache due to changes in * When ``true``, prevent Nextcloud from changing the cache due to changes in
* the filesystem for all storage. * the filesystem for all storage.
*
* Defaults to ``false``
*/ */
'filesystem_cache_readonly' => false, 'filesystem_cache_readonly' => false,
@ -1236,6 +1384,7 @@ $CONFIG = array(
* *
* If you configure these also consider setting `forwarded_for_headers` which * If you configure these also consider setting `forwarded_for_headers` which
* otherwise defaults to `HTTP_X_FORWARDED_FOR` (the `X-Forwarded-For` header). * otherwise defaults to `HTTP_X_FORWARDED_FOR` (the `X-Forwarded-For` header).
* Defaults to an empty array.
*/ */
'trusted_proxies' => array('203.0.113.45', '198.51.100.128'), 'trusted_proxies' => array('203.0.113.45', '198.51.100.128'),
@ -1247,7 +1396,7 @@ $CONFIG = array(
* If set incorrectly, a client can spoof their IP address as visible to * If set incorrectly, a client can spoof their IP address as visible to
* Nextcloud, bypassing access controls and making logs useless! * Nextcloud, bypassing access controls and making logs useless!
* *
* Defaults to 'HTTP_X_FORWARED_FOR' if unset * Defaults to ``'HTTP_X_FORWARED_FOR'``
*/ */
'forwarded_for_headers' => array('HTTP_X_FORWARDED', 'HTTP_FORWARDED_FOR'), 'forwarded_for_headers' => array('HTTP_X_FORWARDED', 'HTTP_FORWARDED_FOR'),
@ -1255,8 +1404,10 @@ $CONFIG = array(
* max file size for animating gifs on public-sharing-site. * max file size for animating gifs on public-sharing-site.
* If the gif is bigger, it'll show a static preview * If the gif is bigger, it'll show a static preview
* *
* Value represents the maximum filesize in megabytes. Default is ``10``. Set to * Value represents the maximum filesize in megabytes. Set to ``-1`` for
* ``-1`` for no limit. * no limit.
*
* Defaults to ``10`` megabytes
*/ */
'max_filesize_animated_gifs_public_sharing' => 10, 'max_filesize_animated_gifs_public_sharing' => 10,
@ -1270,6 +1421,8 @@ $CONFIG = array(
* be caused by concurrent operations. Mainly relevant for * be caused by concurrent operations. Mainly relevant for
* very large installations with many users working with * very large installations with many users working with
* shared files. * shared files.
*
* Defaults to ``true``
*/ */
'filelocking.enabled' => true, 'filelocking.enabled' => true,
@ -1278,15 +1431,18 @@ $CONFIG = array(
* *
* Any lock older than this will be automatically cleaned up. * Any lock older than this will be automatically cleaned up.
* *
* If not set this defaults to either 1 hour or the php max_execution_time, whichever is higher. * Defaults to ``60*60`` seconds (1 hour) or the php
* max_execution_time, whichever is higher.
*/ */
'filelocking.ttl' => 3600, 'filelocking.ttl' => 60*60,
/** /**
* Memory caching backend for file locking * Memory caching backend for file locking
* *
* Because most memcache backends can clean values without warning using redis * Because most memcache backends can clean values without warning using redis
* is highly recommended to *avoid data loss*. * is highly recommended to *avoid data loss*.
*
* Defaults to ``none``
*/ */
'memcache.locking' => '\\OC\\Memcache\\Redis', 'memcache.locking' => '\\OC\\Memcache\\Redis',
@ -1300,6 +1456,8 @@ $CONFIG = array(
* *
* Only enable this for local development and not in production environments * Only enable this for local development and not in production environments
* This will disable the minifier and outputs some additional debug information * This will disable the minifier and outputs some additional debug information
*
* Defaults to ``false``
*/ */
'debug' => false, 'debug' => false,
@ -1313,6 +1471,8 @@ $CONFIG = array(
* *
* Updating/Deleting this value can make connected clients stall until * Updating/Deleting this value can make connected clients stall until
* the user has resolved conflicts. * the user has resolved conflicts.
*
* Defaults to ``''`` (empty string)
*/ */
'data-fingerprint' => '', 'data-fingerprint' => '',