docs(config): clarify overwrite.cli.url guidance in sample / Admin Manual

Signed-off-by: Josh <josh.t.richards@gmail.com>
This commit is contained in:
Josh 2026-05-06 10:10:53 -04:00 committed by GitHub
parent d56ad83c1c
commit 7744667776
No known key found for this signature in database
GPG key ID: B5690EEEBB952194

View file

@ -739,12 +739,19 @@ $CONFIG = [
'overwritecondaddr' => '',
/**
* Use this configuration parameter to specify the base URL for any URLs which
* are generated within Nextcloud using any kind of command line tools (cron or
* occ). The value should contain the full base URL:
* Set the canonical base URL Nextcloud should use when generating URLs outside
* a normal web request, such as in background jobs or at the command-line.
* The value should be the full base URL including the web root, for example:
* ``https://www.example.com/nextcloud``
* Please make sure to set the value to the URL that your users mainly use to access this Nextcloud.
* Otherwise, there might be problems with the URL generation via cron.
*
* In most setups, this should match the URL your users normally use to access
* Nextcloud. If it is incorrect, URL generation may be wrong in cron jobs,
* ``occ``, notifications, and similar contexts.
*
* NOTE: During installation, Nextcloud seeds this value from the installers
* current access context. If it was not preseeded (for example, via
* ``autoconfig.php``), the inferred value may not match the public URL that
* users normally use to access Nextcloud and may need adjustment.
*
* Defaults to ``''`` (empty string)
*/