1. Intro

These are my Nextcloud notes I've accumulated over the years.

They are specific to my setup and use.


2. Notes

The current setup uses Nextcloud snap from https://github.com/nextcloud/nextcloud-snap and runs off of a late version Ubuntu-install.

In addition to the packages included in the snap on the above URL, Let's encrypt is also used and can be enabled with nextcloud.occ commands.


2.1. How to install Nextcloud snap



2.2. Current config (2021-02-25)

$CONFIG = array (
'apps_paths' =>
array (
0 =>
array (
'path' => '/snap/nextcloud/current/htdocs/apps',
'url' => '/apps',
'writable' => false,
1 =>
array (
'path' => '/var/snap/nextcloud/current/nextcloud/extra-apps',
'url' => '/extra-apps',
'writable' => true,
'supportedDatabases' =>
array (
0 => 'mysql',
'memcache.locking' => '\\OC\\Memcache\\Redis',
'memcache.local' => '\\OC\\Memcache\\Redis',
'redis' =>
array (
'host' => '/tmp/sockets/redis.sock',
'port' => 0,
'log_type' => 'file',
'logfile' => '/var/snap/nextcloud/current/logs/nextcloud.log',
'logfilemode' => 416,
'passwordsalt' => 'XXX',
'secret' => 'XXX',
'trusted_domains' =>
array (
0 => 'localhost',
2 => '',
'datadirectory' => '/var/snap/nextcloud/common/nextcloud/data',
'dbtype' => 'mysql',
'version' => '',
'overwrite.cli.url' => 'http://localhost',
'dbname' => 'nextcloud',
'dbhost' => 'localhost:/tmp/sockets/mysql.sock',
'dbport' => '',
'dbtableprefix' => 'oc_',
'mysql.utf8mb4' => true,
'dbuser' => 'nextcloud',
'dbpassword' => 'XXX',
'installed' => true,
'instanceid' => 'ocgxt54195ka',
'mail_smtpmode' => 'smtp',
'mail_sendmailmode' => 'smtp',
'mail_from_address' => 'XXX',
'mail_domain' => 'XXXFQDNXXX',
'mail_smtpauthtype' => 'LOGIN',
'mail_smtphost' => 'mailcluster.loopia.se',
'mail_smtpport' => '587',
'maintenance' => false,
'loglevel' => 2,


2.3. Common commands

Most of these commands need to be run with sudo, or to be root.

# snap restart nextcloud.apache
# snap set nextcloud php.memory-limit=512M
# snap set nextcloud php.memory-limit=1024M
# nextcloud.occ maintenance:mode --off
# nextcloud.occ maintenance:mode --on
# nextcloud.occ files:scan --all
# snap connect nextcloud:network-observe
# nextcloud.export -abc
# nextcloud.import
# nextcloud.enable-https
Danger Will Robinssin! Experimental! Use on your own risk!
# snap set nextcloud apache.http2=true


2.4. Locations

Nextclouds writable config file is located here:


The logs can be found here:



2.5. Errors and conditions

WARNING overcommit_memory is set to 0! Background save may fail under low memory condition. To fix this issue add 'vm.overcommit_memory = 1' to /etc/sysctl.conf and then reboot or run the command 'sysctl vm.overcommit_memory=1' for this to take effect.

WARNING you have Transparent Huge Pages (THP) support enabled in your kernel. This will create latency and memory usage issues with Redis. To fix this issue run the command as root, and add it to your /etc/rc.local in order to retain the setting after a reboot. Redis must be restarted after THP is disabled.

# 'echo never > /sys/kernel/mm/transparent_hugepage/enabled'


2.6. Backup Nextcloud.snap

Examples for backup can be found below. The first bold line is what I use.



2.6.1. Backup script

The backup script is located in (my private) gitlab repo in scripts-and-stuff/nextcloud/nextcloud_export.sh.


# https://github.com/nextcloud/nextcloud-snap/wiki/How-to-backup-your-instance
# Usage: # nextcloud.export [OPTIONS] # Export data suitable for migrating servers. By default this # includes the Nextcloud database, configuration, and data # (equivalent to running nextcloud.export -abcd). # # Available options: # -h: Display this help message # -a: Include the (non-default) apps # -b: Include the database # -c: Include the config # -d: Include the data (can be quite large) /bin/find /root/nextcloud_backup -type f -name *.bz2 -mtime +10 -delete -print /snap/bin/nextcloud.export -a -b -c /usr/bin/mv /var/snap/nextcloud/common/backups/* /root/nextcloud_backup/config/ /usr/bin/tar -cvf /root/nextcloud_backup/nextcloud_config_$(date +%Y-%m-%d_%H%M%S).tar /root/nextcloud_backup/config/* /usr/bin/rm -rf /root/nextcloud_backup/config/* /usr/bin/cp -rvp /var/snap/nextcloud/current/certs /root/nextcloud_backup/ /usr/bin/tar -cvf /root/nextcloud_backup/nextcloud_certs_$(date +%Y-%m-%d_%H%M%S).tar /root/nextcloud_backup/certs/ /usr/bin/rm -rf /root/nextcloud_backup/certs/* cd /root/nextcloud_backup /usr/bin/bzip2 /root/nextcloud_backup/*.tar

The backup-files are rsynced to lanfear2 and then synced to the Nextcloud.


2.6.2. Schedule backups

Become user and then run crontab -e, add the following line to schedule a backup every day at 00:03.

3 0 * * * /home/sorin/git/scripts-and-stuff/nextcloud/nextcloud_export.sh


2.8. Tips'n'tricks

Sometimes there are file upload conflicts and extra files created. Find those conflicting files with the below commands and delete them after reviewing.

$ cd /home/sorin/Nextcloud
$ find . -type f -name "*conflict*"