La gestion des quotas Nextcloud ne se résume pas à diviser la capacité du serveur entre les comptes. Un quota limite les fichiers attribués à un utilisateur, mais il ne réserve pas automatiquement cet espace sur le stockage. Les partages, les versions, la corbeille et les montages externes suivent aussi des règles différentes.
Ce guide s’appuie sur la documentation de Nextcloud 35 et sur le code de la branche stable35, consultés le 2 novembre 2026. Il explique ce qui est réellement comptabilisé, comment appliquer une valeur par défaut ou une exception, puis comment diagnostiquer un compte annoncé comme plein. Pour replacer ce réglage dans l’ensemble de la plateforme, commencez par le guide Nextcloud.
Un quota Nextcloud est-il une capacité réservée ?
Non. Le quota est une limite logique appliquée à un compte. Il empêche cet utilisateur de dépasser une certaine quantité de fichiers actifs, mais il ne crée pas une partition ni une réservation garantie sur le disque, le volume S3 ou le stockage réseau sous-jacent.
Cette distinction produit deux situations possibles :
- la somme des quotas attribués peut dépasser la capacité physique si tous les utilisateurs ne consomment pas leur maximum en même temps ;
- le stockage physique peut approcher de sa limite alors que plusieurs comptes restent sous leur quota, car d’autres données occupent aussi de la place.
| Limite | Ce qu’elle contrôle | Ce qu’elle ne garantit pas |
|---|---|---|
| Quota utilisateur | Fichiers actifs attribués au compte | Espace physique réservé |
| Capacité du stockage | Volume réellement disponible pour l’instance | Répartition équitable entre comptes |
| Taille maximale d’un fichier | Envoi accepté par PHP, le serveur web et le proxy | Capacité totale du compte |
Un compte peut donc disposer d’un quota élevé sans pouvoir l’utiliser entièrement si le stockage commun est saturé. À l’inverse, augmenter un quota ne libère aucun octet. Il faut surveiller les limites logiques et la capacité réelle séparément.
Quels fichiers sont comptés dans le quota ?
Nextcloud compte normalement les fichiers actifs qui appartiennent à l’utilisateur. Un document qu’une autre personne partage avec lui reste imputé au propriétaire d’origine. Le simple fait de recevoir ou de repartager ce document ne le déplace pas dans le quota du destinataire.
La propriété devient importante dans un dossier partagé. Si Alice partage un dossier et autorise Bob à y ajouter des fichiers, les nouveaux éléments déposés dans ce dossier sont comptés dans le quota d’Alice selon le manuel utilisateur. Le même principe s’applique à un lien public qui autorise l’envoi de fichiers : les dépôts consomment le quota du créateur du partage.
Les données de Calendar et Contacts sont stockées dans la base et ne font pas partie du quota de fichiers. Les miniatures, caches, fichiers temporaires et clés de chiffrement peuvent également consommer du stockage physique sans entrer dans ce calcul. Avec le chiffrement, la taille réellement occupée peut être supérieure à la taille retenue par la couche de stockage pour le quota.
Le propriétaire du dossier porte souvent la consommation
Avant d’augmenter un quota, vérifiez qui possède le dossier qui reçoit les nouveaux fichiers. Un espace partagé depuis un compte individuel peut concentrer toute la consommation sur ce compte, même si plusieurs personnes alimentent le dossier.
Le guide Nextcloud multi-utilisateurs aide à séparer comptes personnels, groupes et dossiers durables. La question du quota vient ensuite : elle dépend de la propriété réelle des fichiers, pas seulement de la personne qui les voit.
La corbeille et les versions consomment-elles le quota ?
Les fichiers supprimés et les anciennes versions ne sont pas inclus dans le quota normal des fichiers actifs. Ils continuent pourtant à occuper le stockage de l’instance et suivent leurs propres règles de conservation.
Pour un compte soumis à un quota, la limite par défaut de la corbeille est calculée à partir de 50 % de l’espace encore disponible après les fichiers actifs. Ce n’est pas 50 % du quota total. L’administrateur peut remplacer cette limite et définir des durées minimales ou maximales de conservation.
L’application Versions gère elle aussi son espace séparément. Avec la politique automatique documentée, elle ne doit pas utiliser plus de 50 % de l’espace actuellement disponible pour l’utilisateur. Les versions anciennes sont nettoyées selon la rétention et l’espace restant. Une version nommée peut échapper à l’expiration automatique, ce qui doit être pris en compte lors du suivi du stockage.
Cela explique un diagnostic fréquent : l’utilisateur reste sous son quota, mais l’instance manque d’espace physique à cause des versions, de la corbeille, des aperçus ou d’autres données techniques. Le guide Versions et corbeille Nextcloud détaille les règles de récupération et leurs limites.
Quota disponible ne signifie pas stockage disponible
Ne promettez pas la somme des quotas comme une capacité physique garantie sans politique de dimensionnement. Contrôlez aussi l’espace libre du stockage, la croissance des versions, la corbeille et les sauvegardes.
Comment fonctionne le quota par défaut ?
Dans Nextcloud 35, chaque compte peut conserver l’une de ces trois formes de valeur :
| Valeur du compte | Effet |
|---|---|
default | Le compte reprend la valeur globale files.default_quota |
Une taille, par exemple 50 GB | Cette limite individuelle remplace la valeur globale |
none | Aucun plafond logique propre au compte |
Le code de stable35 lit d’abord la valeur individuelle. Lorsqu’elle vaut default, Nextcloud résout ensuite la valeur globale. Une modification du quota par défaut concerne donc les comptes qui héritent encore de ce réglage, tandis qu’un compte doté d’une valeur explicite conserve son exception.
L’absence de plafond logique, affichée comme une capacité illimitée dans l’interface, ne rend pas le stockage infini. Le compte reste contraint par le volume physique, les limites du backend, les règles de l’hébergeur et la taille maximale des envois. Utilisez cette option seulement lorsqu’une autre politique contrôle réellement la capacité.
Comment configurer les quotas dans l’administration ?
Dans la page de gestion des utilisateurs, l’icône d’engrenage située en bas du panneau permet de définir le quota par défaut. La colonne Quota permet ensuite de choisir une valeur prédéfinie ou de saisir une taille personnalisée pour un compte. La documentation accepte les unités usuelles, par exemple 500 MB, 5 GB ou 5 TB.
Procédez dans cet ordre :
- définir une valeur par défaut adaptée au profil majoritaire ;
- conserver
defaultpour les comptes ordinaires ; - attribuer une exception seulement aux rôles qui produisent réellement plus de données ;
- noter la raison, le valideur et la date de révision de chaque exception ;
- tester un compte presque plein avant de généraliser la règle.
Pour lire l’état d’un utilisateur depuis le serveur, occ user:info affiche notamment son quota et son usage :
cd /var/www/nextcloud
sudo -E -u www-data php occ user:info alice
Le chemin de Nextcloud et le compte du serveur web varient selon l’installation. La sortie doit être lue avec la capacité physique et les partages du compte. Une valeur correcte dans occ ne prouve pas que le stockage sous-jacent dispose encore de la même quantité d’espace.
Pour automatiser une modification, utilisez l’API Provisioning documentée plutôt qu’une écriture directe dans une clé interne avec une commande générique. L’exemple suivant emploie un mot de passe d’application administrateur et HTTPS :
curl --fail --silent --show-error \
-u "$NC_ADMIN:$NC_APP_PASSWORD" \
-H "OCS-APIRequest: true" \
-X PUT \
--data-urlencode "key=quota" \
--data-urlencode "value=50 GB" \
"https://cloud.example.fr/ocs/v1.php/cloud/users/alice"
Relisez ensuite le compte avec occ user:info alice et effectuez un test fonctionnel. Ne placez pas le secret dans l’historique du terminal, un dépôt ou un script partagé. Une offre gérée peut aussi interdire cette API ou réserver les changements de quota au support.
Le stockage externe est-il inclus dans le quota ?
Par défaut, le stockage externe n’est pas compté dans le quota utilisateur selon le manuel d’administration. L’option quota_include_external_storage permet de demander son inclusion, mais la documentation la qualifie d’expérimentale et prévient qu’elle peut ne pas fonctionner comme attendu.
'quota_include_external_storage' => false,
Un stockage externe défini comme racine pose une limite supplémentaire : le quota ne peut pas être calculé et il est ignoré. Ne construisez donc pas une politique contractuelle uniquement sur l’indicateur affiché par Nextcloud lorsque des montages externes interviennent.
Le guide du stockage S3 avec Nextcloud distingue stockage primaire et montage externe. Avant d’inclure un backend dans les quotas, testez les valeurs remontées, les pannes du montage et le comportement lorsque des fichiers sont modifiés hors de Nextcloud.
Comment diagnostiquer un compte annoncé comme plein ?
Commencez par identifier la limite atteinte au lieu d’augmenter immédiatement la valeur.
- Lire le quota et l’usage avec
occ user:infoou la page personnelle du compte. - Contrôler la propriété des dossiers partagés : les dépôts des collègues peuvent être imputés au propriétaire du dossier.
- Distinguer quota et taille maximale d’envoi : une erreur HTTP liée à PHP ou au proxy ne se corrige pas avec plus de stockage. Le guide de la limite d’upload Nextcloud traite cette chaîne séparément.
- Mesurer la capacité physique du disque, du volume ou du backend objet.
- Examiner versions et corbeille : elles ne comptent pas dans le quota actif, mais occupent de l’espace réel.
- Vérifier les montages externes et la valeur de
quota_include_external_storage. - Reproduire avec un fichier de test puis contrôler les journaux à l’heure exacte.
Si le compte est réellement plein, choisissez entre nettoyage, transfert de propriété et augmentation. Un fichier professionnel qui devrait appartenir à un service ne doit pas rester durablement rattaché au compte personnel d’un salarié uniquement pour contourner sa limite.
Quelle politique de quotas appliquer à une équipe ?
Partez des usages observés, pas d’une valeur identique choisie par commodité. Mesurez le volume actif, les types de fichiers, la croissance, les dossiers partagés et les besoins de récupération. Séparez ensuite les profils qui stockent surtout des documents légers de ceux qui produisent des médias, des exports ou des archives volumineuses.
Une politique exploitable précise :
- la valeur par défaut ;
- les rôles autorisés à demander une exception ;
- la personne qui valide l’augmentation ;
- le seuil interne qui déclenche une revue ;
- le traitement des dossiers partagés et des comptes qui quittent l’organisation ;
- le contrôle de la capacité physique et des sauvegardes ;
- la fréquence de révision des exceptions.
Testez au minimum un dépôt dans un dossier partagé, un envoi par lien public, une restauration de version, une suppression vers la corbeille et un montage externe si l’instance en utilise. Cette recette révèle qui porte la consommation et empêche de confondre quota, rétention et capacité du serveur.
Conclusion
Un quota Nextcloud limite les fichiers actifs attribués à un compte. Il ne réserve pas une portion du stockage et ne reflète pas toute la place occupée par les versions, la corbeille, les métadonnées ou les applications. La propriété des dossiers partagés reste le point le plus important pour comprendre une consommation inattendue.
Définissez une valeur par défaut, documentez les exceptions, vérifiez les comptes avec occ user:info et surveillez séparément la capacité physique. Avant toute augmentation, confirmez que le blocage vient bien du quota et non d’une limite d’upload, d’un montage externe ou d’un stockage saturé.
Sources officielles
- Nextcloud 35 : gestion des utilisateurs et quotas
- Nextcloud 35 : calcul du quota de stockage
- Nextcloud 35 : gestion des fichiers supprimés
- Nextcloud 35 : contrôle des versions
- Nextcloud 35 : commandes occ pour les utilisateurs
- Nextcloud 35 : API Provisioning pour modifier un utilisateur
- Nextcloud stable35 : résolution et validation du quota dans User.php