Installare Nextcloud 14 su Debian Stretch¶

Nextcloud è una applicazione web che consente di creare su un proprio server un cloud personale su cui mantenere contatti, calendari, file, senza doversi appoggiare a servizi di terzi. É una soluzione ideale che consente di mantenere privati i propri dati e non perderne il controllo, fornendo al contempo un'ampia gamma di servizi via web, compresa una funzionale piattaforma di videoconferenza.

Si prenderanno in esame tutti i passi necessari per installare l'ultima versione di Nextcloud (la 14) su una Debian Stretch.

Operazioni preliminari¶

Prima di installare Nextcloud devono essere installati i servizi da cui esso dipende. Benché sia possibile usarlo in fase di test con sqlite viene comunque consigliato di utilizzare in produzione un database server esterno. Nel nostro caso utilizzeremo MySQL (o meglio MariaDB) per la cui installazione dovremo eseguire:

apt-get install mysql-server || apt-get install mariadb-server

(i due comandi sono equivalenti, da Debian Stretch MariaDB sostituisce in maniera trasparente MySQL).

L'installazione di default di MySQL/MariaDB usa però il supporto standard UTF8 di MySQL, che è un UTF8 finto a 3 byte che crea problemi non appena si userà uno qualunque dei caratteri UTF8, assolutamente legali, che non rientrano nella versione ridotta (ad esempio le emoticon).

Per questo motivo, per poter usare davvero UTF8, occorre riconfigurare opportunamente il server. Questo può essere fatto aggiungendo sotto /etc/mysql/mariadb.conf.d un ulteriore file di configurazione (ad esempio 60-nextcloud-mysqld.cnf) contenente:

[mysqld]
character-set-server = utf8mb4
collation-server = utf8mb4_general_ci
transaction_isolation = READ-COMMITTED
binlog_format = ROW
innodb_large_prefix = on
innodb_file_format = barracuda
innodb_file_per_table = 1

Si riavvii poi il servizio (con service mysql restart) prima di creare qualunque database. Una volta creato il database di Nextcloud (argomento
trattato più avanti), si controlli dalla console di MySQL con:

MariaDB [(none)]> SELECT NAME, SPACE, FILE_FORMAT FROM INFORMATION_SCHEMA.INNODB_SYS_TABLES WHERE NAME like "nextcloud%";

che tutte le tabelle abbiano Barracuda come valore della colonna FILE_FORMAT. Qualora questo non accadesse (ma se si esegue la configurazione
indicata prima di creare il database questo non avverrà) si può consultare https://docs.nextcloud.com/server/14/admin_manual/configuration_database/mysql_4byte_support.html per maggiori dettagli su come risolvere la questione.

Nextcloud è supportato da diversi web server, nel nostro caso utilizzeremo come server Apache2 con mod_php, pertanto occorrerà installare anche:

apt-get install apache2 libapache2-mod-php

Si tenga presente che il default di Debian per Apache è l'MPM event, ma PHP necessita del worker, ma questo viene installato e configurato solo se si installa Apache insieme a PHP, se l'installazione di Apache è già stata fatta il modulo di PHP potrebbe non venire configurato, in tal caso occorrerà forzare l'uso del worker effettuando la riconfigurazione di Apache con:

a2dismod mpm_event
a2enmod mpm_prefork
a2enmod php7.0

Inoltre per poter utilizzare le varie funzionalità di Nextcloud serviranno inoltre gli ulteriori pacchetti PHP:

apt-get install php-gd php-json php-mysql php-curl php-intl php-mcrypt \
  php-imagick php-xml php-zip php-bz2 php-gmp php-mbstring

se oltre alle funzionalità di base servono è necessario collegarsi a IMAP e LDAP (come backend di autenticazione) occorreranno anche:

apt-get install php-imap php-ldap

Installazione di Nextcloud¶

Per l'installazione occorre scaricare i sorgenti che si possono ottenere direttamente sul sito del progetto a partire dall'indirizzo
https://nextcloud.com/install (utilizzare il pulsante per il download per ottenere la pagina con i link). Si scarichi l'archivio della versione più recente e la relativa checksum dai collegamenti indicati nella pagina, alla stesura di queste note si è eseguito:

wget https://download.nextcloud.com/server/releases/nextcloud-14.0.2.tar.bz2
wget https://download.nextcloud.com/server/releases/nextcloud-14.0.2.tar.bz2.sha256

e si ricordi di verificare l'autenticità della checksum con la chiave GPG del progetto, dopo di che si potrà verificare la correttezza del download eseguendo nella directory dove si sono scaricati i file:

root@nextcloud:~# sha256sum -c nextcloud-14.0.2.tar.bz2.sha256 
nextcloud-14.0.2.tar.bz2: OK

a questo punto si potranno scompattare i sorgenti ed installarli nella directory di destinazione con:

tar -xvjf nextcloud-14.0.2.tar.bz2
mv nextcloud /var/www/

Si consiglia inoltre, per semplificarsi la vita durante gli aggiornamenti, di spostare la directory dei dati al di fuori di quella di installazione, per questo la si crei con:

mkdir -p /srv/nextcloud/data 
chown www-data:www-data /srv/nextcloud/data
chmod 750 /srv/nextcloud/data

Per impostare i permessi si può anche usare lo script nextcloudperm.sh allegato a questa pagina. Lo script è stato creato per gestire gli aggiornamenti, e consente di portare i permessi del codice ad uno stato in cui Apache può scrivere sui file, in modo da poter effettuare direttamente dall'interfaccia web gli aggiornamenti o le eventuali installazioni delle apps, per poi tornare ad una situazione, più sicura, in cui il server web non può più modificare il codice dell'applicativo.

In generale, a parte le directory in cui è necessario il permesso di scrittura, file e directory devono appartenere a root ed al gruppo www-data e non essere accessibili dagli altri (con permessi rispettivamente 640 e 750).

Lo script prevede come primo argomento uno fra i valori di start o stop che rispettivamente attivano la scrivibilità generale o la rimuovono riportandola ai soli file necessari. Pertanto per impostare i permessi ai valori corretti per la produzione basterà eseguire:

./nextcloudperm.sh stop
./nextcloudperm.sh start

Lo script assume come directory per il codice /var/www/nextcloud e /srv/nextcloud/data per i dati, se si esegue l'installazione altrove lo si modifichi opportunamente.

Configurazione di Apache per Nextcloud¶

Una volta installato il software occorrerà creare un virtual host dedicato (ad esempio in /etc/apache2/sites-available/nextcloud.conf) con qualcosa del tipo:

<VirtualHost *:80>
        ServerName nextcloud.truelite.it
        DocumentRoot /var/www/nextcloud
        AddDefaultCharset utf-8
    Redirect permanent / https://nextcloud.truelite.it/
</VirtualHost>
<VirtualHost *:443>
        ServerName nextcloud.truelite.it
        DocumentRoot /var/www/nextcloud
        AddDefaultCharset utf-8
        <Directory /var/www/nextcloud/>
             AllowOverride All
        </Directory>
    # use your preferred SSL setup with your certificates
        SSLEngine on
        SSLProtocol all -SSLv2 -SSLv3
        SSLHonorCipherOrder on
    ...
        SSLCertificateFile /etc/letsencrypt/live/truelite.it/fullchain.pem
        SSLCertificateKeyFile /etc/letsencrypt/live/truelite.it/privkey.pem
        SetEnvIf User-Agent ".*MSIE.*" nokeepalive ssl-unclean-shutdown

    LogLevel warn    
    ErrorLog ${APACHE_LOG_DIR}/nextcloud-error.log    
    # Possible values include: debug, info, notice, warn, error, crit,
    # alert, emerg.
    CustomLog ${APACHE_LOG_DIR}/nextcloud-access.log combined
</VirtualHost>

ed abilitarlo con:

a2ensite nextcloud

Dovranno inoltre essere abilitati vari moduli di apache che vengono utilizzati da Nextcloud:

a2enmod rewrite
a2enmod ssl
a2enmod headers
a2enmod env
a2enmod dir
a2enmod mime

conclusa la configurazione si riavvi il servizio con:

service apache2 restart

Preparazione del database con MySQL/MariaDB¶

Si dovrà poi predisporre il database per l'applicazione, per cui occorre creare un database dedicato con:

mysqladmin create nextcloud

ed un utente per il relativo accesso:

echo "grant all privileges on nextcloud.* to 'nextcloud'@'localhost' identified by 'passwordcomplicata';" | mysql

Configurazione iniziale¶

Benché sia possibile effettuare la configurazione iniziale del servizio (con creazione della struttura delle tabelle sul database) direttamente dall'interfaccia web, che richiederà tutti i dati necessari ed avviserà degli eventuali problemi riscontrati. In particolare occorrerà inserire un utente di amministrazione e relativa password, il pathname della directory dei dati (nel caso /srv/nextcloud/data e non quella proposta sotto /var/www/nextcloud/) e le credenziali di accesso al database (utente, password e nome del database).

Se si sono eseguiti direttamente i passi precedenti sarà possibile effettuare la configurazione iniziale direttamente dalla riga di comando utilizzando il programma di gestione occ. Dato che questo viene installato senza permesso di esecuzione il primo passo sarà:

cd /var/www/nextcloud
chmod ug+x occ

dopo di che si potrà effettuare la configurazione eseguendo il comando:

sudo -u www-data ./occ maintenance:install --database "mysql" \
  --database-name "nextcloud" --database-user "nextcloud" \
  --database-pass "passwordcomplicata" \
  --admin-user "admin"  --admin-pass "passwordlungaedifficile" \
  --data-dir "/srv/nextcloud/data/" 

dove l'uso di sudo è necessario (pertanto se non disponibile lo si installi con apt-get install sudo) per far eseguire il comando per conto dell'utente www-data (altrimenti il programma si rifiuterà di proseguire suggerendo di aggiungerlo).

Per consentire l'accesso occorrerà comunque abilitare il nome a dominio con cui si contatta il server con un comando analogo a:

sudo -u www-data ./occ  config:system:set trusted_domains 1 \
   --value=nextcloud.truelite.it

che inserisce il nome a dominio fra quelli abilitati, se se ne usano altri occorrerà eseguire di nuovo il comando passando un numero progressivo diverso (il comando crea automaticamente nel file di configurazione di Nextcloud (/var/www/nextcloud/config/config.php) le voci in un array di cui il numero indicato è l'indice, il valore 0 è inserito all'installazione e fa riferimento al localhost e non deve essere cambiato), dopo il comando si otterrà la presenza all'interno del file di una voce del tipo:

  'trusted_domains' => 
  array (
    0 => 'localhost',
    1 => 'nextcloud.truelite.it',
  ),

Configurazioni specifiche¶

Per abilitare l'autenticazione via IMAP occorre aggiungere al file di configurazione (/var/www/nextcloud/config/config.php):

  'user_backends' => array (
    0 => array (
      'class' => 'OC_User_IMAP',
      'arguments' => array (
        0 => '{localhost:143/imap/novalidate-cert}', //questo
    1 => '{localhost:993/imap/ssl/novalidate-cert}', //oppure questo
      ),
    ),
  ),