How to implement Nextcloud’s High Performance Backend

How to implement Nextcloud’s High Performance Backend

Nextcloud 21 introduced the „High Performance Backend“ earlier this February. If you’re interested in optimizing the file handling performance in your instance, this tutorial might be the key you’ve been searching for!

Since it first appeared on the stage in 2016, Nextcloud has evolved in many, many ways. While the „High Performance Backend“ was already a feature that supported larger installations for Nextcloud Talk, this eponymous role now takes care of aiming at larger installations and file handling in general. While it is already on board from the scratch since February, it still needs to be activated via Nextcloud’s App Store and the command line-interface.

The High Performance Backend isn’t told to have massive effects on installations smaller than ten users, but can improve the number of requests on larger installations and more than 25 to 30 users by 30 to 35% once being implemented. Nextcloud speaks from 90% less load from polling so the impact on the instance is immense!

With the COVID crisis continuing to force employees to work from home, Nextcloud server administrators need to keep adding capacity. Nextcloud 21 will reduce the load on servers, enabling more employees to work without requiring additional hardware. At the same time, the new collaboration features improve the day to day productivity and support team members in getting more work done in less time.

(Frank Karlitschek, CEO and founder of Nextcloud GmbH)

Working with the magic

According to Nextcloud itself and, especially in combination with PHP 8.0, these performance improvements should impact nearly every server, giving a better user experience and enabling system administrators to grow the user base without having to add more hardware. Without the feature enabled, the client checks every 30 seconds to see if there have been changes on the server. With the open connection, the server notifies the client of any changes and it can begin downloading new files right away. This does not only impact file syncing, however but nearly every component you have added to your Nextcloud-instance, for example new file shares, an incoming Talk-call or a file being commented by a colleague. Web and desktop-clients don’t check whether there is a change or not all the time but get a decent signal from the specific app once this is the case.


To activate the High Performance Backend, all you need to do is install the mentioned „Client Push“-app from the App Store and run „occ notifypush:setup“ — that are the mere basics but there is still some more work to do to, for example, get the feature working for you in your specific environment. First of all, you should already have a Nextcloud-instance > 21 running and — in my case — an Apache2-webserver fueled by PHP 8.0.

After downloading and activating the app in our Nextcloud’s backend, there isn’t more to do on this site so we head to the shell and try to activate the High Performance Backend by typing

cd /var/www/nextcloud
sudo -u www-data php occ notify_push:setup

The script will run and check whether all prerequisites are met or not. If you haven’t touched anything before (and this is a step-by-step tutorial), let’s discover what is missing to get this feature running. A stroke of the „Enter“-key will start the check and discover that there isn’t any kind of push-service running on this Linux-machine, hence we need to create the service first.

Creating the service

By typing

vi /etc/systemd/system/notify_push.service

a new file is being created where the following contents should be inserted:

Description = Push daemon for Nextcloud clients

ExecStart=/var/www/nextcloud/apps/notify_push/bin/x86_64/notify_push /var/www/nextcloud/config/config.php

WantedBy =

Don’t forget to change the term https://cloud.domain.tld to match your Nextcloud’s URL and save the file afterwards. This script also assumes that your standard Nextcloud-installation is located in the /var/www/nextcloud standard-folder — if you have placed your instance in a different place, you should alter the specific lines as well!

Once this is done, enable the service by typing

systemctl enable notify_push.service --now

at your system’s shell. No re-start the installation script:

sudo -u www-data php occ notify_push:setup

Dealing with the Webserver

We slowly advance and while using the supported Apache2-webserver (and without altering our config files and enabling the modules needed) we still can’t proceed. Therefore, first enable the necessary modules

sudo a2enmod proxy
sudo a2enmod proxy_http
sudo a2enmod proxy_wstunnel

and put the following lines in your Nextcloud-related Apache2-configuration file which is, in my case, located at /etc/apache2/sites-available and named 000-default-le-ssl.conf.

ProxyPass /push/ws ws://
ProxyPass /push/
ProxyPassReverse /push/

The file should look similar to the following screenshot after your modification.

After restarting Apache by with

sudo systemctl restart apache2

we can also re-start the installation script once again by typing

sudo -u www-data php occ notify_push:setup

The script will now proceed and finally do the magic it was made for, presenting us the successful implementation of Nextcloud’s High Performance Backend!

As the last step, we should check whether Nextcloud’s config-file to see which trusted proxies are allowed to serve our instance. Have a look at the file located at /var/www/nextcloud/config/config.php in my case and look if there is a “trusted_proxies“-entry at the end of the file. Otherwise add the following string and change the first string with the fixed IP of your Nextcloud-server.

'trusted_proxies' =>
  array (
    0 => 'your.fixed.ip'
    1 => '::1',
    2 => '',

Once you don’t have a fixed IP like many servers at home have paired with a dynamic DNS-service, you can try setting the „NEXTCLOUD_URL“ to the internal ip of the server and alter the hosts-file on your machine. Further information on that topic can be found at the official GitHub-page!

Handling Cloudflare

Should you use Cloudflare to protect your private cloud from attacks and use the service’s CDN, you might encounter an error while trying to test the client push-feature. In this case, you must additionally add all Cloudflare IP-addresses as trusted proxies. These might change so it’s just valid to check them after a while. For now, adding the following entries to the “trusted_proxies“-variable should work well:

'trusted_proxies' =>
  array (
    0 => 'your.fixed.ip',
    1 => '::1',
    2 => '',
    3 => '',
    4 => '',
    5 => '',
    6 => '',
    7 => '',
    8 => '',
    9 => '',
    10 => '',
    11 => '',
    12 => '',
    13 => '',
    14 => '',
    15 => '',
    16 => '',


Within approximately 15 minutes, we managed to implement the High Performance Backend on our existing Nextcloud-installation. While, as I said above, this won’t have the biggest impact on smaller instances, it can really speed up your private Cloud when serving more users. By all means, tweaking and fine tuning your instance to get as much speed as possible is always a tricky thing but this one is implemented straight from the scratch so you won’t risk anything by activating this neat feature!

How to implement Nextcloud’s High Performance Backend
Older post

Even with a new name, Facebook won‘t be 'The Metaverse'

Newer post

Installing the latest version of PostgreSQL on Ubuntu Linux

How to implement Nextcloud’s High Performance Backend