Skip to content
This repository has been archived by the owner on Feb 20, 2019. It is now read-only.

Backport nginx fastcgi updates #3504

Merged
merged 1 commit into from
Nov 8, 2017
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
23 changes: 19 additions & 4 deletions admin_manual/installation/nginx_configuration.rst
Original file line number Diff line number Diff line change
Expand Up @@ -40,6 +40,20 @@ data in transit.
- Remove all **ssl_** entries.
- Remove **fastcgi_params HTTPS on;**

**Note 1:**

| ``fastcgi_buffers 8 4K;``
| Do not set the number of buffers over 63, in our example it is set to 8.
| When exeeding, big file downloads can possibly consume a lot of system memory over time and cause problems especially on low-mem systems.

**Note 2:**

| ``fastcgi_ignore_headers X-Accel-Buffering;``
| From ownCloud version 10.0.4 on, a header statement will be sent to nginx not to use buffers to avoid problems with problematic ``fastcgi_buffers`` values. See note above.
| If these values are properly set and no problems are expected, you can turn on this statement to reenable buffering overriding the sent header.
| In case you use an earlier version of ownCloud or can´t change the buffers, or you can´t remove a existing ignore header statement, you can explicitly set ``fastcgi_buffering off;``
| These statements are used either or but not together.

ownCloud in the webroot of NGINX
================================

Expand Down Expand Up @@ -121,7 +135,8 @@ your NGINX installation.

# set max upload size
client_max_body_size 512M;
fastcgi_buffers 64 4K;
fastcgi_buffers 8 4K; # Please see note 1
fastcgi_ignore_headers X-Accel-Buffering; # Please see note 2

# Disable gzip to avoid the removal of the ETag header
# Enabling gzip would also make your server vulnerable to BREACH
Expand Down Expand Up @@ -158,7 +173,6 @@ your NGINX installation.
fastcgi_read_timeout 180; # increase default timeout e.g. for long running carddav/ caldav syncs with 1000+ entries
fastcgi_pass php-handler;
fastcgi_intercept_errors on;
fastcgi_buffering off;
fastcgi_request_buffering off; #Available since NGINX 1.7.11
}

Expand Down Expand Up @@ -277,7 +291,9 @@ The following config should be used when ownCloud is not in your webroot but pla

# set max upload size
client_max_body_size 512M;
fastcgi_buffers 64 4K;
fastcgi_buffers 8 4K; # Please see note 1
fastcgi_ignore_headers X-Accel-Buffering; # Please see note 2


# Disable gzip to avoid the removal of the ETag header
# Enabling gzip would also make your server vulnerable to BREACH
Expand Down Expand Up @@ -315,7 +331,6 @@ The following config should be used when ownCloud is not in your webroot but pla
fastcgi_read_timeout 180; # increase default timeout e.g. for long running carddav/ caldav syncs with 1000+ entries
fastcgi_pass php-handler;
fastcgi_intercept_errors on;
fastcgi_buffering off;
fastcgi_request_buffering off; #Available since NGINX 1.7.11
}

Expand Down