nextcloud / nextcloud/documentation

Admin documentation - possible limitations at Redis server after upgrade to Nc26

Open
#11,116 4 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

1. to develop feature: caching manual: admin
Dominant language
JavaScript
Stars
628
Forks
2.5k
Avg merge
2d 11h
Merged PRs (30d)
135

Description

From a customer ticket, could be applied here:
https://github.com/nextcloud/documentation/blob/master/admin_manual/release_notes/upgrade_to_26.rst
https://github.com/nextcloud/documentation/blob/master/admin_manual/office/troubleshooting.rst

Problem overview

After upgrading from v24 to v26 there could appear some performance issues.

Web server - Debian12
Redis server - Debian12, redis-server v7.0.11
PHP version: 8.2

Common errors:

  • /apps/files/","message":"session_start(): Failed to read session data: redis (path: tcp://[instance:port](http://instance:port)?timeout=10) at /var/ www/nextcloud/lib/private/Session/Internal.php#221"
    -Access forbidden. CSRF check failed at registration
  • CSRF check not passed at file upload

Performance bottleneck when creating the redis data was suspected:

  • During high-load hours (working time) upload a 1GB text-file fails
  • At evening upload of 10GB file goes without problems
  • It was also not possible to log out correctly in the web browser
  • The command "redis-cli monitor" on the redis-server shows many requests for the user for this time.
Solution

A UFW firewall is running on the redis server. The value `net.netfilter.nf_conntrack_max" was only set to 8192, but the number of simultaneous connections ranges between 6,000 and 12,000. Default value, according to documentation should be around 65536 or higher

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Review admin_manual/release_notes/upgrade_to_26.rst and admin_manual/office/troubleshooting.rst, starting with the upgrade notes and the reported Redis connection errors. Document the possible performance and session issues after upgrading, including the nf_conntrack_max limitation and the reported setting guidance. Done means the relevant admin documentation clearly describes the symptoms and solution.

Written by the indexing model from the issue text.

Assessment

Tech stack
redis
Domain
documentation
Issue type
Documentation
Difficulty
2/5
Estimated time
1-3 hours
Activity status
Quiet
Clarity
Mostly clear
Newbie friendliness
58/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.