File Manager - BorneoXploit

Editing: nginx.html

<!DOCTYPE html>
<html class="writer-html5" lang="en" data-content_root="../">
<head>
 <meta charset="utf-8" />
 <meta name="readthedocs-addons-api-version" content="1"><meta name="viewport" content="width=device-width, initial-scale=1" />

<a href="../contents.html">
 
 <img src="../_static/logo-white.png" class="logo" alt="Logo"/>
 </a>
 <div class="switch-menus">
 <div class="version-switch"></div>
 <div class="language-switch"></div>
 </div>
<div role="search">
 <form id="rtd-search-form" class="wy-form" action="../search.html" method="get">
 <input type="text" name="q" placeholder="Search docs" aria-label="Search docs" />
 <input type="hidden" name="check_keywords" value="yes" />
 <input type="hidden" name="area" value="default" />
 </form>
</div>
 </div><div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
 Getting Started
<ul>
<li class="toctree-l1"><a class="reference internal" href="../index.html">Introduction</a></li>
<li class="toctree-l1"><a class="reference internal" href="../release_schedule.html">Maintenance and release schedule</a></li>
<li class="toctree-l1"><a class="reference internal" href="../gdpr/index.html">GDPR-compliance</a></li>
<li class="toctree-l1"><a class="reference internal" href="../declarations/index.html">Declarations</a></li>
</ul>
Release notes
<ul>
<li class="toctree-l1"><a class="reference internal" href="../release_notes/index.html">Critical changes</a></li>
</ul>
Installation
<ul class="current">
<li class="toctree-l1 current"><a class="reference internal" href="index.html">Installation and server configuration</a><ul class="current">
<li class="toctree-l2"><a class="reference internal" href="system_requirements.html">System requirements</a></li>
<li class="toctree-l2"><a class="reference internal" href="deployment_recommendations.html">Deployment recommendations</a></li>
<li class="toctree-l2"><a class="reference internal" href="php_configuration.html">Preparing PHP</a></li>
<li class="toctree-l2"><a class="reference internal" href="source_installation.html">Installation on Linux</a></li>
<li class="toctree-l2"><a class="reference internal" href="installation_wizard.html">Installation wizard</a></li>
<li class="toctree-l2"><a class="reference internal" href="command_line_installation.html">Installing from command line</a></li>
<li class="toctree-l2"><a class="reference internal" href="selinux_configuration.html">SELinux configuration</a></li>
<li class="toctree-l2 current"><a class="current reference internal" href="#">NGINX configuration</a><ul>
<li class="toctree-l3"><a class="reference internal" href="#nextcloud-in-the-webroot-of-nginx">Nextcloud in the webroot of NGINX</a></li>
<li class="toctree-l3"><a class="reference internal" href="#nextcloud-in-a-subdir-of-the-nginx-webroot">Nextcloud in a subdir of the NGINX webroot</a></li>
<li class="toctree-l3"><a class="reference internal" href="#tips-and-tricks">Tips and tricks</a><ul>
<li class="toctree-l4"><a class="reference internal" href="#php-handler-configuration-avoiding-502-bad-gateway">PHP-Handler Configuration / Avoiding “502 Bad Gateway”</a></li>
<li class="toctree-l4"><a class="reference internal" href="#suppressing-log-messages">Suppressing log messages</a></li>
<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>
</ul>
</li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="harden_server.html">Hardening and security guidance</a></li>
<li class="toctree-l2"><a class="reference internal" href="server_tuning.html">Server tuning</a></li>
<li class="toctree-l2"><a class="reference internal" href="example_ubuntu.html">Example installation on Ubuntu 22.04 LTS</a></li>
<li class="toctree-l2"><a class="reference internal" href="example_centos.html">Example installation on CentOS 8</a></li>
<li class="toctree-l2"><a class="reference internal" href="example_openbsd.html">Example installation on OpenBSD</a></li>
<li class="toctree-l2"><a class="reference internal" href="uninstallation.html">Uninstallation</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="../configuration_database/index.html">Database configuration</a></li>
</ul>
Configuration
<ul>
<li class="toctree-l1"><a class="reference internal" href="../configuration_server/index.html">Nextcloud configuration</a></li>
<li class="toctree-l1"><a class="reference internal" href="../occ_command.html">Using the occ command</a></li>
<li class="toctree-l1"><a class="reference internal" href="../reference/index.html">Reference management</a></li>
<li class="toctree-l1"><a class="reference internal" href="../webhook_listeners/index.html">Webhook Listeners</a></li>
<li class="toctree-l1"><a class="reference internal" href="../windmill_workflows/index.html">Windmill Workflows</a></li>
</ul>
Files
<ul>
<li class="toctree-l1"><a class="reference internal" href="../configuration_files/index.html">File sharing and management</a></li>
<li class="toctree-l1"><a class="reference internal" href="../file_workflows/index.html">Flow</a></li>
<li class="toctree-l1"><a class="reference internal" href="../configuration_mimetypes/index.html">Mimetypes management</a></li>
</ul>
Apps
<ul>
<li class="toctree-l1"><a class="reference internal" href="../apps_management.html">Apps management</a></li>
<li class="toctree-l1"><a class="reference internal" href="../exapps_management/index.html">ExApps management</a></li>
<li class="toctree-l1"><a class="reference internal" href="../ai/index.html">Artificial Intelligence</a></li>
</ul>
Users
<ul>
<li class="toctree-l1"><a class="reference internal" href="../configuration_user/index.html">User management</a></li>
<li class="toctree-l1"><a class="reference internal" href="../desktop/index.html">Desktop Clients</a></li>
</ul>
Groupware
<ul>
<li class="toctree-l1"><a class="reference internal" href="../groupware/index.html">Groupware</a></li>
</ul>
Office
<ul>
<li class="toctree-l1"><a class="reference internal" href="../office/index.html">Office</a></li>
</ul>
Maintenance
<ul>
<li class="toctree-l1"><a class="reference internal" href="../configuration_monitoring/index.html">Monitoring</a></li>
<li class="toctree-l1"><a class="reference internal" href="../maintenance/index.html">Maintenance</a></li>
<li class="toctree-l1"><a class="reference internal" href="../issues/index.html">Issues and troubleshooting</a></li>
</ul>
Links
<ul>
<li class="toctree-l1"><a class="reference external" href="https://help.nextcloud.com/">Community Help Forum</a></li>
<li class="toctree-l1"><a class="reference external" href="https://docs.nextcloud.com/">User Manuals</a></li>
<li class="toctree-l1"><a class="reference external" href="https://docs.nextcloud.com/">Developer Manuals</a></li>
<li class="toctree-l1"><a class="reference external" href="https://nextcloud.com/install/">Download</a></li>
<li class="toctree-l1"><a class="reference external" href="https://apps.nextcloud.com">App Store</a></li>
<li class="toctree-l1"><a class="reference external" href="https://help.nextcloud.com/t/translation-knowledge-valid-for-the-entire-nextcloud-project-wiki/51550">Translations</a></li>
<li class="toctree-l1"><a class="reference external" href="https://github.com/nextcloud/">GitHub</a></li>
<li class="toctree-l1"><a class="reference external" href="https://github.com/nextcloud/server/wiki/Maintenance-and-Release-Schedule">Supported versions</a></li>
<li class="toctree-l1"><a class="reference external" href="https://nextcloud.com/enterprise/">Nextcloud Enterprise</a></li>
<li class="toctree-l1"><a class="reference external" href="https://github.com/nextcloud/server/blob/master/COPYING-README">License</a></li>
<li class="toctree-l1"><a class="reference external" href="https://nextcloud.com/">Nextcloud GmbH</a></li>
</ul>

</div>
 </div>
 </nav>

<section data-toggle="wy-nav-shift" class="wy-nav-content-wrap"><nav class="wy-nav-top" aria-label="Mobile navigation menu" >
 
 <a href="../contents.html">Nextcloud latest Administration Manual</a>
 </nav>

<div class="wy-nav-content">
 <div class="rst-content style-external-links">
 <div role="navigation" aria-label="Page navigation">
 <ul class="wy-breadcrumbs">
 <li><a href="../contents.html" class="icon icon-home" aria-label="Home"></a></li>
 <li class="breadcrumb-item"><a href="index.html">Installation and server configuration</a></li>
 <li class="breadcrumb-item active">NGINX configuration</li>
 <li class="wy-breadcrumbs-aside">
 <a href="https://github.com/nextcloud/documentation/edit/master/admin_manual/installation/nginx.rst" class="fa fa-github"> Edit on GitHub</a>
 </li>
 </ul>
 <hr/>
</div>
 <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
 <div itemprop="articleBody">
 
 <section id="nginx-configuration">
<h1>NGINX configuration<a class="headerlink" href="#nginx-configuration" title="Link to this heading"></a></h1>
<div class="admonition note">
Note
This page covers example NGINX configurations to run a Nextcloud server.
These configurations examples were originally provided by <a class="reference external" href="https://github.com/josh4trunks">&#64;josh4trunks</a>
and are exclusively community-maintained. (Thank you contributors!)
</div>
<ul class="simple">
<li>You need to insert the following code into your Nginx configuration file.
Choose the appropriate example based on whether you are deploying <a class="reference internal" href="#nginx-webroot-example">Nextcloud in the webroot of NGINX</a> (i.e. <code class="code docutils literal notranslate">https://cloud.example.com/</code>) or <a class="reference internal" href="#nginx-subdir-example">Nextcloud in a subdir of the NGINX webroot</a> (i.e. <code class="code docutils literal notranslate">https://cloud.example.com/nextcloud</code>).</li>
<li>Adjust the server directive under <code class="code docutils literal notranslate">upstream php-handler</code> to match your PHP installation’s configured FPM listener (a misconfiguration here will result in a <code class="code docutils literal notranslate">502 Bad Gateway</code> - see <a class="reference internal" href="#nginx-php-handler-tips">PHP-Handler Configuration / Avoiding “502 Bad Gateway”</a> for details)</li>
<li>Adjust the existing <code class="code docutils literal notranslate">server_name</code> directives found under both <code class="code docutils literal notranslate">server</code> sections to your real hostname</li>
<li>Adjust <code class="code docutils literal notranslate">root</code> to the webroot of your Nextcloud installation</li>
<li>Adjust the <code class="code docutils literal notranslate">ssl_certificate</code> and <code class="code docutils literal notranslate">ssl_certificate_key</code> directives to the real paths for your signed
certificate and private key. Make sure your SSL certificates are readable by the nginx server process (see <a class="reference external" href="https://wiki.nginx.org/HttpSslModule">nginx HTTPS SSL
Module documentation</a>).</li>
<li>If using Let’s Encrypt as TLS certificate and nginx as webserver, set <cite>ssl_stapling</cite> and <cite>ssl_stapling_verify</cite> to <cite>off</cite>
in main nginx config (see [Let’s Encrypt blog post](<a class="reference external" href="https://letsencrypt.org/2024/12/05/ending-ocsp">https://letsencrypt.org/2024/12/05/ending-ocsp</a>)).</li>
<li>Be careful about line breaks if you copy the examples, as long lines may be
broken for page display and result in an invalid configuration files.</li>
<li>Some environments might need a <code class="docutils literal notranslate">cgi.fix_pathinfo</code> set to <code class="docutils literal notranslate">1</code> in their
<code class="docutils literal notranslate">php.ini</code>.</li>
</ul>
<section id="nextcloud-in-the-webroot-of-nginx">
<h2>Nextcloud in the webroot of NGINX<a class="headerlink" href="#nextcloud-in-the-webroot-of-nginx" title="Link to this heading"></a></h2>
The following configuration should be used when Nextcloud is placed in the
webroot of your nginx installation. In this example it is
<code class="docutils literal notranslate">/var/www/nextcloud</code> and it is accessed via <code class="docutils literal notranslate">http(s)://cloud.example.com/</code>
<div class="highlight-nginx notranslate"><div class="highlight"><pre># Version 2025-07-23

upstream php-handler {
 server 127.0.0.1:9000;
 #server unix:/run/php/php8.2-fpm.sock;
}

# Set the `immutable` cache control options only for assets with a cache busting `v` argument
map $arg_v $asset_immutable {
 &quot;&quot; &quot;&quot;;
 default &quot;, immutable&quot;;
}

# Prevent nginx HTTP Server Detection
 server_tokens off;

# Enforce HTTPS
 return 301 https://$server_name$request_uri;
}

server {
 listen 443 ssl http2;
 listen [::]:443 ssl http2;
 # With NGinx &gt;= 1.25.1 you should use this instead:
 # listen 443 ssl;
 # listen [::]:443 ssl;
 # http2 on;
 server_name cloud.example.com;

# Path to the root of your installation
 root /var/www/nextcloud;

# Use Mozilla&#39;s guidelines for SSL/TLS settings
 # https://mozilla.github.io/server-side-tls/ssl-config-generator/
 ssl_certificate /etc/ssl/nginx/cloud.example.com.crt;
 ssl_certificate_key /etc/ssl/nginx/cloud.example.com.key;

# HSTS settings
 # WARNING: Only add the preload option once you read about
 # the consequences in https://hstspreload.org/. This option
 # will add the domain to a hardcoded list that is shipped
 # in all major browsers and getting removed from this list
 # could take several months.
 #add_header Strict-Transport-Security &quot;max-age=31536000; includeSubDomains; preload&quot; always;

# set max upload size and increase upload timeout:
 client_max_body_size 512M;
 client_body_timeout 300s;
 fastcgi_buffers 64 4K;

# Proxy and client response timeouts
 # Uncomment an increase these if facing timeout errors during large file uploads
 #proxy_connect_timeout 60s;
 #proxy_send_timeout 60s;
 #proxy_read_timeout 60s;
 #send_timeout 60s;

# Enable gzip but do not remove ETag headers
 gzip on;
 gzip_vary on;
 gzip_comp_level 4;
 gzip_min_length 256;
 gzip_proxied expired no-cache no-store private no_last_modified no_etag auth;
 gzip_types application/atom+xml text/javascript application/javascript application/json application/ld+json application/manifest+json application/rss+xml application/vnd.geo+json application/vnd.ms-fontobject application/wasm application/x-font-ttf application/x-web-app-manifest+json application/xhtml+xml application/xml font/opentype image/bmp image/svg+xml image/x-icon text/cache-manifest text/css text/plain text/vcard text/vnd.rim.location.xloc text/vtt text/x-component text/x-cross-domain-policy;

# Pagespeed is not supported by Nextcloud, so if your server is built
 # with the `ngx_pagespeed` module, uncomment this line to disable it.
 #pagespeed off;

# The settings allows you to optimize the HTTP2 bandwidth.
 # See https://blog.cloudflare.com/delivering-http-2-upload-speed-improvements/
 # for tuning hints
 client_body_buffer_size 512k;

# HTTP response headers borrowed from Nextcloud `.htaccess`
 add_header Referrer-Policy &quot;no-referrer&quot; always;
 add_header X-Content-Type-Options &quot;nosniff&quot; always;
 add_header X-Frame-Options &quot;SAMEORIGIN&quot; always;
 add_header X-Permitted-Cross-Domain-Policies &quot;none&quot; always;
 add_header X-Robots-Tag &quot;noindex, nofollow&quot; always;

# Remove X-Powered-By, which is an information leak
 fastcgi_hide_header X-Powered-By;

# Set .mjs and .wasm MIME types
 # Either include it in the default mime.types list
 # and include that list explicitly or add the file extension
 # only for Nextcloud like below:
 include mime.types;
 types {
 text/javascript mjs;
	application/wasm wasm;
 }

# Specify how to handle directories -- specifying `/index.php$request_uri`
 # here as the fallback means that Nginx always exhibits the desired behaviour
 # when a client requests a path that corresponds to a directory that exists
 # on the server. In particular, if that directory contains an index.php file,
 # that file is correctly served; if it doesn&#39;t, then the request is passed to
 # the front-end controller. This consistent behaviour means that we don&#39;t need
 # to specify custom rules for certain paths (e.g. images and other assets,
 # `/updater`, `/ocs-provider`), and thus
 # `try_files $uri $uri/ /index.php$request_uri`
 # always provides the desired behaviour.
 index index.php index.html /index.php$request_uri;

# Rule borrowed from `.htaccess` to handle Microsoft DAV clients
 location = / {
 if ( $http_user_agent ~ ^DavClnt ) {
 return 302 /remote.php/webdav/$is_args$args;
 }
 }

location = /robots.txt {
 allow all;
 log_not_found off;
 access_log off;
 }

# Make a regex exception for `/.well-known` so that clients can still
 # access it despite the existence of the regex rule
 # `location ~ /(\.|autotest|...)` which would otherwise handle requests
 # for `/.well-known`.
 location ^~ /.well-known {
 # The rules in this block are an adaptation of the rules
 # in `.htaccess` that concern `/.well-known`.

location = /.well-known/carddav { return 301 /remote.php/dav/; }
 location = /.well-known/caldav { return 301 /remote.php/dav/; }

location /.well-known/acme-challenge { try_files $uri $uri/ =404; }
 location /.well-known/pki-validation { try_files $uri $uri/ =404; }

# Let Nextcloud&#39;s API for `/.well-known` URIs handle all other
 # requests by passing them to the front-end controller.
 return 301 /index.php$request_uri;
 }

# Rules borrowed from `.htaccess` to hide certain paths from clients
 location ~ ^/(?:build|tests|config|lib|3rdparty|templates|data)(?:$|/) { return 404; }
 location ~ ^/(?:\.|autotest|occ|issue|indie|db_|console) { return 404; }

# Ensure this block, which passes PHP files to the PHP process, is above the blocks
 # which handle static assets (as seen below). If this block is not declared first,
 # then Nginx will encounter an infinite rewriting loop when it prepends `/index.php`
 # to the URI, resulting in a HTTP 500 error response.
 location ~ \.php(?:$|/) {
 # Required for legacy support
 rewrite ^/(?!index|remote|public|cron|core\/ajax\/update|status|ocs\/v[12]|updater\/.+|ocs-provider\/.+|.+\/richdocumentscode(_arm64)?\/proxy) /index.php$request_uri;

fastcgi_split_path_info ^(.+?\.php)(/.*)$;
 set $path_info $fastcgi_path_info;

try_files $fastcgi_script_name =404;

include fastcgi_params;
 fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
 fastcgi_param PATH_INFO $path_info;
 fastcgi_param HTTPS on;

fastcgi_param modHeadersAvailable true; # Avoid sending the security headers twice
 fastcgi_param front_controller_active true; # Enable pretty urls
 fastcgi_pass php-handler;

fastcgi_intercept_errors on;
 fastcgi_request_buffering on; # Required as PHP-FPM does not support chunked transfer encoding and requires a valid ContentLength header.

# PHP-FPM 504 response timeouts
 # Uncomment and increase these if facing timeout errors during large file uploads
 #fastcgi_read_timeout 60s;
 #fastcgi_send_timeout 60s;
 #fastcgi_connect_timeout 60s;

fastcgi_max_temp_file_size 0;
 }

# Serve static files
 location ~ \.(?:css|js|mjs|svg|gif|ico|jpg|png|webp|wasm|tflite|map|ogg|flac|mp4|webm)$ {
 try_files $uri /index.php$request_uri;
 # HTTP response headers borrowed from Nextcloud `.htaccess`
 add_header Cache-Control &quot;public, max-age=15778463$asset_immutable&quot;;
 add_header Referrer-Policy &quot;no-referrer&quot; always;
 add_header X-Content-Type-Options &quot;nosniff&quot; always;
 add_header X-Frame-Options &quot;SAMEORIGIN&quot; always;
 add_header X-Permitted-Cross-Domain-Policies &quot;none&quot; always;
 add_header X-Robots-Tag &quot;noindex, nofollow&quot; always;
 access_log off; # Optional: Don&#39;t log access to assets
 }

location ~ \.(otf|woff2?)$ {
 try_files $uri /index.php$request_uri;
 expires 7d; # Cache-Control policy borrowed from `.htaccess`
 access_log off; # Optional: Don&#39;t log access to assets
 }

# Rule borrowed from `.htaccess`
 location /remote {
 return 301 /remote.php$request_uri;
 }

location / {
 try_files $uri $uri/ /index.php$request_uri;
 }
}
</pre></div>
</div>
</section>
<section id="nextcloud-in-a-subdir-of-the-nginx-webroot">
<h2>Nextcloud in a subdir of the NGINX webroot<a class="headerlink" href="#nextcloud-in-a-subdir-of-the-nginx-webroot" title="Link to this heading"></a></h2>
The following config should be used when Nextcloud is placed within a subdir of
the webroot of your nginx installation.
In this example the Nextcloud files are located at
<code class="docutils literal notranslate">/var/www/nextcloud</code> and the Nextcloud instance is accessed via <code class="docutils literal notranslate">http(s)://cloud.example.com/nextcloud/</code>.
The configuration differs from the “Nextcloud in webroot” configuration above in the following ways:
<ul class="simple">
<li>All requests for <code class="docutils literal notranslate">/nextcloud</code> are encapsulated within a single <code class="docutils literal notranslate">location</code> block, namely <code class="docutils literal notranslate">location ^~ /nextcloud</code>.</li>
<li>The string <code class="docutils literal notranslate">/nextcloud</code> is prepended to all prefix paths.</li>
<li>The root of the domain is mapped to <code class="docutils literal notranslate">/var/www</code> rather than <code class="docutils literal notranslate">/var/www/nextcloud</code>, so that the URI <code class="docutils literal notranslate">/nextcloud</code> is mapped to the server directory <code class="docutils literal notranslate">/var/www/nextcloud</code>.</li>
<li>The blocks that handle requests for paths outside of <code class="docutils literal notranslate">/nextcloud</code> (i.e. <code class="docutils literal notranslate">/robots.txt</code> and <code class="docutils literal notranslate">/.well-known</code>) are pulled out of the <code class="docutils literal notranslate">location ^~ /nextcloud</code> block.</li>
<li>The block which handles <cite>/.well-known</cite> doesn’t need a regex exception, since the rule which prevents users from accessing hidden folders at the root of the Nextcloud installation no longer matches that path.</li>
</ul>
<div class="highlight-nginx notranslate"><div class="highlight"><pre># Version 2025-07-23

# Enforce HTTPS just for `/nextcloud`
 location /nextcloud {
 return 301 https://$server_name$request_uri;
 }
}

server {
 listen 443 ssl http2;
 listen [::]:443 ssl http2;
 # With NGinx &gt;= 1.25.1 you should use this instead:
 # listen 443 ssl;
 # listen [::]:443 ssl;
 # http2 on;
 server_name cloud.example.com;

# Path to the root of the domain
 root /var/www;

location ^~ /.well-known {
 # The rules in this block are an adaptation of the rules
 # in the Nextcloud `.htaccess` that concern `/.well-known`.

location = /.well-known/carddav { return 301 /nextcloud/remote.php/dav/; }
 location = /.well-known/caldav { return 301 /nextcloud/remote.php/dav/; }

# Let Nextcloud&#39;s API for `/.well-known` URIs handle all other
 # requests by passing them to the front-end controller.
 return 301 /nextcloud/index.php$request_uri;
 }

location ^~ /nextcloud {
 # set max upload size and increase upload timeout:
 client_max_body_size 512M;
 client_body_timeout 300s;
 fastcgi_buffers 64 4K;

# Proxy and client response timeouts
 # Uncomment an increase these if facing timeout errors during large file uploads
 #proxy_connect_timeout 60s;
 #proxy_send_timeout 60s;
 #proxy_read_timeout 60s;
 #send_timeout 60s;

# Enable gzip but do not remove ETag headers
 gzip on;
 gzip_vary on;
 gzip_comp_level 4;
 gzip_min_length 256;
 gzip_proxied expired no-cache no-store private no_last_modified no_etag auth;
 gzip_types application/atom+xml text/javascript application/javascript application/json application/ld+json application/manifest+json application/rss+xml application/vnd.geo+json application/vnd.ms-fontobject application/wasm application/x-font-ttf application/x-web-app-manifest+json application/xhtml+xml application/xml font/opentype image/bmp image/svg+xml image/x-icon text/cache-manifest text/css text/plain text/vcard text/vnd.rim.location.xloc text/vtt text/x-component text/x-cross-domain-policy;

# Pagespeed is not supported by Nextcloud, so if your server is built
 # with the `ngx_pagespeed` module, uncomment this line to disable it.
 #pagespeed off;

# The settings allows you to optimize the HTTP2 bandwidth.
 # See https://blog.cloudflare.com/delivering-http-2-upload-speed-improvements/
 # for tuning hints
 client_body_buffer_size 512k;

# HSTS settings
 # WARNING: Only add the preload option once you read about
 # the consequences in https://hstspreload.org/. This option
 # will add the domain to a hardcoded list that is shipped
 # in all major browsers and getting removed from this list
 # could take several months.
 #add_header Strict-Transport-Security &quot;max-age=31536000; includeSubDomains; preload&quot; always;

# HTTP response headers borrowed from Nextcloud `.htaccess`
 add_header Referrer-Policy &quot;no-referrer&quot; always;
 add_header X-Content-Type-Options &quot;nosniff&quot; always;
 add_header X-Frame-Options &quot;SAMEORIGIN&quot; always;
 add_header X-Permitted-Cross-Domain-Policies &quot;none&quot; always;
 add_header X-Robots-Tag &quot;noindex, nofollow&quot; always;

# Remove X-Powered-By, which is an information leak
 fastcgi_hide_header X-Powered-By;

# Specify how to handle directories -- specifying `/nextcloud/index.php$request_uri`
 # here as the fallback means that Nginx always exhibits the desired behaviour
 # when a client requests a path that corresponds to a directory that exists
 # on the server. In particular, if that directory contains an index.php file,
 # that file is correctly served; if it doesn&#39;t, then the request is passed to
 # the front-end controller. This consistent behaviour means that we don&#39;t need
 # to specify custom rules for certain paths (e.g. images and other assets,
 # `/updater`, `/ocs-provider`), and thus
 # `try_files $uri $uri/ /nextcloud/index.php$request_uri`
 # always provides the desired behaviour.
 index index.php index.html /nextcloud/index.php$request_uri;

# Rule borrowed from `.htaccess` to handle Microsoft DAV clients
 location = /nextcloud {
 if ( $http_user_agent ~ ^DavClnt ) {
 return 302 /nextcloud/remote.php/webdav/$is_args$args;
 }
 }

# Rules borrowed from `.htaccess` to hide certain paths from clients
 location ~ ^/nextcloud/(?:build|tests|config|lib|3rdparty|templates|data)(?:$|/) { return 404; }
 location ~ ^/nextcloud/(?:\.|autotest|occ|issue|indie|db_|console) { return 404; }

# Ensure this block, which passes PHP files to the PHP process, is above the blocks
 # which handle static assets (as seen below). If this block is not declared first,
 # then Nginx will encounter an infinite rewriting loop when it prepends
 # `/nextcloud/index.php` to the URI, resulting in a HTTP 500 error response.
 location ~ \.php(?:$|/) {
 # Required for legacy support
 rewrite ^/nextcloud/(?!index|remote|public|cron|core\/ajax\/update|status|ocs\/v[12]|updater\/.+|ocs-provider\/.+|.+\/richdocumentscode(_arm64)?\/proxy) /nextcloud/index.php$request_uri;

fastcgi_split_path_info ^(.+?\.php)(/.*)$;
 set $path_info $fastcgi_path_info;

try_files $fastcgi_script_name =404;

include fastcgi_params;
 fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
 fastcgi_param PATH_INFO $path_info;
 fastcgi_param HTTPS on;

fastcgi_param modHeadersAvailable true; # Avoid sending the security headers twice
 fastcgi_param front_controller_active true; # Enable pretty urls
 fastcgi_pass php-handler;

fastcgi_intercept_errors on;
 fastcgi_request_buffering on; # Required as PHP-FPM does not support chunked transfer encoding and requires a valid ContentLength header.

# PHP-FPM 504 response timeouts
 # Uncomment and increase these if facing timeout errors during large file uploads
 #fastcgi_read_timeout 60s;
 #fastcgi_send_timeout 60s;
 #fastcgi_connect_timeout 60s;

fastcgi_max_temp_file_size 0;
 }

# Serve static files
 location ~ \.(?:css|js|mjs|svg|gif|ico|jpg|png|webp|wasm|tflite|map|ogg|flac|mp4|webm)$ {
 try_files $uri /nextcloud/index.php$request_uri;
 # HTTP response headers borrowed from Nextcloud `.htaccess`
 add_header Cache-Control &quot;public, max-age=15778463$asset_immutable&quot;;
 add_header Referrer-Policy &quot;no-referrer&quot; always;
 add_header X-Content-Type-Options &quot;nosniff&quot; always;
 add_header X-Frame-Options &quot;SAMEORIGIN&quot; always;
 add_header X-Permitted-Cross-Domain-Policies &quot;none&quot; always;
 add_header X-Robots-Tag &quot;noindex, nofollow&quot; always;
 access_log off; # Optional: Don&#39;t log access to assets
 }

location ~ \.(otf|woff2?)$ {
 try_files $uri /nextcloud/index.php$request_uri;
 expires 7d; # Cache-Control policy borrowed from `.htaccess`
 access_log off; # Optional: Don&#39;t log access to assets
 }

# Rule borrowed from `.htaccess`
 location /nextcloud/remote {
 return 301 /nextcloud/remote.php$request_uri;
 }

location /nextcloud {
 try_files $uri $uri/ /nextcloud/index.php$request_uri;
 }
 }
}
</pre></div>
</div>
</section>
<section id="tips-and-tricks">
<h2>Tips and tricks<a class="headerlink" href="#tips-and-tricks" title="Link to this heading"></a></h2>
<section id="php-handler-configuration-avoiding-502-bad-gateway">
<h3>PHP-Handler Configuration / Avoiding “502 Bad Gateway”<a class="headerlink" href="#php-handler-configuration-avoiding-502-bad-gateway" title="Link to this heading"></a></h3>
The <code class="code docutils literal notranslate">server</code> line within the <code class="code docutils literal notranslate">upstream php-handler</code> above needs to be adjusted to reflect your local PHP FPM configuration. It must match whatever is configured for the <code class="code docutils literal notranslate">listen</code> directive within the PHP FPM pool you’ll be using for NC.
Many Linux distributions define a listener for a default PHP-FPM pool called <code class="code docutils literal notranslate">www</code> in a file called <code class="code docutils literal notranslate">www.conf</code> located somewhere like <code class="code docutils literal notranslate">/etc/php/8.1/pool.d</code>.
Look for the line that is set to something like:
<code class="code docutils literal notranslate">listen = /var/run/php/php-fpm.sock</code>
or
<code class="code docutils literal notranslate">listen = 127.0.0.1:9000</code>
If PHP FPM will be running on the same host as NGINX (it’s probably a safe assumption it will be if you’re unsure), it is recommended you use the UNIX socket (i.e. <code class="code docutils literal notranslate">/var/run/php/php-fpm.sock</code>) rather than TCP (<code class="code docutils literal notranslate">127.0.0.1:9000</code>) for maximum performance (though either will work as long as your NGINX and PHP FPM configurations match).
After deciding how you’d prefer to connect NGINX with PHP FPM (and, if necessary, updating your local PHP FPM configuration and restarting FPM), set your NGINX configuration’s <code class="code docutils literal notranslate">upstream php-handler</code> <code class="code docutils literal notranslate">server</code> to match your preference (Note: If using UNIX sockets, prepend <code class="code docutils literal notranslate">unix:</code> in the NGINX configuration, but not in your PHP FPM <code class="code docutils literal notranslate">www.conf</code>).
</section>
<section id="suppressing-log-messages">
<h3>Suppressing log messages<a class="headerlink" href="#suppressing-log-messages" title="Link to this heading"></a></h3>
If you’re seeing meaningless messages in your logfile, for example <code class="docutils literal notranslate">client
denied by server configuration: /var/www/data/htaccesstest.txt</code>, add this section to
your nginx configuration to suppress them:
<div class="highlight-nginx notranslate"><div class="highlight"><pre>location = /data/htaccesstest.txt {
 allow all;
 log_not_found off;
 access_log off;
}
</pre></div>
</div>
</section>
<section id="javascript-js-or-css-css-files-not-served-properly">
<h3>JavaScript (.js) or CSS (.css) files not served properly<a class="headerlink" href="#javascript-js-or-css-css-files-not-served-properly" title="Link to this heading"></a></h3>
A common issue with custom nginx configs is that JavaScript (.js)
or CSS (.css) files are not served properly leading to a 404 (File not found)
error on those files and a broken webinterface.
This could be caused by the:
<div class="highlight-nginx notranslate"><div class="highlight"><pre>location ~* \.(?:css|js)$ {
</pre></div>
</div>
block shown above not located below the:
<div class="highlight-nginx notranslate"><div class="highlight"><pre>location ~ \.php(?:$|\/) {
</pre></div>
</div>
block. Other custom configurations like caching JavaScript (.js)
or CSS (.css) files via gzip could also cause such issues.
Another cause of this issue could be not properly including mimetypes in the
http block, as shown <a class="reference external" href="https://www.nginx.com/resources/wiki/start/topics/examples/full/">here.</a>
</section>
<section id="upload-of-files-greater-than-10-mib-fails">
<h3>Upload of files greater than 10 MiB fails<a class="headerlink" href="#upload-of-files-greater-than-10-mib-fails" title="Link to this heading"></a></h3>
If you configure nginx (globally) to block all requests to (hidden) dot files,
it may be not possible to upload files greater than 10 MiB using the webpage
due to Nextclouds requirement to upload the file to a URL ending with <code class="docutils literal notranslate">/.file</code>.
You may require to change:
<div class="highlight-nginx notranslate"><div class="highlight"><pre>location ~ /\. {
</pre></div>
</div>
to the following to re-allow file uploads:
<div class="highlight-nginx notranslate"><div class="highlight"><pre>location ~ /\.(?!file).* {
</pre></div>
</div>
See <a class="reference external" href="https://github.com/nextcloud/server/issues/8802">issue #8802 on nextcloud/server</a> for more information.
Other parameters besides the above are relevant to uploading large files (see <a class="reference internal" href="../configuration_files/big_file_upload_configuration.html#uploading-big-files">Uploading big files &gt; 512MB</a>).
</section>
<section id="login-loop-without-any-clue-in-access-log-error-log-nor-nextcloud-log">
<h3>Login loop without any clue in access.log, error.log, nor nextcloud.log<a class="headerlink" href="#login-loop-without-any-clue-in-access-log-error-log-nor-nextcloud-log" title="Link to this heading"></a></h3>
If you after fresh installation (Centos 7 with nginx) have problem with first login, you should as first check these files:
<div class="highlight-bash notranslate"><div class="highlight"><pre>tail /var/www/nextcloud/data/nextcloud.log
tail /var/log/nginx/access.log
tail /var/log/nginx/error.log
</pre></div>
</div>
If you just see some correct requests in access log, but no login happens, you check access rights for php session and wsdlcache directory. Try to check permissions and execute change if needed:
<div class="highlight-bash notranslate"><div class="highlight"><pre>chown nginx:nginx /var/lib/php/session/
chown root:nginx /var/lib/php/wsdlcache/
chown root:nginx /var/lib/php/opcache/
</pre></div>
</div>
</section>
</section>
</section>

</div>
 </div>
 <footer><div class="rst-footer-buttons" role="navigation" aria-label="Footer">
 <a href="selinux_configuration.html" class="btn btn-neutral float-left" title="SELinux configuration" accesskey="p" rel="prev"> Previous</a>
 <a href="harden_server.html" class="btn btn-neutral float-right" title="Hardening and security guidance" accesskey="n" rel="next">Next </a>
 </div>

<hr/>

<div role="contentinfo">
 &#169; Copyright 2016-2026 Nextcloud GmbH and Nextcloud contributors.
 </div>

</footer>
 </div>
 </div>
 </section>
 </div>

<div class="rst-versions" data-toggle="rst-versions" role="note" aria-label="versions">
 
 ☁️ latest
 
 
 <div class="rst-other-versions">
 <dl>
 <dt>☁️ Versions</dt>
 
 <dd style="width: 32%">
 <a href="https://docs.nextcloud.com/server/latest/admin_manual"
 
 style="color: var(--dark-link-color);"
 
 >
 latest
 </a>
 </dd>
 
 <dd style="width: 32%">
 <a href="https://docs.nextcloud.com/server/stable/admin_manual"
 
 >
 stable
 </a>
 </dd>
 
 <dd style="width: 32%">
 <a href="https://docs.nextcloud.com/server/32/admin_manual"
 
 >
 32
 </a>
 </dd>
 
 <dd style="width: 32%">
 <a href="https://docs.nextcloud.com/server/31/admin_manual"
 
 >
 31
 </a>
 </dd>
 
 </dl>
 </div>
 </div>
<script>
 jQuery(function () {
 SphinxRtdTheme.Navigation.enable(true);
 });
 </script>

</body>
</html>

Cancel