Skip to content

docs(admin): Add more details about configuring APCu #12134

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
nickvergessen merged 2 commits into from
Aug 28, 2024
Merged

docs(admin): Add more details about configuring APCu #12134

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
8ee35d1
docs(admin): Add more details about configuring APCu
juliusknorr Aug 27, 2024
e1fae84
docs(admin): Add upgrade to 31 section
juliusknorr Aug 27, 2024
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
18 changes: 18 additions & 0 deletions admin_manual/configuration_server/caching_configuration.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -121,6 +121,24 @@ Refresh your Nextcloud admin page, and the cache warning should disappear.
config file or append ``--define apc.enable_cli=1`` to the cron job call.


Depending on your installation size and the number of users and interactions
with the system you may want to adapt the ``apc.shm_size`` setting in your
``php.ini``. The default value is 32M which is usually too low for Nextcloud. A
good starting point is 128M. If you have a lot of users and/or a lot of apps
Comment on lines +126 to +127
Copy link
Member

@MichaIng MichaIng Oct 29, 2024 •
edited
Loading

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I just found this in another context. As my two instances show less than 1 MiB APCu usage, thought with 5 or less users, from which user number on is 128 MiB a good starting point? Since we have a test now, maybe it is not required to recommend changing the default, unless the admin panel/test says so, to avoid having many admins of mid and small size instances configuring a too large APCu cache, unnecessarily blocking system memory.

installed you may want to increase this value further. Keep in mind that this
memory needs to be available in your system's memory and kept in mind when
sizing the amount of workers on your server.

A frequenly resetting cache can lead to unexpected slow downs when the cache is
being cleared and refilled.

There is an admin check trying to detect too low memory sizing, but make sure to
monitor the APCu cache status to see if the cache is full and if you need to
increase the size. `APCu provides a script
<https://github.com/krakjoe/apcu/blob/master/apc.php>`_ that can help with this,
otherwise the `serverinfo app <https://github.com/nextcloud/serverinfo>`_ in
Nextcloud can also show the APCu cache status.

Redis
-----

Expand Down
1 change: 1 addition & 0 deletions admin_manual/release_notes/index.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -14,6 +14,7 @@ These sub pages will cover the most important changes in Nextcloud, as well as s
.. toctree::
:maxdepth: 1

upgrade_to_31.rst
upgrade_to_30.rst
upgrade_to_28.rst
upgrade_to_27.rst
Expand Down
13 changes: 13 additions & 0 deletions admin_manual/release_notes/upgrade_to_31.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,13 @@
=======================
Upgrade to Nextcloud 31
=======================

System requirements
-------------------

* PHP 8.1 is now deprecated but still supported.

PHP configuration
-----------------

We have a new setup warning to check if the memory reserved for APCu is high enough. If you see this warning, you should increase the memory reserved for APCu. You can do this by increasing the value of the ``apc.shm_size`` directive in your ``php.ini`` file. It is generally advised to review this value and increase it if necessary depending on your instance size.