Skip to content

Commit 372ae2d

Browse files
docs(config): clarify default CA bundle override
Document that default_certificates_bundle_path overrides Nextcloud's shipped CA bundle used to verify TLS certificates. Clarify that the configured value must reference a readable local CA bundle, is used directly when no certificates are uploaded, and is included when Nextcloud generates the bundle containing uploaded certificates. Simplify the default value and use the Debian-derived system CA bundle path as the configuration-sample example for further clarity. Signed-off-by: Josh <josh.t.richards@gmail.com>
1 parent bc6d031 commit 372ae2d

1 file changed

Lines changed: 10 additions & 4 deletions

File tree

config/config.sample.php

Lines changed: 10 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -2980,13 +2980,19 @@
29802980
'enable_lazy_objects' => true,
29812981

29822982
/**
2983-
* Change the default certificates bundle used for trusting certificates.
2983+
* Override the default CA bundle used by Nextcloud to verify TLS certificates.
29842984
*
2985-
* Nextcloud ships its own up-to-date certificates bundle, but in certain cases admins may wish to specify a different bundle, for example the one shipped by their distro.
2985+
* By default, Nextcloud uses its shipped CA bundle. You may instead configure a
2986+
* bundle provided by your operating-system distribution or organization, such as
2987+
* ``/etc/ssl/certs/ca-certificates.crt`` on Debian-derived systems.
29862988
*
2987-
* Defaults to `\OC::$SERVERROOT . '/resources/config/ca-bundle.crt'`.
2989+
* The value must be the path to a readable local CA-bundle file. Nextcloud uses
2990+
* this bundle directly when no certificates have been uploaded, and includes it
2991+
* when generating a bundle containing uploaded certificates.
2992+
*
2993+
* Defaults to ``resources/config/ca-bundle.crt`` inside the Nextcloud installation directory.
29882994
*/
2989-
'default_certificates_bundle_path' => \OC::$SERVERROOT . '/resources/config/ca-bundle.crt',
2995+
'default_certificates_bundle_path' => '/etc/ssl/certs/ca-certificates.crt',
29902996

29912997
/**
29922998
* OpenMetrics skipped exporters

0 commit comments

Comments
 (0)