Nextcloud

Installation sur Debian

Installation des packages nécessaires

Pour une installation avec Apache et MariaDB (recommandé) :

sudo apt update
sudo apt install apache2 mariadb-server libapache2-mod-php7.4
sudo apt install php7.4-gd php7.4-mysql php7.4-curl php7.4-mbstring php7.4-intl 
sudo apt install php7.4-gmp php7.4-bcmath php-imagick imagemagick php7.4-xml php7.4-zip php7.4-bz2
ⓘ Pour l'utilisation des applications supplémentaires voir Conditions préalables à l'installation manuelle.

Création de la base donnée

  1. Démarrez le mode ligne de commande MySQL :

    sudo /etc/init.d/mysql start
    sudo mysql -uroot -p
    

    Appuyez sur la touche Entrée lorsque vous êtes invité à saisir un mot de passe.

  2. Ensuite, une invite MariaDB [root]> apparaîtra. Saisissez maintenant les lignes suivantes en remplaçant le nom d'utilisateur et le mot de passe par les valeurs appropriées et confirmez-les avec la touche Entrée :

    CREATE USER 'username'@'localhost' IDENTIFIED BY 'password';
    CREATE DATABASE IF NOT EXISTS nextcloud CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;
    GRANT ALL PRIVILEGES ON nextcloud.* TO 'username'@'localhost';
    

    ou utiliser l'utilisateur root (s'il n'est pas utilisé par d'autres BDD) :

    DROP USER 'root'@'localhost';
    CREATE USER 'root'@'localhost' IDENTIFIED BY 'password';
    CREATE DATABASE IF NOT EXISTS nextcloud CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;
    GRANT ALL PRIVILEGES ON *.* TO 'root'@'localhost' WITH GRANT OPTION;
    
  3. Vous pouvez quitter l'invite en entrant  :

    quit;
    

Les tables de la base de données seront créées par Nextcloud lors de votre première connexion.

Autorisations au dossier Apache

Au passage, nous allons en profiter pour donner des droits au dossier d’apache qui vous permettra de facilement administrer les sites. Pour cela, lancez les commandes suivantes :

sudo chown -R user:www-data /var/www/nextcloud
sudo chmod -R 770 /var/www/nextcloud

Téléchargement et installation de Nextcloud

  1. Téléchargez maintenant l'archive de la dernière version de Nextcloud :

    • Accédez à la page de téléchargement Nextcloud.
    • Accédez à Download for Server > Download Nextcloud et téléchargez l'archive tar.bz2 ou .zip.

    OU

    • Téléchargez via le terminal où x.y.z est le numéro de version (zip ou tar.bz2) :
      wget https://download.nextcloud.com/server/releases/nextcloud-x.y.z.tar.bz2
      wget https://download.nextcloud.com/server/releases/nextcloud-x.y.z.zip
      
  2. Téléchargez son fichier de somme de contrôle correspondant :

    wget https://download.nextcloud.com/server/releases/nextcloud-x.y.z.tar.bz2.sha256
    wget https://download.nextcloud.com/server/releases/nextcloud-x.y.z.zip.sha256
    
  3. Vérifiez la somme SHA256 :

    sha256sum -c nextcloud-x.y.z.tar.bz2.sha256 < nextcloud-x.y.z.tar.bz2
    sha256sum -c nextcloud-x.y.z.zip.sha256 < nextcloud-x.y.z.zip
    
  4. Vous pouvez également vérifier la signature PGP :

    wget https://download.nextcloud.com/server/releases/nextcloud-x.y.z.tar.bz2.asc
    wget https://nextcloud.com/nextcloud.asc
    gpg --import nextcloud.asc
    gpg --verify nextcloud-x.y.z.tar.bz2.asc nextcloud-x.y.z.tar.bz2
    
  5. Extraire le contenu de l'archive :

    sudo tar -xjvf nextcloud-x.y.z.tar.bz2
    sudo unzip nextcloud-x.y.z.zip
    

    Cela se décompresse dans un seul répertoire nextcloud.

  6. Copiez le répertoire Nextcloud vers sa destination finale. Lorsque vous exécutez le serveur HTTP Apache, vous pouvez installer en toute sécurité Nextcloud dans la racine de votre document Apache :

    cp -r nextcloud /path/to/webserver/document-root
    

    où /path/to/webserver/document-root est remplacé par la racine du document de votre serveur Web :

    cp -r nextcloud /var/www
    

Sur les autres serveurs HTTP, il est recommandé d'installer Nextcloud en dehors de la racine du document.

Autorisations au dossier Apache (encore)

Suite à l'installation il se peut que certains dossiers sont inaccessibles. Nous allons redonner des droits au dossier d’apache :

sudo chown -R user:www-data /var/www/nextcloud
sudo chmod -R 770 /var/www/nextcloud

Puis redémarrer le serveur

sudo service apache2 restart

Configuration du serveur Apache

1. Création du fichier de configuration

Le chemin du fichier de configuration dépend du système :

Sur Debian, Ubuntu, et leurs dérivés : /etc/apache2/sites-available/nextcloud.conf.

Sur Fedora, CentOS, RHEL, et systèmes similaires : /etc/httpd/conf.d/nextcloud.conf.

Vous pouvez choisir d'installer Nextcloud dans un répertoire sur un serveur Web existant, par exemple https://www.example.com/nextcloud/, ou dans un hôte virtuel si vous souhaitez que Nextcloud soit accessible à partir de son propre sous-domaine tel que https://cloud.exemple.com/.

Pour utiliser l'installation basée sur un répertoire, placez ce qui suit dans votre nextcloud.conf en remplaçant Directory et Alias par les chemins de fichiers appropriés pour votre système :

Alias /nextcloud "/var/www/nextcloud/"

<Directory /var/www/nextcloud/>
  Require all granted
  AllowOverride All
  Options FollowSymLinks MultiViews

  <IfModule mod_dav.c>
    Dav off
  </IfModule>
</Directory>

Pour utiliser l'installation de l'hôte virtuel, placez ce qui suit dans votre nextcloud.conf en remplaçant ServerName, DocumentRoot et Directory avec des valeurs appropriées pour votre système :

<VirtualHost *:80>
  DocumentRoot /var/www/nextcloud/
  ServerName  your.server.com

  <Directory /var/www/nextcloud/>
    Require all granted
    AllowOverride All
    Options FollowSymLinks MultiViews

    <IfModule mod_dav.c>
      Dav off
    </IfModule>
  </Directory>
</VirtualHost>

Vous devez désactiver toute authentification configurée par le serveur pour Nextcloud, car il utilise l'authentification de base en interne pour les services DAV. Si vous avez activé l'authentification sur un dossier parent (via, par exemple, une directive AuthType Basic), vous pouvez désactiver l'authentification spécifiquement pour l'entrée Nextcloud. Après l'exemple de fichier de configuration ci-dessus, ajoutez la ligne suivante dans la section <Directory> :

Satisfy Any

Sur Debian, Ubuntu (etc...), vous devez exécuter la commande suivante pour activer la configuration :

sudo a2ensite nextcloud.conf

2. Activation des modules Apache

Pour que Nextcloud fonctionne correctement, il faut activer plusieurs modules :

sudo a2enmod rewrite headers env dir mime

3. Activer SSL

Voir sur la documentation d'Apache - SSL

Lorsque vous utilisez SSL, notez particulièrement le ServerName. Vous devez en spécifier un dans la configuration du serveur, ainsi que dans le champ CommonName du certificat. Si vous souhaitez que votre Nextcloud soit accessible via Internet, définissez les deux sur le domaine que vous souhaitez atteindre votre serveur Nextcloud.

4. Redémarrer le serveur Apache

sudo service apache2 restart

5. Clients CalDAV ou CardDAV

Si vous exécutez Nextcloud dans un sous-répertoire et que vous souhaitez utiliser les clients CalDAV ou CardDAV, assurez-vous d'avoir configuré les bonnes URL de découverte de service.

6. Réécriture des URLs

Pour supprimer la partie index.php dans toutes les URL Nextcloud :

  1. mod_env et mod_rewrite doivent être installés (voir Activation des modules).
  2. .htaccess doit être accessible en écriture par l'utilisateur HTTP : sudo ...
  3. Ensuite, vous pouvez définir dans le config.php deux variables :

    • si votre configuration est disponible sur https://example.org/nextcloud :

      'overwrite.cli.url' => 'https://example.org/nextcloud',
      'htaccess.RewriteBase' => '/nextcloud',
      
    • s'il n'est pas installé dans un sous-dossier :

      'overwrite.cli.url' => 'https://example.org/',
      'htaccess.RewriteBase' => '/',
      

Enfin, exécutez cette commande occ pour mettre à jour votre fichier .htaccess

sudo -u www-data php /var/www/nextcloud/occ maintenance:update:htaccess

Après chaque mise à jour, ces modifications sont automatiquement appliquées au fichier .htaccess.


Configuration Nextcloud

Pour éviter les avertissements, voici les corrections à apporter :

  1. Augmenter la mémoire PHP ou désactivé la limite (-1), dans /etc/php/7.3/apache2/php.ini :

    memory_limit = -1
    
  2. Définir une région, dans config/config.php :

    'default_phone_region' => 'FR',
    
  3. Mise en place d'un module de cache :

    • Redis (local caching and file locking) :

      sudo apt install redis-server php-redis

    Ajoutez cette ligne dans config/config.php :

    'memcache.local' => '\\OC\\Memcache\\Redis',
    'memcache.locking' => '\\OC\\Memcache\\Redis',
    'redis' => array(
    'host' => 'localhost',
    'port' => 6379,
    ),
    
    • APCu (à coupler avec Redis, pour les grosses archi) :

      sudo apt install php-apcu

    Ajoutez cette ligne dans config/config.php :

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

    APCu est désactivé par défaut en CLI ce qui peut causer des problème avec les jobs CRON de Nextcloud. Pour résoudre ce problème, ajouter cette ligne dans /etc/php/7.3/apache2/php.ini :

    apc.enable_cli=1
    

Lancement de Nextcloud

After restarting Apache you must complete your installation by running either the graphical Installation Wizard, or on the command line with the occ command. To enable this, change the ownership on your Nextcloud directories to your HTTP user:

Place data directory outside of the web root

It is highly recommended to place your data directory outside of the Web root (i.e. outside of /var/www). It is easiest to do this on a new installation.


Sécurité


Performance

Corriger des évenutelles erreurs de l'instance

Allez dans Paramètres > Journalisation

OU

Vérifiez qu'il n'y a pas d'erreurs dans les logs :

tail -n 100 /var/www/nextcloud/data/nextcloud.log

Pour les corriger voir la section Troubleshooting.

Fix index manquants

cd /var/www/nextcloud
sudo -u www-data php occ db:add-missing-indices
⚠ Exécutez cette commande quand votre installation Nextcloud n'est pas utilisée ! Sinon les données peuvent être effacées.

Activez PHP Opcache

Ajoutez cette ligne dans /etc/php/7.0/apache2/conf.d/10-opcache.ini :

opcache.enable=1
opcache.enable_cli=1
opcache.interned_strings_buffer=8
opcache.max_accelerated_files=10000
opcache.memory_consumption=128
opcache.save_comments=1
opcache.revalidate_freq=1

Activez Redis et/ou APCu memory cache

If you are running on a small cloud instance (say, less than 2GB RAM), or a resource-constrained device such as Raspberry Pi, Redis can be used for both local caching and file locking.

To install Redis on Ubuntu:

apt-get install redis-server php-redis -y

Then, add the following lines to config.php if you are using a local Redis server.

'memcache.local' => '\\OC\\Memcache\\Redis',
'memcache.locking' => '\\OC\\Memcache\\Redis',
'redis' => array(
'host' => 'localhost',
'port' => 6379,
),

Utilisez CRON

Configure cron processing for NextCloud in cron versus webcron mode in Settings > Administration > Basic settings. Add this line to /etc/crontab.

*/5 * * * * nginx php -f /var/www/nextcloud/cron.php

Disable thumbnail generation

Disable thumbnail generation by adding the following line to config/config.php in your NextCloud app folder.

'enable_previews' => false,

Troubleshhoting

Sources