From eef6aa0f7c8531012161ac3e0cd4ad5f4bf50f03 Mon Sep 17 00:00:00 2001 From: Ali Aslam Date: Wed, 22 Jul 2026 01:35:00 -0500 Subject: [PATCH] docs(sharing): document shareapi_public_link_base_url app config Documentation for nextcloud/server#62146 Signed-off-by: Ali Aslam Signed-off-by: Ali Aslam --- .../file_sharing_configuration.rst | 14 ++++++++++++++ 1 file changed, 14 insertions(+) diff --git a/admin_manual/configuration_files/file_sharing_configuration.rst b/admin_manual/configuration_files/file_sharing_configuration.rst index 550a7a78558..d933d2c1a57 100644 --- a/admin_manual/configuration_files/file_sharing_configuration.rst +++ b/admin_manual/configuration_files/file_sharing_configuration.rst @@ -134,6 +134,20 @@ You can use the ``occ`` command to update those, for example: + When full match is activated, do not match user email + Default: ``yes`` +- ``core.shareapi_public_link_base_url`` + + Set a custom base URL used when generating public share links (link shares and email shares). + This applies to the web UI copy-link, the OCS Share API, share-notification emails, and reminders. + Useful when Nextcloud sits behind a public gateway or reverse proxy that exposes a different domain. + + Default: empty (unset), links use the instance URL. + + Must be an absolute ``http://`` or ``https://`` URL. Credentials, query strings, and fragments are not + allowed. Invalid values are rejected with a warning in the log and links fall back to the instance URL. + + The share-link path is appended as the instance would generate it — + ``/s/{token}``, or ``/index.php/s/{token}`` on instances without pretty URLs. + The configured base URL must accept and route that path to the instance. + + Example: + ``occ config:app:set core shareapi_public_link_base_url --value='https://public.example.com/'`` + + Distinguish between max expiration date and default expiration date -------------------------------------------------------------------