Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
The table of contents is too big for display.
Diff view
Diff view
  •  
  •  
  •  
Binary file modified server/latest/Nextcloud_Developer_Manual.epub
Binary file not shown.
Binary file modified server/latest/Nextcloud_Server_Administration_Manual.epub
Binary file not shown.
Binary file modified server/latest/Nextcloud_Server_Administration_Manual.pdf
Binary file not shown.
Binary file modified server/latest/Nextcloud_User_Manual.epub
Binary file not shown.
Binary file modified server/latest/Nextcloud_User_Manual.pdf
Binary file not shown.
2 changes: 2 additions & 0 deletions server/latest/admin_manual/contents.html
Original file line number Diff line number Diff line change
Expand Up @@ -456,6 +456,8 @@ <h1>Table of contents<a class="headerlink" href="#table-of-contents" title="Link
<li class="toctree-l4"><a class="reference internal" href="installation/nginx.html#javascript-js-or-css-css-files-not-served-properly">JavaScript (.js) or CSS (.css) files not served properly</a></li>
<li class="toctree-l4"><a class="reference internal" href="installation/nginx.html#upload-of-files-greater-than-10-mib-fails">Upload of files greater than 10 MiB fails</a></li>
<li class="toctree-l4"><a class="reference internal" href="installation/nginx.html#login-loop-without-any-clue-in-access-log-error-log-nor-nextcloud-log">Login loop without any clue in access.log, error.log, nor nextcloud.log</a></li>
<li class="toctree-l4"><a class="reference internal" href="installation/nginx.html#trusted-proxy-not-detected-when-using-a-unix-domain-socket">Trusted proxy not detected when using a Unix domain socket</a></li>
<li class="toctree-l4"><a class="reference internal" href="installation/nginx.html#access-through-untrusted-domain-error-with-http-3">“Access through untrusted domain” error with HTTP/3</a></li>
</ul>
</li>
</ul>
Expand Down
38 changes: 38 additions & 0 deletions server/latest/admin_manual/installation/nginx.html
Original file line number Diff line number Diff line change
Expand Up @@ -101,6 +101,8 @@
<li class="toctree-l4"><a class="reference internal" href="#javascript-js-or-css-css-files-not-served-properly">JavaScript (.js) or CSS (.css) files not served properly</a></li>
<li class="toctree-l4"><a class="reference internal" href="#upload-of-files-greater-than-10-mib-fails">Upload of files greater than 10 MiB fails</a></li>
<li class="toctree-l4"><a class="reference internal" href="#login-loop-without-any-clue-in-access-log-error-log-nor-nextcloud-log">Login loop without any clue in access.log, error.log, nor nextcloud.log</a></li>
<li class="toctree-l4"><a class="reference internal" href="#trusted-proxy-not-detected-when-using-a-unix-domain-socket">Trusted proxy not detected when using a Unix domain socket</a></li>
<li class="toctree-l4"><a class="reference internal" href="#access-through-untrusted-domain-error-with-http-3">“Access through untrusted domain” error with HTTP/3</a></li>
</ul>
</li>
</ul>
Expand Down Expand Up @@ -816,6 +818,42 @@ <h3>Login loop without any clue in access.log, error.log, nor nextcloud.log<a cl
</pre></div>
</div>
</section>
<section id="trusted-proxy-not-detected-when-using-a-unix-domain-socket">
<h3>Trusted proxy not detected when using a Unix domain socket<a class="headerlink" href="#trusted-proxy-not-detected-when-using-a-unix-domain-socket" title="Link to this heading"></a></h3>
<p>When an upstream proxy (another nginx instance, Caddy, HAProxy, etc.) passes
requests to Nextcloud’s nginx via a Unix domain socket, nginx sets
<code class="docutils literal notranslate"><span class="pre">REMOTE_ADDR</span></code> to the literal string <code class="docutils literal notranslate"><span class="pre">unix:</span></code> instead of an IP address.
Nextcloud cannot parse this as a trusted proxy, causing trusted proxy detection
to fail and resulting in errors such as:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">Unsupported</span> <span class="n">operand</span> <span class="n">types</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">&amp;</span> <span class="n">string</span> <span class="ow">in</span> <span class="n">IpAddress</span><span class="o">.</span><span class="n">php</span>
</pre></div>
</div>
<p>To fix this, add the following directives to the nginx <code class="docutils literal notranslate"><span class="pre">server</span></code> block that
listens on the Unix socket:</p>
<div class="highlight-nginx notranslate"><div class="highlight"><pre><span></span><span class="k">set_real_ip_from</span><span class="w"> </span><span class="s">unix:</span><span class="p">;</span>
<span class="k">real_ip_header</span><span class="w"> </span><span class="s">X-Forwarded-For</span><span class="p">;</span>
</pre></div>
</div>
<p>This tells nginx to treat the Unix socket peer as a trusted source and extract
the real client IP from the <code class="docutils literal notranslate"><span class="pre">X-Forwarded-For</span></code> header passed by the upstream
proxy. You must also ensure the upstream proxy sets that header correctly,
for example with <code class="docutils literal notranslate"><span class="pre">proxy_set_header</span> <span class="pre">X-Forwarded-For</span> <span class="pre">$proxy_add_x_forwarded_for;</span></code>.</p>
</section>
<section id="access-through-untrusted-domain-error-with-http-3">
<h3>“Access through untrusted domain” error with HTTP/3<a class="headerlink" href="#access-through-untrusted-domain-error-with-http-3" title="Link to this heading"></a></h3>
<p>When HTTP/3 (QUIC) is enabled in nginx, the <code class="docutils literal notranslate"><span class="pre">HTTP_HOST</span></code> FastCGI parameter
may not be forwarded correctly to PHP-FPM, causing Nextcloud to show the
<em>“Access through untrusted domain”</em> error page even though the domain is listed
in <code class="docutils literal notranslate"><span class="pre">trusted_domains</span></code>.</p>
<p>Add the following line to the <code class="docutils literal notranslate"><span class="pre">fastcgi_param</span></code> block in your nginx
configuration to explicitly pass the host:</p>
<div class="highlight-nginx notranslate"><div class="highlight"><pre><span></span><span class="k">fastcgi_param</span><span class="w"> </span><span class="s">HTTP_HOST</span><span class="w"> </span><span class="nv">$host</span><span class="p">;</span>
</pre></div>
</div>
<p>Place it alongside the other <code class="docutils literal notranslate"><span class="pre">fastcgi_param</span></code> directives (after
<code class="docutils literal notranslate"><span class="pre">include</span> <span class="pre">fastcgi_params;</span></code>). This overrides whatever value (or lack thereof)
nginx would otherwise derive from the HTTP/3 request headers.</p>
</section>
</section>
</section>

Expand Down
2 changes: 1 addition & 1 deletion server/latest/admin_manual/searchindex.js

Large diffs are not rendered by default.

2 changes: 1 addition & 1 deletion server/latest/developer_manual/404.html
Original file line number Diff line number Diff line change
Expand Up @@ -563,7 +563,7 @@ <h3>Here are some alternatives:</h3>

<div role="contentinfo">
<p>&#169; Copyright 2016-2026 Nextcloud GmbH and Nextcloud contributors.
<span class="lastupdated">Last updated on May 22, 2026.
<span class="lastupdated">Last updated on May 24, 2026.
</span></p>
</div>

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -322,7 +322,7 @@ <h3>Nextcloud 20 and later<a class="headerlink" href="#nextcloud-20-and-later" t

<div role="contentinfo">
<p>&#169; Copyright 2016-2026 Nextcloud GmbH and Nextcloud contributors.
<span class="lastupdated">Last updated on May 22, 2026.
<span class="lastupdated">Last updated on May 24, 2026.
</span></p>
</div>

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -316,7 +316,7 @@ <h2>Interactive commands<a class="headerlink" href="#interactive-commands" title

<div role="contentinfo">
<p>&#169; Copyright 2016-2026 Nextcloud GmbH and Nextcloud contributors.
<span class="lastupdated">Last updated on May 22, 2026.
<span class="lastupdated">Last updated on May 24, 2026.
</span></p>
</div>

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -218,7 +218,7 @@ <h2>Performance considerations<a class="headerlink" href="#performance-considera

<div role="contentinfo">
<p>&#169; Copyright 2016-2026 Nextcloud GmbH and Nextcloud contributors.
<span class="lastupdated">Last updated on May 22, 2026.
<span class="lastupdated">Last updated on May 24, 2026.
</span></p>
</div>

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -283,7 +283,7 @@ <h4>Conflict example<a class="headerlink" href="#conflict-example" title="Link t

<div role="contentinfo">
<p>&#169; Copyright 2016-2026 Nextcloud GmbH and Nextcloud contributors.
<span class="lastupdated">Last updated on May 22, 2026.
<span class="lastupdated">Last updated on May 24, 2026.
</span></p>
</div>

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -189,7 +189,7 @@ <h1>App development<a class="headerlink" href="#app-development" title="Link to

<div role="contentinfo">
<p>&#169; Copyright 2016-2026 Nextcloud GmbH and Nextcloud contributors.
<span class="lastupdated">Last updated on May 22, 2026.
<span class="lastupdated">Last updated on May 24, 2026.
</span></p>
</div>

Expand Down
2 changes: 1 addition & 1 deletion server/latest/developer_manual/app_development/info.html
Original file line number Diff line number Diff line change
Expand Up @@ -660,7 +660,7 @@

<div role="contentinfo">
<p>&#169; Copyright 2016-2026 Nextcloud GmbH and Nextcloud contributors.
<span class="lastupdated">Last updated on May 22, 2026.
<span class="lastupdated">Last updated on May 24, 2026.
</span></p>
</div>

Expand Down
2 changes: 1 addition & 1 deletion server/latest/developer_manual/app_development/init.html
Original file line number Diff line number Diff line change
Expand Up @@ -166,7 +166,7 @@ <h2>Initialization events<a class="headerlink" href="#initialization-events" tit

<div role="contentinfo">
<p>&#169; Copyright 2016-2026 Nextcloud GmbH and Nextcloud contributors.
<span class="lastupdated">Last updated on May 22, 2026.
<span class="lastupdated">Last updated on May 24, 2026.
</span></p>
</div>

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -196,7 +196,7 @@ <h2>App architecture<a class="headerlink" href="#app-architecture" title="Link t

<div role="contentinfo">
<p>&#169; Copyright 2016-2026 Nextcloud GmbH and Nextcloud contributors.
<span class="lastupdated">Last updated on May 22, 2026.
<span class="lastupdated">Last updated on May 24, 2026.
</span></p>
</div>

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -307,7 +307,7 @@ <h2>Documentation on the translation process<a class="headerlink" href="#documen

<div role="contentinfo">
<p>&#169; Copyright 2016-2026 Nextcloud GmbH and Nextcloud contributors.
<span class="lastupdated">Last updated on May 22, 2026.
<span class="lastupdated">Last updated on May 24, 2026.
</span></p>
</div>

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -140,7 +140,7 @@ <h1>Tutorial<a class="headerlink" href="#tutorial" title="Link to this heading">

<div role="contentinfo">
<p>&#169; Copyright 2016-2026 Nextcloud GmbH and Nextcloud contributors.
<span class="lastupdated">Last updated on May 22, 2026.
<span class="lastupdated">Last updated on May 24, 2026.
</span></p>
</div>

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -336,7 +336,7 @@ <h2>Errors<a class="headerlink" href="#errors" title="Link to this heading"><

<div role="contentinfo">
<p>&#169; Copyright 2016-2026 Nextcloud GmbH and Nextcloud contributors.
<span class="lastupdated">Last updated on May 22, 2026.
<span class="lastupdated">Last updated on May 24, 2026.
</span></p>
</div>

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -177,7 +177,7 @@ <h1>App publishing and maintenance<a class="headerlink" href="#app-publishing-an

<div role="contentinfo">
<p>&#169; Copyright 2016-2026 Nextcloud GmbH and Nextcloud contributors.
<span class="lastupdated">Last updated on May 22, 2026.
<span class="lastupdated">Last updated on May 24, 2026.
</span></p>
</div>

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -166,7 +166,7 @@

<div role="contentinfo">
<p>&#169; Copyright 2016-2026 Nextcloud GmbH and Nextcloud contributors.
<span class="lastupdated">Last updated on May 22, 2026.
<span class="lastupdated">Last updated on May 24, 2026.
</span></p>
</div>

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -168,7 +168,7 @@ <h2>Enterprise support<a class="headerlink" href="#enterprise-support" title="Li

<div role="contentinfo">
<p>&#169; Copyright 2016-2026 Nextcloud GmbH and Nextcloud contributors.
<span class="lastupdated">Last updated on May 22, 2026.
<span class="lastupdated">Last updated on May 24, 2026.
</span></p>
</div>

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -243,7 +243,7 @@ <h3>How to move<a class="headerlink" href="#how-to-move" title="Link to this hea

<div role="contentinfo">
<p>&#169; Copyright 2016-2026 Nextcloud GmbH and Nextcloud contributors.
<span class="lastupdated">Last updated on May 22, 2026.
<span class="lastupdated">Last updated on May 24, 2026.
</span></p>
</div>

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -325,7 +325,7 @@ <h3>The process<a class="headerlink" href="#the-process" title="Link to this hea

<div role="contentinfo">
<p>&#169; Copyright 2016-2026 Nextcloud GmbH and Nextcloud contributors.
<span class="lastupdated">Last updated on May 22, 2026.
<span class="lastupdated">Last updated on May 24, 2026.
</span></p>
</div>

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -335,7 +335,7 @@ <h3>Hybrid Distribution<a class="headerlink" href="#hybrid-distribution" title="

<div role="contentinfo">
<p>&#169; Copyright 2016-2026 Nextcloud GmbH and Nextcloud contributors.
<span class="lastupdated">Last updated on May 22, 2026.
<span class="lastupdated">Last updated on May 24, 2026.
</span></p>
</div>

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -1214,7 +1214,7 @@ <h1><code class="docutils literal notranslate"><span class="pre">OCP\WorkflowEng

<div role="contentinfo">
<p>&#169; Copyright 2016-2026 Nextcloud GmbH and Nextcloud contributors.
<span class="lastupdated">Last updated on May 22, 2026.
<span class="lastupdated">Last updated on May 24, 2026.
</span></p>
</div>

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -327,7 +327,7 @@ <h3>Scheduling<a class="headerlink" href="#scheduling" title="Link to this headi

<div role="contentinfo">
<p>&#169; Copyright 2016-2026 Nextcloud GmbH and Nextcloud contributors.
<span class="lastupdated">Last updated on May 22, 2026.
<span class="lastupdated">Last updated on May 24, 2026.
</span></p>
</div>

Expand Down
2 changes: 1 addition & 1 deletion server/latest/developer_manual/basics/caching.html
Original file line number Diff line number Diff line change
Expand Up @@ -322,7 +322,7 @@ <h2>Distributed cache<a class="headerlink" href="#distributed-cache" title="Link

<div role="contentinfo">
<p>&#169; Copyright 2016-2026 Nextcloud GmbH and Nextcloud contributors.
<span class="lastupdated">Last updated on May 22, 2026.
<span class="lastupdated">Last updated on May 24, 2026.
</span></p>
</div>

Expand Down
2 changes: 1 addition & 1 deletion server/latest/developer_manual/basics/controllers.html
Original file line number Diff line number Diff line change
Expand Up @@ -1242,7 +1242,7 @@ <h3>Modifying the content security policy<a class="headerlink" href="#modifying-

<div role="contentinfo">
<p>&#169; Copyright 2016-2026 Nextcloud GmbH and Nextcloud contributors.
<span class="lastupdated">Last updated on May 22, 2026.
<span class="lastupdated">Last updated on May 24, 2026.
</span></p>
</div>

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -692,7 +692,7 @@ <h2>Accessing the container from anywhere<a class="headerlink" href="#accessing-

<div role="contentinfo">
<p>&#169; Copyright 2016-2026 Nextcloud GmbH and Nextcloud contributors.
<span class="lastupdated">Last updated on May 22, 2026.
<span class="lastupdated">Last updated on May 24, 2026.
</span></p>
</div>

Expand Down
2 changes: 1 addition & 1 deletion server/latest/developer_manual/basics/events.html
Original file line number Diff line number Diff line change
Expand Up @@ -1749,7 +1749,7 @@ <h2>Public emitter<a class="headerlink" href="#public-emitter" title="Link to th

<div role="contentinfo">
<p>&#169; Copyright 2016-2026 Nextcloud GmbH and Nextcloud contributors.
<span class="lastupdated">Last updated on May 22, 2026.
<span class="lastupdated">Last updated on May 24, 2026.
</span></p>
</div>

Expand Down
2 changes: 1 addition & 1 deletion server/latest/developer_manual/basics/front-end/css.html
Original file line number Diff line number Diff line change
Expand Up @@ -184,7 +184,7 @@ <h1>CSS<a class="headerlink" href="#css" title="Link to this heading"></a></h

<div role="contentinfo">
<p>&#169; Copyright 2016-2026 Nextcloud GmbH and Nextcloud contributors.
<span class="lastupdated">Last updated on May 22, 2026.
<span class="lastupdated">Last updated on May 24, 2026.
</span></p>
</div>

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -175,7 +175,7 @@ <h1>Front-end<a class="headerlink" href="#front-end" title="Link to this heading

<div role="contentinfo">
<p>&#169; Copyright 2016-2026 Nextcloud GmbH and Nextcloud contributors.
<span class="lastupdated">Last updated on May 22, 2026.
<span class="lastupdated">Last updated on May 24, 2026.
</span></p>
</div>

Expand Down
2 changes: 1 addition & 1 deletion server/latest/developer_manual/basics/front-end/js.html
Original file line number Diff line number Diff line change
Expand Up @@ -360,7 +360,7 @@ <h3>Obtaining the initial state in JavaScript<a class="headerlink" href="#obtain

<div role="contentinfo">
<p>&#169; Copyright 2016-2026 Nextcloud GmbH and Nextcloud contributors.
<span class="lastupdated">Last updated on May 22, 2026.
<span class="lastupdated">Last updated on May 24, 2026.
</span></p>
</div>

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -212,7 +212,7 @@ <h2>Including images<a class="headerlink" href="#including-images" title="Link t

<div role="contentinfo">
<p>&#169; Copyright 2016-2026 Nextcloud GmbH and Nextcloud contributors.
<span class="lastupdated">Last updated on May 22, 2026.
<span class="lastupdated">Last updated on May 24, 2026.
</span></p>
</div>

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -185,7 +185,7 @@ <h2>Icons<a class="headerlink" href="#icons" title="Link to this heading"></a

<div role="contentinfo">
<p>&#169; Copyright 2016-2026 Nextcloud GmbH and Nextcloud contributors.
<span class="lastupdated">Last updated on May 22, 2026.
<span class="lastupdated">Last updated on May 24, 2026.
</span></p>
</div>

Expand Down
2 changes: 1 addition & 1 deletion server/latest/developer_manual/basics/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -255,7 +255,7 @@ <h1>Basic concepts<a class="headerlink" href="#basic-concepts" title="Link to th

<div role="contentinfo">
<p>&#169; Copyright 2016-2026 Nextcloud GmbH and Nextcloud contributors.
<span class="lastupdated">Last updated on May 22, 2026.
<span class="lastupdated">Last updated on May 24, 2026.
</span></p>
</div>

Expand Down
2 changes: 1 addition & 1 deletion server/latest/developer_manual/basics/logging.html
Original file line number Diff line number Diff line change
Expand Up @@ -447,7 +447,7 @@ <h2>Admin audit logging<a class="headerlink" href="#admin-audit-logging" title="

<div role="contentinfo">
<p>&#169; Copyright 2016-2026 Nextcloud GmbH and Nextcloud contributors.
<span class="lastupdated">Last updated on May 22, 2026.
<span class="lastupdated">Last updated on May 24, 2026.
</span></p>
</div>

Expand Down
2 changes: 1 addition & 1 deletion server/latest/developer_manual/basics/middlewares.html
Original file line number Diff line number Diff line change
Expand Up @@ -318,7 +318,7 @@ <h2>Parsing annotations<a class="headerlink" href="#parsing-annotations" title="

<div role="contentinfo">
<p>&#169; Copyright 2016-2026 Nextcloud GmbH and Nextcloud contributors.
<span class="lastupdated">Last updated on May 22, 2026.
<span class="lastupdated">Last updated on May 24, 2026.
</span></p>
</div>

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -237,7 +237,7 @@ <h1>Public share template<a class="headerlink" href="#public-share-template" tit

<div role="contentinfo">
<p>&#169; Copyright 2016-2026 Nextcloud GmbH and Nextcloud contributors.
<span class="lastupdated">Last updated on May 22, 2026.
<span class="lastupdated">Last updated on May 24, 2026.
</span></p>
</div>

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -172,7 +172,7 @@ <h2>Front controller<a class="headerlink" href="#front-controller" title="Link t

<div role="contentinfo">
<p>&#169; Copyright 2016-2026 Nextcloud GmbH and Nextcloud contributors.
<span class="lastupdated">Last updated on May 22, 2026.
<span class="lastupdated">Last updated on May 24, 2026.
</span></p>
</div>

Expand Down
2 changes: 1 addition & 1 deletion server/latest/developer_manual/basics/routing.html
Original file line number Diff line number Diff line change
Expand Up @@ -397,7 +397,7 @@ <h3>router:match<a class="headerlink" href="#router-match" title="Link to this h

<div role="contentinfo">
<p>&#169; Copyright 2016-2026 Nextcloud GmbH and Nextcloud contributors.
<span class="lastupdated">Last updated on May 22, 2026.
<span class="lastupdated">Last updated on May 24, 2026.
</span></p>
</div>

Expand Down
2 changes: 1 addition & 1 deletion server/latest/developer_manual/basics/setting.html
Original file line number Diff line number Diff line change
Expand Up @@ -317,7 +317,7 @@ <h1>Settings<a class="headerlink" href="#settings" title="Link to this heading">

<div role="contentinfo">
<p>&#169; Copyright 2016-2026 Nextcloud GmbH and Nextcloud contributors.
<span class="lastupdated">Last updated on May 22, 2026.
<span class="lastupdated">Last updated on May 24, 2026.
</span></p>
</div>

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -226,7 +226,7 @@ <h3>File<a class="headerlink" href="#file" title="Link to this heading"></a><

<div role="contentinfo">
<p>&#169; Copyright 2016-2026 Nextcloud GmbH and Nextcloud contributors.
<span class="lastupdated">Last updated on May 22, 2026.
<span class="lastupdated">Last updated on May 24, 2026.
</span></p>
</div>

Expand Down
Loading