SSD Nodes Learn Hosting plans →
Guides Matt ConnorPar Matt Connor

Où sont stockés les fichiers Nextcloud dans Docker ?

Trouvez le répertoire data dans le conteneur, le chemin hôte du volume et les éléments indispensables à une sauvegarde restaurable, au-delà des fichiers utilisateurs.

Où Nextcloud dans Docker stocke les fichiers

Nextcloud dans Docker stocke les fichiers dans un répertoire de données à l’intérieur du conteneur. L’emplacement réel sur votre serveur correspond au volume ou au bind mount que vous avez associé au conteneur. Avec l’image linuxserver.io, lscr.io/linuxserver/nextcloud, les fichiers utilisateur se trouvent dans /data, et config.php, les applications et les thèmes se trouvent sous /config. Ces deux chemins sont des chemins du conteneur. Une commande affiche le chemin correspondant sur l’hôte. La suite de ce guide traite de la partie la plus difficile de la question : tout ce que le répertoire de données ne contient pas.

Épinglez le tag de l’image. Les chemins dépendent de l’image, pas de Nextcloud, et un tag flottant peut changer sans préavis. Au 20 novembre 2026, la version stable actuelle de l’image est 35.0.3-ls3. Elle contient Nextcloud 35.0.3, la quatrième version de la version majeure 35 de Nextcloud. L’image ne met à niveau qu’une seule version majeure à la fois. Une stack qui utilise encore 34.x passe donc à 35 en une seule étape. Cette opération justifie de faire une sauvegarde au préalable.

services:
  nextcloud:
    image: lscr.io/linuxserver/nextcloud:35.0.3-ls3
    container_name: nextcloud
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=Etc/UTC
    volumes:
      - nextcloud_config:/config
      - nextcloud_data:/data
    ports:
      - 443:443
    restart: unless-stopped

  nextcloud-db:
    image: mariadb:11.8
    container_name: nextcloud-db
    environment:
      - MARIADB_ROOT_PASSWORD=${MARIADB_ROOT_PASSWORD}
      - MARIADB_DATABASE=nextcloud
      - MARIADB_USER=nextcloud
      - MARIADB_PASSWORD=${NEXTCLOUD_DB_PASSWORD}
    volumes:
      - nextcloud_db:/var/lib/mysql
    restart: unless-stopped

volumes:
  nextcloud_config:
  nextcloud_data:
  nextcloud_db:

Les deux mots de passe proviennent d’un fichier .env placé à côté du fichier Compose. Ils restent ainsi en dehors du fichier Compose lui-même. La réponse comporte donc trois volumes, mais un seul contient les fichiers utilisateur.

Ces chemins dans le conteneur proviennent de la documentation de cette image précise. Une autre image Nextcloud peut organiser son système de fichiers différemment et placer l’installation sous son propre web root. Un chemin copié depuis un forum n’est donc qu’une supposition. Vérifiez la configuration réelle dans le conteneur que vous exécutez.

docker inspect nextcloud

La section Mounts de cette sortie répertorie tous les mounts. Source indique le côté hôte et Destination le côté conteneur. Cette liste répond à la question pour votre configuration, quelle que soit l’image choisie.

Comment trouver le chemin réel sur l’hôte derrière le volume ?

Un volume nommé est géré par Docker. Vous ne choisissez donc pas son chemin. Vous le demandez.

docker volume ls
docker volume inspect nextcloud_nextcloud_data

Le nom est important. Docker Compose préfixe les noms de volumes avec le nom du projet. Par défaut, il s’agit du nom du répertoire qui contient votre fichier Compose. Ainsi, un volume écrit comme nextcloud_data dans le fichier existe généralement sous le nom nextcloud_nextcloud_data sur le disque. docker volume ls affiche les vrais noms. La sortie de inspect ressemble à ceci, en version abrégée :

[
    {
        "CreatedAt": "2026-08-18T09:12:44Z",
        "Driver": "local",
        "Mountpoint": "/var/lib/docker/volumes/nextcloud_nextcloud_data/_data",
        "Name": "nextcloud_nextcloud_data",
        "Scope": "local"
    }
]

Mountpoint est la réponse. Lisez-la avec la commande au lieu de la supposer, car elle peut changer. Avec Docker rootless, toute la racine de données Docker se trouve par défaut dans le répertoire personnel de l’utilisateur qui exécute le daemon. Le chemin commence donc ailleurs.

Un bind mount supprime cette question. Écrivez - /srv/nextcloud/data:/data dans le fichier Compose : le chemin sur l’hôte est alors celui que vous avez indiqué, ce que docker inspect affiche comme Source. Ce choix ne modifie pas seulement le chemin, car les volumes nommés et les bind mounts se comportent différemment pour la gestion des propriétaires et les sauvegardes.

Pourquoi le répertoire de données ne constitue pas une sauvegarde

Le manuel Nextcloud indique qu’une sauvegarde doit conserver cinq éléments : le répertoire de configuration, le répertoire des applications personnalisées, le répertoire de données, le répertoire du thème et la base de données. Avec cette image, les répertoires de configuration, des applications et du thème se trouvent tous sous /config, tandis que la base de données s’exécute dans son propre conteneur avec son propre volume. Copier uniquement /data revient à sauvegarder la partie la moins utile du problème.

La base de données est essentielle, car l’interface web n’énumère jamais directement un répertoire. Elle affiche les lignes du cache des fichiers. C’est pourquoi le manuel vous demande d’exécuter un scan après avoir copié manuellement des fichiers dans le répertoire de données. Restaurez /data à côté d’une base de données vide et vous obtenez des octets sans index : aucun utilisateur, aucun partage, rien dans la liste des fichiers. Restaurez la base de données à côté d’un /data vide et chaque ligne pointe vers un fichier qui a disparu.

config.php contient les identifiants de la base de données et les domaines de confiance. Il contient également l’ID de l’instance, qui forme le nom du répertoire de données de l’application lorsqu’il est préfixé par appdata_. Interrogez l’instance en cours d’exécution au lieu de vous fier à l’une ou l’autre valeur mémorisée.

docker exec -it nextcloud occ config:system:get datadirectory
docker exec -it nextcloud occ config:system:get instanceid

La première commande affiche le répertoire de données réellement utilisé par cette instance, qui est /data ici. Cette image fournit un wrapper occ dans le PATH. Exécutez-le donc directement via docker exec. Ne copiez pas la forme plus longue sudo et php occ du manuel Nextcloud, qui concerne une installation exécutée en dehors d’un conteneur.

Qu’est-ce qui remplit discrètement le volume de données ?

Les aperçus et l’historique propre à chaque utilisateur se trouvent sur le même volume que les fichiers. Aucun des deux n’apparaît dans l’indication de stockage affichée à l’utilisateur dans l’interface web.

  • Les aperçus sont des vignettes générées. Ils se trouvent dans le dossier de données de l’application, à l’intérieur du répertoire de données, dans un dossier nommé appdata_ suivi de l’identifiant de l’instance.
  • Les fichiers supprimés restent dans la corbeille. trashbin_retention_obligation vaut par défaut auto. Les fichiers supprimés peuvent ainsi rester plus de 30 jours lorsque l’espace est disponible, mais être supprimés avant 30 jours lorsque de l’espace est nécessaire. Les fichiers supprimés ne sont pas décomptés du quota normal de l’utilisateur, mais la corbeille possède sa propre limite : par défaut, jusqu’à 50 % de l’espace de quota encore disponible pour l’utilisateur, ou l’espace disque libre pour un utilisateur sans quota. Lorsque la corbeille dépasse cette limite, Nextcloud supprime d’abord les éléments admissibles les plus anciens, y compris ceux datant de moins de 30 jours avec auto.
  • Les anciennes versions sont également conservées. versions_retention_obligation vaut par défaut auto. Cette valeur réduit progressivement le nombre de versions au fil du temps et conserve la plus récente dans chaque intervalle. Lorsqu’une durée maximale de conservation est configurée, une tâche d’arrière-plan supprime les versions qui dépassent cette durée ou dont le fichier n’existe plus. Pour les comptes soumis à un quota, l’application Versions vise 50 % de l’espace de quota actuellement libre pour l’utilisateur. Sans quota, elle utilise directement l’espace libre du système de fichiers. Lorsqu’elle doit libérer de l’espace, elle supprime d’abord les versions les plus anciennes tout en conservant au moins les deux plus récentes. La valeur cible n’est donc pas une limite stricte. Une version nommée manuellement par un utilisateur est exclue de cette expiration automatique, mais l’utilisateur peut toujours la supprimer manuellement, et occ versions:cleanup supprime les versions nommées avec les autres.

Mesurez avant de supprimer quoi que ce soit.

docker exec -it nextcloud sh -c 'du -sh /data/*'
docker exec -it nextcloud sh -c 'du -sh /data/appdata_*'

La première ligne donne un nombre pour chaque dossier utilisateur, ainsi que pour le dossier de données de l’application. Si le nombre associé aux données de l’application est élevé, vérifiez son sous-répertoire preview. Les données de l’application contiennent également les avatars et les ressources mises en cache. Les commandes de nettoyage ci-dessous sont documentées, et chacune d’elles détruit volontairement des données.

docker exec -it nextcloud occ trashbin:cleanup --all-users
docker exec -it nextcloud occ versions:cleanup alice
docker exec -it nextcloud occ preview:cleanup

preview:cleanup supprime tous les aperçus générés. Nextcloud les génère de nouveau lorsque les utilisateurs ouvrent ces fichiers. L’espace est donc progressivement réoccupé et le processeur doit effectuer ce travail. Si le volume n’est qu’une partie d’un problème de disque plus large, les anciennes images et le cache de build obsolète en constituent généralement l’autre partie.

Pourquoi les fichiers que je copie sur l’hôte n’apparaissent-ils pas dans Nextcloud ?

Nextcloud lit son cache de fichiers dans la base de données, pas dans le répertoire. Votre copie a créé un fichier sur le disque sans ligne correspondante dans la base de données. L’interface web n’a donc rien à afficher. Le manuel décrit précisément ce cas : il faut lancer un scan après avoir copié des fichiers directement dans le répertoire de données.

docker exec -it nextcloud occ files:scan --path="/alice/files/Photos"
docker exec -it nextcloud occ files:scan --all --unscanned -v
docker exec -it nextcloud occ files:scan --all

L’argument --path montre également l’organisation du répertoire de données : chaque utilisateur possède un dossier portant son nom d’utilisateur, et files à l’intérieur de ce dossier contient les fichiers affichés dans l’interface web. Lancez le scan sur un seul chemin si vous savez où les fichiers ont été copiés. --all parcourt tous les utilisateurs et peut prendre beaucoup de temps sur une grande instance. --unscanned ne traite que les fichiers qui sont marqués comme n’ayant pas encore été entièrement analysés. -v affiche chaque fichier au fur et à mesure de son traitement. Cela permet de distinguer une commande bloquée d’une commande dont vous pouvez suivre l’avancement.

Les propriétaires et les permissions déterminent si le scan suffit. Un fichier sur lequel l’utilisateur du conteneur ne peut pas écrire est indexé, puis ne peut pas être déplacé. La liste semble alors correcte, mais le renommage ou la suppression depuis l’interface web échoue.

Pourquoi les écritures échouent-elles après la définition de PUID et PGID ?

Parce que le noyau compare des nombres, pas des noms. PUID et PGID définissent respectivement l’identifiant numérique de l’utilisateur (uid) et du groupe (gid) utilisés par le processus du conteneur. Chaque fichier sur l’hôte possède également un propriétaire numérique. Lorsque ces deux nombres diffèrent, l’écriture est refusée, quels que soient les noms affichés de part et d’autre.

docker exec -it nextcloud id abc
sudo ls -ln /var/lib/docker/volumes/nextcloud_nextcloud_data/_data

id abc affiche les uid et gid réellement utilisés par le conteneur, c’est-à-dire les valeurs que vous avez définies avec PUID et PGID. ls -ln affiche les propriétaires numériques, et -n est important : ls -l classique traduit ces nombres à partir de la liste des utilisateurs de l’hôte et affiche un nom qui n’a aucune signification dans le conteneur. Comparez les deux nombres.

Testez ensuite l’écriture au lieu de vous fier aux suppositions.

docker exec -u abc -it nextcloud touch /data/writetest

Un Permission denied qui nomme correctement /data confirme le problème. Corrigez le propriétaire depuis l’intérieur du conteneur, puis exécutez à nouveau le même test.

docker exec -u 0 -it nextcloud chown -R abc:abc /data
docker exec -u abc -it nextcloud touch /data/writetest
docker exec -u abc -it nextcloud rm /data/writetest

Cette opération doit être effectuée depuis l’intérieur du conteneur pour une raison précise. Avec Docker rootless, les identifiants utilisateur du conteneur sont mappés à travers la plage subordinate indiquée dans /etc/subuid. Ainsi, l’uid 1000 dans le conteneur correspond à un uid beaucoup plus élevé sur l’hôte. Un chown 1000:1000 exécuté sur l’hôte définit alors un propriétaire que le conteneur ne peut pas utiliser, et l’écriture échoue toujours. L’exécution de chown dans le conteneur utilise le même mapping que le processus Nextcloud lui-même. Les nombres correspondent donc nécessairement. C’est également pourquoi PUID et PGID doivent correspondre au propriétaire sur le disque avant de chercher une autre cause.

Comment effectuer une sauvegarde pour que la restauration fonctionne réellement ?

Prenez la base de données et les répertoires au même moment. Le mode maintenance bloque les connexions. Aucun téléversement ne peut donc intervenir entre l’export et la copie.

docker exec -it nextcloud occ maintenance:mode --on
docker exec nextcloud-db mariadb-dump --single-transaction -u nextcloud -p"$NEXTCLOUD_DB_PASSWORD" nextcloud > nextcloud-sqlbkp.sql
docker run --rm -v nextcloud_nextcloud_data:/data:ro -v "$PWD":/backup alpine:3.22 tar czf /backup/nextcloud-data.tgz -C /data .
docker run --rm -v nextcloud_nextcloud_config:/config:ro -v "$PWD":/backup alpine:3.22 tar czf /backup/nextcloud-config.tgz -C /config .
docker exec -it nextcloud occ maintenance:mode --off

Remarquez ce qui manque dans la commande d’export : l’option -t. Un TTY réécrit les fins de ligne. Un export SQL qui y est passé est corrompu, mais vous ne le découvrez qu’au moment de la restauration. Notez également qu’un mot de passe placé sur la ligne de commande apparaît dans la sortie de ps pendant l’exécution de la commande. Le lire depuis votre fichier .env dans le shell évite de le saisir dans l’historique du shell, mais ne masque pas l’argument développé de la ligne de commande. Les anciennes images de base de données utilisent mysqldump au lieu de mariadb-dump. Le manuel documente les deux.

Pour restaurer, chargez l’export dans une base de données vide, décompressez les deux archives dans de nouveaux volumes, démarrez les conteneurs, puis désactivez le mode maintenance. Si les répertoires et l’export proviennent de moments différents, le cache de fichiers et le disque ne correspondent pas. occ files:scan --all ne peut corriger que l’écart dans un seul sens. Il trouve les fichiers qui existent sans ligne correspondante. Il ne peut pas récupérer un fichier référencé par une ligne alors qu’il n’existe plus.

Conservez le résultat hors du serveur. Une copie stockée dans le même VPS est perdue avec le VPS. C’est pourquoi restic vers un dépôt hors serveur fait partie de cette procédure, et pourquoi un snapshot fourni par l’hébergeur est un outil différent d’une sauvegarde. Si vous êtes encore en train de mettre en place la stack, une installation complète de Nextcloud sur un VPS couvre le reverse proxy et le certificat TLS (transport layer security) que ce guide ne traite pas.

FAQ

Où se trouve le répertoire de données Nextcloud dans un conteneur Docker ?

Avec l’image linuxserver.io, il se trouve à /data dans le conteneur. config.php, les applications et les thèmes se trouvent sous /config. Il s’agit de chemins propres au conteneur. Pour connaître le chemin sur l’hôte, exécutez docker inspect nextcloud et lisez la valeur Source dans la section Mounts, ou exécutez docker volume inspect sur le volume et lisez Mountpoint. Les autres images Nextcloud utilisent des chemins de conteneur différents. Consultez donc la documentation correspondant au tag que vous avez épinglé et confirmez avec docker exec -it nextcloud occ config:system:get datadirectory.

Pourquoi les fichiers que je copie dans le volume n’apparaissent-ils pas dans Nextcloud ?

Nextcloud affiche les entrées du cache des fichiers stocké dans sa base de données, au lieu de lire directement le répertoire. Un fichier ajouté sans passer par Nextcloud n’a donc aucune entrée et reste invisible. Exécutez docker exec -it nextcloud occ files:scan --path="/alice/files/Photos" pour un dossier ou occ files:scan --all pour tous les utilisateurs. Si les fichiers apparaissent, mais qu’ils refusent ensuite d’être déplacés ou supprimés, la cause vient des permissions : l’utilisateur du conteneur doit pouvoir y écrire.

Une copie du volume de données suffit-elle pour restaurer Nextcloud ?

Non. Le volume de données contient le contenu des fichiers. La base de données contient l’index des fichiers, ainsi que les utilisateurs et les partages. config.php contient les identifiants de la base de données et l’identifiant de l’instance. Une restauration fonctionnelle nécessite le dossier de données, le dossier de configuration, la base de données, ainsi que les dossiers des applications et du thème personnalisés si vous les utilisez. Sauvegardez-les tous au même moment, car une base de données plus récente que les fichiers peut référencer des fichiers inexistants.

Pourquoi mon volume de données est-il beaucoup plus volumineux que les fichiers visibles par les utilisateurs ?

Les aperçus, les fichiers supprimés et les anciennes versions résident dans le même volume. Aucun d’eux n’apparaît dans le chiffre visible par un utilisateur. Mesurez l’espace utilisé avec docker exec -it nextcloud sh -c 'du -sh /data/*'. Par défaut, la corbeille supprime les fichiers avant 30 jours lorsque de l’espace est nécessaire et les conserve plus longtemps lorsque ce n’est pas le cas. Le nettoyage des versions vise la moitié de l’espace de quota restant pour les comptes soumis à un quota et utilise directement l’espace libre du système de fichiers dans les autres cas. La conservation de versions récentes peut toutefois empêcher l’atteinte de cet objectif. Supprimez-les avec occ trashbin:cleanup --all-users, occ versions:cleanup alice et occ preview:cleanup. Les aperçus recommenceront à occuper de l’espace lorsque les utilisateurs ouvriront leurs fichiers.

Puis-je déplacer le répertoire de données Nextcloud vers un autre disque ?

Montez le nouvel emplacement sur le même chemin dans le conteneur, au lieu de modifier le chemin connu par Nextcloud. Arrêtez le conteneur, copiez l’ancien contenu vers le nouveau disque en conservant le propriétaire et le groupe (cp -a ou rsync -aAX), modifiez le volume ou le bind mount pour pointer vers le nouvel emplacement dans votre fichier Compose, puis redémarrez le conteneur. Nextcloud voit toujours /data. Aucune entrée de la base de données ne doit donc être modifiée. Vérifiez le résultat avec docker exec -it nextcloud occ config:system:get datadirectory et avec un téléversement de test.

Cet article vous a-t-il été utile ?