nextcloud / nextcloud/documentation
Admin documentation - possible limitations at Redis server after upgrade to Nc26
Nobody has claimed this yet.
- 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 failedat registrationCSRF check not passedat 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
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- 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