View source for NextCloud

{{ContainerInfo
|image = Nextcloud.png
|Domain = [https://cloud.flowerhouse.at cloud.flowerhouse.at]
|IP = 192.168.88.9
|MAC = B2:62:86:48:66:66
|Privileged = Yes
|OS = Debian Buster
|RAM = 1024MB
|Cores = 2
|Files = [[config.php]]<br>[[reverse-proxy.conf]]
}}

<p>The NextCloud-LXC is reachable under <syntaxhighlight lang="Bash" inline>192.168.88.9</syntaxhighlight> which is located in the ServerVLAN.</p>
<p>The subdomain is [https://cloud.flowerhouse.at cloud.flowerhouse.at] which is handled by the [[ReverseProxy]].</p>
<p>Check NextCloud security [https://scan.nextcloud.com/ here].</p>
__TOC__
== Basic Setup ==
=== Apache, MariaDB and PHP ===
<p>For the NextCloud installation to work in an Container, it must be privileged, otherwise it is impossible to mount an external storage</p>
<p>NextCloud runs on Apache2 and uses MariaDB, so following packages have to be installed:</p>
<syntaxhighlight lang="console">
apt-get install apache2 libapache2-mod-php mariadb-server php-xml php-cli php-cgi php-mysql php-mbstring php-gd php-curl php-zip php-intl wget unzip
</syntaxhighlight>
<p>''php.ini'' has to be edited for recommended settings:</p>
<syntaxhighlight lang="console">
nano /etc/php/7.3/apache2/php.ini
</syntaxhighlight>

<p>Change the following settings:</p>
<syntaxhighlight lang="console">
memory_limit = 1024M
upload_max_filesize = 1000M
post_max_size = 1000M
; 3600s = 1h
max_execution_time = 3600
date.timezone = Europe/Berlin
</syntaxhighlight>

<p>Start and enable all services:</p>
<syntaxhighlight lang="console" line>
systemctl start apache2
systemctl start mariadb
systemctl enable apache2
systemctl enable mariadb
</syntaxhighlight>

=== Configure Database ===
<p>Make secure:</p>
<syntaxhighlight lang="console">
mysql_secure_installation
</syntaxhighlight>

<p>Create database and user for NextCloud and use random generated password:</p>
<syntaxhighlight lang="console" line>
mysql -u root -p
CREATE DATABASE nextclouddb;
CREATE USER 'nextclouduser'@'localhost' IDENTIFIED BY 'RNGPASSWORD';
GRANT ALL ON nextclouddb.* TO 'nextclouduser'@'localhost';
FLUSH PRIVILEGES;
EXIT;
</syntaxhighlight>

=== Download NextCloud ===
<p>Download [https://nextcloud.com/de/install/#instructions-server latest] NextCloud-Version:</p>
<syntaxhighlight lang="console" line>
cd /var/www
wget https://download.nextcloud.com/server/releases/nextcloud-20.0.7.zip
unzip nextcloud-20.0.7.zip
rm nextcloud-20.0.7.zip
rm -r html
</syntaxhighlight>

=== Configure Apache ===
<p>Create an Apache virtual host configuration file:</p>
<syntaxhighlight lang="console">
nano /etc/apache2/sites-available/nextcloud.conf
</syntaxhighlight>

<p>Add the following lines:</p>
<syntaxhighlight lang="apache" line>
<VirtualHost *:80>
     ServerAdmin admin@localhost
     DocumentRoot /var/www/nextcloud/
     ServerName cloud.flowerhouse.at

     <Directory /var/www/nextcloud/>
        Options +FollowSymlinks
        AllowOverride All
        Require all granted
          <IfModule mod_dav.c>
            Dav off
          </IfModule>
        SetEnv HOME /var/www/nextcloud
        SetEnv HTTP_HOME /var/www/nextcloud
     </Directory>

     ErrorLog ${APACHE_LOG_DIR}/error.log
     CustomLog ${APACHE_LOG_DIR}/access.log combined

</VirtualHost>
</syntaxhighlight>

<p>Enable the Apache virtual host file and other required modules:</p>
<syntaxhighlight lang="console" line>
a2ensite nextcloud.conf
a2enmod rewrite
a2enmod headers
a2enmod env
a2enmod dir
a2enmod mime
</syntaxhighlight>

<p>Restart apache service:</p>
<syntaxhighlight lang="console">
systemctl restart apache2
</syntaxhighlight>

=== Trusted Domains ===
<p>Add trusted domain:</p>
<syntaxhighlight lang="console">
nano /var/www/nextcloud/config/config.php
</syntaxhighlight>

<p>Add to file:</p>
<syntaxhighlight lang="php" line>
'trusted_domains' =>
  array (
    0 => '192.168.88.10',
    1 => 'cloud.flowerhouse.at',
  ),
</syntaxhighlight>

<p>Restart apache service:</p>
<syntaxhighlight lang="console">
systemctl restart apache2
</syntaxhighlight>

=== NFS-Share ===
<p>Install required packages for nfs-share:</p>
<syntaxhighlight lang="console">
apt install nfs-common nfs4-acl-tools
</syntaxhighlight>

<p>Mount the nfs-share (NAS) to the data folder where all the user files will be stored</p>
<syntaxhighlight lang="console">
mount -t nfs 192.168.88.5:/mnt/zpool1/NextCloud /home/data/
</syntaxhighlight>

<p>Edit fstab to mount at boot:</p>
<syntaxhighlight lang="console">
nano /etc/fstab
</syntaxhighlight>

<p>Add following line at the end of file:</p>
<syntaxhighlight lang="console">
192.168.88.5:/mnt/zpool1/NextCloud /home/data/ nfs defaults 0 0
</syntaxhighlight>

<p>Re-scan all files after mounting to update file database
<syntaxhighlight lang="console">
sudo -u www-data php /var/www/nextcloud/occ files:scan --all
</syntaxhighlight>

=== Web Interface ===
<p>After setting up the [[Reverse-Proxy]] you can access the web interface and make the last configurations</p>
<p>Add admin account and the data folder path <syntaxhighlight lang="Bash" inline>/home/data/</syntaxhighlight>.</p>
<p>At last add your database credentials and finish setup:</p>
* User: nextclouduser
* PW: RNGPASSWORD
* Database: nextclouddb
* Host: localhost

=== Update ===
<p>Use following command to update nextcloud to latest version:</p>
<syntaxhighlight lang="console">
sudo -u www-data php --define apc.enable_cli=1 /var/www/nextcloud/updater/updater.phar
</syntaxhighlight>

=== Maintenance Mode ===
<p>Use following command to disable maintenance mode:</p>
<syntaxhighlight lang="console">
sudo -u www-data php --define apc.enable_cli=1 /var/www/nextcloud/occ maintenance:mode --off
</syntaxhighlight>

== Additional Configuration ==
<p>When NextCloud is running, it is recommended to look under ''Settings->Overview'' if there are some errors and warnings listed and fix them.</p>
<p>Following are some fixes to already occured problems.</p>

=== Looping Connection Wizard ===
<p>When using an [[Reverse-Proxy]] the Connection Wizard is looping between "login" and "grant access".</p>
<p>The solution is to edit the NextCloud ''config.php'':</p>
<syntaxhighlight lang="console">
nano /var/www/nextcloud/config/config.php
</syntaxhighlight>

<p>Add the following line to the config array:</p>
<syntaxhighlight lang="php">
'overwriteprotocol' => 'https',
</syntaxhighlight>

=== PHP-Memory-Cache ===
<p>Install a local memory caching backend:</p>
<syntaxhighlight lang="console" line>
apt-get install php-apcu
service apache2 restart
</syntaxhighlight>

<p>Edit the NextCloud config.php:</p>
<syntaxhighlight lang="console">
nano /var/www/nextcloud/config/config.php
</syntaxhighlight>

<p>Add the following line to the config array:</p>
<syntaxhighlight lang="php">
'memcache.local' => '\OC\Memcache\APCu',
</syntaxhighlight>

=== Max. Upload-Size ===
==== NextCloud ====
<p>Edit ''php.ini'':</p>
<syntaxhighlight lang="console">
nano /etc/php/7.3/apache2/php.ini
</syntaxhighlight>

<p>Change the following settings:</p>
<syntaxhighlight lang="console">
memory_limit = 1024M
upload_max_filesize = 1000M
post_max_size = 1000M
</syntaxhighlight>

==== Reverse-Proxy ====
<p>Edit ''nginx.conf'':</p>
<syntaxhighlight lang="console">
nano /etc/nginx/nginx.conf
</syntaxhighlight>

<p>Change following line to:</p>
<syntaxhighlight lang="nginx">
client_max_body_size 1000M;
</syntaxhighlight>

<p>Reload [[Reverse-Proxy]] configuration:</p>
<syntaxhighlight lang="console">
nginx -s reload
</syntaxhighlight>

<p>In the [[reverse-proxy.conf]] following entry must also be adjusted:</p>
<syntaxhighlight lang="nginx">
client_max_body_size 1000M;
</syntaxhighlight>

=== DataBase ===
==== Missing Indizes ====
<p>If the database is missing indizes run:</p>
<syntaxhighlight lang="console" line>
service apache2 stop
sudo -u www-data php /var/www/nextcloud/occ db:add-missing-indices
service apache2 start
</syntaxhighlight>

==== Convert to 'big int' ====
<p>If a warning says that some tables should be converted to 'big int' run:</p>
<syntaxhighlight lang="console" line>
service apache2 stop
sudo -u www-data php /var/www/nextcloud/occ db:convert-filecache-bigint
service apache2 start
</syntaxhighlight>

=== External Storage ===
https://docs.nextcloud.com/server/latest/admin_manual/configuration_files/external_storage_configuration_gui.html

== Sources ==
* [https://www.howtoforge.com/tutorial/how-to-install-nextcloud-on-debian-10/ NextCloud on Debian]
* [https://www.youtube.com/watch?v=QB_FEWJ9BB4 Nextcloud Installation auf Ubuntu 20.04 Server]
* [https://github.com/nextcloud/server/pull/23606/files Bug-Fix]
* [https://linuxhint.com/mount_nfs_share_debian/ nfs-share]
* [https://help.nextcloud.com/t/connection-wizard-is-looping-between-log-in-and-grant-access/46809/4 Looping Connection Wizard]