Skip to content

Commit 8d086a8

Browse files
committed
docs(admin): document all four well-known URL redirects
The security setup warnings page only listed /.well-known/caldav and /.well-known/carddav. Nextcloud also requires /.well-known/webfinger and /.well-known/nodeinfo to be redirected for federation and server metadata to work correctly. Admins seeing warnings about these URLs were directed to docs that didn't mention them. Updated the section to list all four required well-known redirects with their target paths and a brief description of each. Fixes #6885 Signed-off-by: skjnldsv <skjnldsv@protonmail.com>
1 parent e793142 commit 8d086a8

1 file changed

Lines changed: 14 additions & 4 deletions

File tree

admin_manual/configuration_server/security_setup_warnings.rst

Lines changed: 14 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -115,11 +115,21 @@ websites. To ensure that Nextcloud will work properly you need to update OpenSSL
115115
to at least 1.0.2b or 1.0.1d. For NSS the patch version depends on your distribution
116116
and an heuristic is running the test which actually reproduces the bug.
117117

118-
Your Web server is not set up properly to resolve /.well-known/caldav/ or /.well-known/carddav/
119-
-----------------------------------------------------------------------------------------------
118+
Your Web server is not set up properly to resolve /.well-known/ URLs
119+
--------------------------------------------------------------------
120120

121-
Both URLs need to be correctly redirected to the DAV endpoint of Nextcloud. Please
122-
refer to :ref:`service-discovery-label` for more info.
121+
The following well-known URLs must be correctly redirected for full Nextcloud functionality:
122+
123+
* ``/.well-known/caldav`` → ``/remote.php/dav`` (CalDAV service discovery)
124+
* ``/.well-known/carddav`` → ``/remote.php/dav`` (CardDAV service discovery)
125+
* ``/.well-known/webfinger`` → ``/index.php/.well-known/webfinger`` (identity/federation)
126+
* ``/.well-known/nodeinfo`` → ``/index.php/.well-known/nodeinfo`` (server metadata)
127+
128+
The CalDAV and CardDAV redirects are required for calendar and contacts clients that use
129+
automatic service discovery. The WebFinger and NodeInfo redirects are used for federation
130+
and profile discovery between Nextcloud instances and compatible services.
131+
132+
Please refer to :ref:`service-discovery-label` for setup instructions for Apache and NGINX.
123133

124134
Some files have not passed the integrity check
125135
----------------------------------------------

0 commit comments

Comments
 (0)