Configuring Memory Caching In Nextcloud


1. Install APCu and Redis:

$ sudo apt install php-apcu redis-server php-redis

$ sudo service apache2 restart

2. Edit the configuration file

$ sudo nano /etc/redis/redis.conf

Ctrl+w and enter “port” to search for and change:

port 6379


port 0

Then Ctrl+w to search for and uncomment:

unixsocket /var/run/redis/redis.sock

and uncomment the line below and change the permissions to 770:

unixsocketperm 700


unixsocketperm 770

Ctrl+x, the ‘Y' to save and exit.

3. Add the Redis user redis to the www-data group:

$ sudo usermod -a -G redis www-data

4. Restart Apache:

$ sudo service apache2 restart

5. Start Redis server:

$ sudo service redis-server start

6. Add the caching configuration to the Nextcloud config file:

$ sudo nano /var/www/html/nextcloud/config/config.php

Add the following right after the last line and before the ‘);' (before the last parenthesis and semicolon)

'memcache.local' => '\\OC\\Memcache\\Redis',
'memcache.distributed' => '\\OC\\Memcache\\Redis',
'memcache.locking' => '\\OC\\Memcache\\Redis',
'filelocking.enabled' => 'true',
'redis' => 
array (
'host' => 'localhost',
'port' => 0,
'timeout' => 0.0,

Ctrl+x, then ‘Y' to save and exit.

NOTE: If you are getting and Internal Server Error with the config above, please see the UPDATED comments below

To verify Redis is enabled to start on boot:

$ sudo systemctl enable redis-server

Now when you go to the admin page in Nextcloud, there should no longer be a ‘Security & Setup Warning' about memory caching not being enabled.

Also see How To Install Memcached to install Memcached if only using APCu



This web app has been tested on DigitalOcean. This app can also be installed using other hosts such as Amazon AWS, Google Cloud, Microsoft Azure, Vultr and others.

Installation & Maintenance

If you would like to get this app installed, maintained or need training, Contact Me to get current rates.

12 thoughts on “Configuring Memory Caching In Nextcloud

  1. Hello,
    sorry for the trouble, I have a difficulty: I followed step by step your directions, Nextcloud tells me that everything is fine with regard to the memcache, but I can not upload new files or create new ones. Where am I wrong?
    Thanks so much!


    1. Somehow I think I have come across this problem in Nextcloud before but I can’t remember how I resolved it (& I didn’t write it down). But it sounds like the first place to start is your user permissions on the server. I would make sure that you chown the nextcloud and data directory, example:

      $ sudo chown -R www-data:www-data /var/www/html/nextcloud/

      and chmod the data directory, example:

      $ sudo chmod -R 0770 /var/www/html/nextcloud/data

      and finally if that doesn’t work, you can try to add your user permissions to nextcloud, example:

      $ sudo setfacl -R -m "u:user:rwx" /var/www/html/data/user

      where the first user is your server username and the second is your username in Nextcloud. If any of this helps or you find the solution, could you kindly post it? Thanks

    1. Hello, since Renzo above first posted this issue I have not had the same problem. I did do 2 changes in Nextcloud’s config file above which works perfectly, changing

      'memcache.local' => '\OC\Memcache\APCu',


      'memcache.local' => '\\OC\\Memcache\\Redis',

      and adding:

      'memcache.distributed' => '\\OC\\Memcache\\Redis',

      However, this still may not solve your issue. This same issue has also been posted on Jason Bayton’s forum and seems only to affect very few people. Why? I couldn’t tell you because again, I have never had this problem. The issue is further discuseed here – and further down the thread here – – but it seems that it was not solved. It appears Renzo was seeking answers and Jason Bayton, who was attempting to solve the issue, could only finally state:

      At this point without seeing your environment first hand I’m not sure what’s wrong, sorry.
      You could maybe swap redis for aPCU in your config.php file and see if that resolves the black page, but that doesn’t fix redis itself.

      So, in summary, I think this is a rare and isolated issue that has something to do with one’s operating environment and not with the code (unless changing the config lines above have any affect). And again, for anyone that has this issue and has found a solution, please post it!

      1. And if you are using MariaDB, try this: (taken from an error I once had when installing Nextcloud – Error #2 at the bottom –

        change the binlog format in MariaDB from ‘row’ to ‘mixed’

        $ sudo nano /etc/mysql/my.cnf

        CTRL+W to find ‘binlog_format’

        uncomment and change




        Ctrl+X, then ‘Y’ to save and exit

        $ sudo service mariadb restart

        and more info on the binary log is here:

  2. i had to manually edit the path, form the configuration file.
    unixsocket /var/run/redis/redis-server.sock

    ‘host’ => ‘/var/run/redis/redis-server.sock’,

    that worked for me .!!

  3. missing backslashes in line ‘memcache.local
    host doesn’t work, replaced by localhost
    otherwise works fine on raspbian

    ‘memcache.local’ => ‘\\OC\\Memcache\\Redis’,
    ‘memcache.distributed’ => ‘\\OC\\Memcache\\Redis’,
    ‘memcache.locking’ => ‘\\OC\\Memcache\\Redis’,
    ‘filelocking.enabled’ => ‘true’,
    ‘redis’ =>
    array (
    ‘host’ => ‘localhost’,
    ‘port’ => 0,
    ‘timeout’ => 0.0,

    1. Thank you for catching the backslashes in memcache.local – the post has been Updated!.
      It’s been a while since I’ve reviewed my config file, I also have ‘host’ => ‘localhost’, – the post has been Updated.

  4. I followed the instructions to set up memory caching with redis.
    After all i get a Internal Server Error when trying to get a nextcloud session.
    Pi4, RPi OS Buster 64, Postgresql, apache2

    1. I recently had the same Internal Server Error for what appears to be no reason at all (server update? new codebase?)… my new config settings are below:

      I changed the lines:

      'memcache.local' => '\\OC\\Memcache\\Redis',
      'memcache.distributed' => '\\OC\\Memcache\\Redis',
      'memcache.locking' => '\\OC\\Memcache\\Redis',
      'filelocking.enabled' => 'true',
      'redis' => 
      array (
        'host' => 'localhost',
        'port' => 0,
        'timeout' => 0.0,

      to (working config):

      'memcache.local' => '\\OC\\Memcache\\APCu',
      'memcache.distributed' => '\\OC\\Memcache\\Memcached',
      'redis' =>
       array (
         'host' => 'localhost',
         'port' => 0,
         'timeout' => 0.0,

      I had to eliminate the lines

      'memcache.locking' => '\\OC\\Memcache\\Redis',


      'filelocking.enabled' => 'true',

      and change the caching from Redis to APCu and Memcached for the other two lines. Hope this helps.

Leave a Reply

Your email address will not be published. Required fields are marked *

This site uses Akismet to reduce spam. Learn how your comment data is processed.