Document : Nextcloud : Mettre à jour et gérer ses applications avec occ

Nextcloud : Mettre à jour et gérer ses applications avec occ

  • admin
  • Nextcloud, Raspberry Pi

La gestion des applications Nextcloud en ligne de commande offre une fiabilité supérieure à celle de l'interface d'administration web. Ce guide présente les commandes essentielles de l'utilitaire occ sous environnement Debian pour inspecter, mettre à jour et nettoyer votre catalogue d'extensions.

Pourquoi privilégier la console occ

La mise à jour des extensions depuis le panneau web présente des risques en production. Les requêtes restent tributaires des directives PHP (max_execution_time, memory_limit) et de la stabilité de la session. Une coupure réseau ou un délai dépassé pendant l'extraction d'une archive volumineuse peut corrompre le dossier de l'application.

L'utilitaire occ (pour ownCloud Console) s'exécute directement dans le terminal. Cette approche garantit le déroulement complet des opérations complexes, offre un retour visuel précis et facilite la maintenance des modules volumineux comme Talk ou Collabora.

Inspection des applications disponibles

Lister les applications installées

Avant d'appliquer la moindre modification, vous pouvez afficher l'ensemble des modules présents sur le serveur. Cette commande détaille les extensions actives, désactivées ou prêtes pour une mise à niveau.

# Lister l'ensemble des applications et leur état actuel
sudo -E -u www-data php /var/www/nextcloud/occ app:list

Vérifier les mises à jour sans les appliquer

Lorsque Nextcloud signale de nouvelles versions, l'option --showonly permet de consulter le détail des applications concernées sans modifier vos fichiers.

# Vérifier les mises à jour disponibles sans les télécharger
sudo -E -u www-data php /var/www/nextcloud/occ app:update --showonly

Mise à jour des applications

Mise à jour globale

Pour actualiser l'ensemble de vos modules en une seule commande, utilisez l'option --all. Le processus télécharge les archives validées par la boutique Nextcloud et applique les modifications nécessaires sur les tables de la base de données.

# Mettre à jour toutes les applications installées
sudo -E -u www-data php /var/www/nextcloud/occ app:update --all

Mise à jour ciblée

Si vous souhaitez mettre à niveau une application précise sans toucher au reste du catalogue, indiquez simplement son identifiant technique en argument.

# Mettre à jour uniquement l'application Contacts
sudo -E -u www-data php /var/www/nextcloud/occ app:update contacts

# Mettre à jour uniquement l'application Calendrier
sudo -E -u www-data php /var/www/nextcloud/occ app:update calendar

Optimisations post-mise à jour

Optimisation et cohérence de la base de données

Certaines mises à jour applicatives introduisent des index optionnels qui ne sont pas créés automatiquement pour éviter de verrouiller les grandes tables. L'exécution de ces commandes permet d'accélérer les requêtes SQL et d'aligner la base de données avec les besoins de vos applications.

# Ajouter les index pour accélérer les requêtes sur les grandes tables
sudo -E -u www-data php /var/www/nextcloud/occ db:add-missing-indices

# Créer les colonnes optionnelles requises par les nouvelles fonctionnalités
sudo -E -u www-data php /var/www/nextcloud/occ db:add-missing-columns

# Appliquer les clés primaires manquantes pour l'intégrité des tables
sudo -E -u www-data php /var/www/nextcloud/occ db:add-missing-primary-keys

Suppression des modules inutilisés

Désactiver une extension suffit pour suspendre son fonctionnement tout en conservant ses réglages en prévision d'un usage futur. En revanche, si vous n'utilisez plus du tout une application, sa suppression définitive allège l'espace disque et réduit la surface d'attaque sur le serveur.

# Désinstaller et supprimer définitivement les fichiers d'une application
sudo -E -u www-data php /var/www/nextcloud/occ app:remove nom_de_l_application

Gestion des versions majeures

Compatibilité des modules tiers

Lors d'une mise à niveau vers une version majeure du cœur de Nextcloud, le système désactive automatiquement les extensions tierces qui ne sont pas encore déclarées compatibles. Vous devez vérifier la compatibilité des extensions indispensables sur le catalogue officiel avant de lancer la mise à niveau de l'instance.

Précautions lors des migrations majeures

Contrairement aux mises à jour applicatives courantes, le changement de version majeure de Nextcloud ou la migration d'applications manipulant d'importants volumes de données (comme Mail ou Deck) justifie la création préalable d'une sauvegarde SQL et le passage temporaire en mode maintenance (occ maintenance:mode --on).

Réactivation après mise à niveau

Une fois le cœur de Nextcloud mis à niveau, relancez la mise à jour globale des applications. Vous obtiendrez les versions adaptées que les éditeurs ont publiées entre-temps.

# Télécharger les versions adaptées à la nouvelle version du serveur
sudo -E -u www-data php /var/www/nextcloud/occ app:update --all

Activation forcée

L'utilisation de l'option occ app:enable --force sur une application incompatible reste fortement déconseillée en production. Cette manipulation risque de bloquer le chargement des pages web ou de générer des incohérences SQL.