Anime-Sanctuary

Nextcloud

Vos fichiers, votre agenda et vos contacts dorment chez d'autres, sur des serveurs que vous ne voyez jamais. Installons Nextcloud, un espace en ligne qui tourne sur votre propre serveur, avec deux conteneurs Docker.

Parcours
Tutoriel 22 sur 35
Durée
40 min de lecture
Vérifié avec
Commandes : essais sous Debian 13 (Nextcloud 34). Le tunnel SSH et le HTTPS ne sont pas rejoués ici
Ce que vous saurez faire
  • Écrire un fichier Compose avec Nextcloud et sa base de données MariaDB.
  • Démarrer, se connecter avec le compte administrateur et déclarer ses noms de domaine.
  • Savoir ce que Nextcloud attend d'un proxy HTTPS placé devant lui.
  • Sauvegarder les volumes, puis mettre à jour sans rien perdre.

Avant de commencer : Docker et Docker Compose, Première connexion en SSH, HTTPS avec Let's Encrypt, Reverse proxy.

Sommaire
  1. Ce que fait Nextcloud
  2. Préparer le dossier et les mots de passe
  3. Écrire le fichier Compose
  4. Premier démarrage
  5. Se connecter avec le compte administrateur
  6. Déclarer les noms de domaine autorisés
  7. Passer en HTTPS
  8. Sauvegarder les volumes
  9. Restaurer une sauvegarde
  10. Mettre à jour
  11. Si ça échoue
  12. La suite
  13. Sources

Comment installer Nextcloud avec Docker Compose sur Debian ? Il faut un fichier d'une trentaine de lignes pour l'application et sa base de données, et un peu de soin pour les mots de passe. Comptez quarante minutes, une heure si le terminal est nouveau pour vous (voyez d'abord Le terminal pour débutants), dont une bonne partie à regarder Nextcloud s'installer tout seul. Vous aurez ensuite votre propre espace de fichiers, que vous pourrez sauvegarder et mettre à jour à votre rythme.

Ce que fait Nextcloud

Nextcloud est un espace en ligne pour vos fichiers, dont vous seul avez la clé. Vous déposez vos fichiers depuis un navigateur ou une application, sur ordinateur ou téléphone, et vous les retrouvez partout. Il gère aussi un agenda et un carnet de contacts. Rien ne quitte votre serveur.

Nous le faisons tourner avec Docker, comme dans Docker et Docker Compose. En deux mots : un conteneur est une boîte qui contient un programme tout prêt, et Compose est le fichier où l'on écrit quelles boîtes lancer. Il nous en faut deux : l'application, et une base de données, un programme qui range et retrouve très vite ce que Nextcloud doit savoir (qui a le droit de quoi, quel fichier est où). Nous prenons MariaDB, un logiciel de base de données très répandu.

Le parcours se lit en trois temps :

  • Étapes 1 à 4 : installer Nextcloud et l'ouvrir chez vous, sans l'exposer à Internet. C'est l'essentiel.
  • Étapes 5 et 6 : lui donner un nom de domaine et le chiffrer. À faire seulement si vous voulez l'ouvrir à Internet.
  • Étapes 7 et 8 : sauvegarder, puis mettre à jour.

Commençons par le dossier où tout vivra.

1Préparer le dossier et les mots de passe

Il faut trois mots de passe : celui de l'administrateur de Nextcloud, celui de la base de données, et celui du compte qui gère cette base. Écrits dans le fichier Compose, ils seraient faciles à partager par erreur. Nous les rangeons donc à part, dans un fichier nommé .env. Dans le fichier Compose, un mot comme ${NOM} est un trou à remplir : Compose le lit tout seul, s'il est à côté de docker-compose.yml, et met à la place la valeur écrite dans .env.

Le serveur invente lui-même les trois mots de passe : 24 lettres minuscules et chiffres tirés au hasard. Vous pouvez copier le bloc tel quel ; l'encadré ci-dessous explique chaque outil, pour les curieux.

Comment la commande fabrique les mots de passe

/dev/urandom est la source de hasard du serveur, tr n'en garde que les lettres minuscules et les chiffres, et head -c 24 s'arrête à 24 caractères. La ligne install -m 600 crée le fichier .env vide, lisible par votre compte seul, avant d'y écrire les secrets.

Sur le serveur
mkdir -p ~/nextcloud
cd ~/nextcloud
DB_ROOT_PASSWORD=$(tr -dc 'a-z0-9' </dev/urandom | head -c 24)
DB_PASSWORD=$(tr -dc 'a-z0-9' </dev/urandom | head -c 24)
ADMIN_PASSWORD=$(tr -dc 'a-z0-9' </dev/urandom | head -c 24)
install -m 600 /dev/null .env
printf 'DB_ROOT_PASSWORD=%s\nDB_PASSWORD=%s\nADMIN_PASSWORD=%s\n' "$DB_ROOT_PASSWORD" "$DB_PASSWORD" "$ADMIN_PASSWORD" > .env
echo "Mot de passe de admincloud : $ADMIN_PASSWORD"

La dernière ligne affiche le mot de passe de votre compte administrateur : 24 lettres minuscules et chiffres. Copiez-le tout de suite : sélectionnez la ligne avec la souris dans le terminal, puis Ctrl+Maj+C (Cmd+C sur un Mac). Rangez-le dans un gestionnaire de mots de passe, un coffre-fort numérique pour vos secrets (KeePassXC, gratuit, en est un exemple), car il vous servira dans quelques minutes. Sans gestionnaire, un carnet papier fait l'affaire. Les deux autres, personne n'a besoin de les connaître.

Les secrets sont rangés. Il reste à décrire les deux conteneurs.

2Écrire le fichier Compose

Voici le fichier complet. Il reprend ce que vous savez de l'article Docker et Docker Compose : une image à version fixe, un port réservé au serveur, des volumes. Un volume est un dossier que Docker garde en dehors du conteneur : si vous recréez la boîte, les données restent. La commande cat > docker-compose.yml <<'EOF' écrit tout ce qui suit dans le fichier, jusqu'à la ligne EOF (le mot qui marque la fin du texte). Copiez-le tel quel : il lit vos mots de passe dans .env.

Sur le serveur
cat > docker-compose.yml <<'EOF'
services:
  db:
    image: mariadb:11.8
    restart: unless-stopped
    command: --transaction-isolation=READ-COMMITTED
    volumes:
      - db:/var/lib/mysql
    environment:
      MYSQL_ROOT_PASSWORD: ${DB_ROOT_PASSWORD}
      MYSQL_DATABASE: nextcloud
      MYSQL_USER: nextcloud
      MYSQL_PASSWORD: ${DB_PASSWORD}

  app:
    image: nextcloud:34-apache
    restart: unless-stopped
    depends_on:
      - db
    ports:
      - "127.0.0.1:8082:80"
    volumes:
      - nextcloud:/var/www/html
    environment:
      MYSQL_HOST: db
      MYSQL_DATABASE: nextcloud
      MYSQL_USER: nextcloud
      MYSQL_PASSWORD: ${DB_PASSWORD}
      NEXTCLOUD_ADMIN_USER: admincloud
      NEXTCLOUD_ADMIN_PASSWORD: ${ADMIN_PASSWORD}
      NEXTCLOUD_TRUSTED_DOMAINS: cloud.exemple.fr

volumes:
  db:
  nextcloud:
EOF

Six choix méritent un mot :

  • Pas de ports sur db : la base n'est joignable que par app, jamais depuis Internet.
  • 127.0.0.1:8082:80 sur app : le port est réservé au serveur, comme dans l'article précédent. Le proxy HTTPS viendra s'y brancher.
  • Deux volumes, deux dossiers conservés : db garde la base, nextcloud garde le programme, la configuration et tous vos fichiers.
  • Des versions fixes : 34-apache pour Nextcloud (la variante qui embarque Apache, le logiciel qui répond aux navigateurs ; il est présenté dans Premier site avec Apache), et 11.8 pour MariaDB, une version que la documentation de Nextcloud accepte. Rien ne change sans que vous l'ayez décidé.
  • NEXTCLOUD_ADMIN_USER et NEXTCLOUD_ADMIN_PASSWORD : ils créent le compte administrateur, admincloud, au premier démarrage. L'assistant d'installation n'apparaîtra pas.
  • NEXTCLOUD_TRUSTED_DOMAINS : les noms par lesquels Nextcloud acceptera d'être appelé. Nous y revenons à l'étape 5.

Le fichier est prêt. Allumons le tout.

3Premier démarrage

Le premier démarrage télécharge les deux images, assez lourdes, puis installe Nextcloud dans le volume. Comptez une à deux minutes après le téléchargement.

Sur le serveur
sudo docker compose up -d
sudo docker compose ps
Résultat attendu
NAME              IMAGE                 COMMAND                  SERVICE   CREATED         STATUS                  PORTS
nextcloud-app-1   nextcloud:34-apache   "/entrypoint.sh apac..."   app       2 seconds ago   Up Less than a second   127.0.0.1:8082->80/tcp
nextcloud-db-1    mariadb:11.8          "docker-entrypoint.s..."   db        2 seconds ago   Up 1 second             3306/tcp

Les deux conteneurs tournent, mais Nextcloud n'est pas prêt. Dans la colonne PORTS, la base affiche seulement 3306/tcp : son port existe dans sa boîte, sans être publié nulle part. Suivons l'installation dans le journal du conteneur. grep -E n'en garde que les lignes qui contiennent l'un des deux mots cherchés.

Sur le serveur
sudo docker compose logs app | grep -E "Retrying|successfully"
Résultat attendu
app-1  | Retrying install...
app-1  | Retrying install...
app-1  | Nextcloud was successfully installed

Les lignes « Retrying install » sont normales : Nextcloud démarre avant que la base soit prête, échoue, puis réessaie jusqu'à ce qu'elle réponde. Leur nombre varie. Relancez la commande jusqu'à voir « successfully installed », puis vérifions que l'application répond.

Sur le serveur
curl -s http://127.0.0.1:8082/status.php
Résultat attendu
{"installed":true,"maintenance":false,"needsDbUpgrade":false,"version":"34.0.5.1","versionstring":"34.0.5","edition":"","productname":"Nextcloud","extendedSupport":false}

Seul "installed":true compte ; votre numéro de version peut être plus récent que le nôtre. Nextcloud tourne, mais il n'écoute que le serveur : comment l'ouvrir depuis votre ordinateur ?

4Se connecter avec le compte administrateur

Pour atteindre ce port depuis chez vous, ouvrez un tunnel SSH : le port 8082 de votre ordinateur est relié, à travers la connexion SSH, au port 8082 du serveur. C'est la connexion de l'article Première connexion en SSH, avec l'option -L en plus.

Deux comptes entrent en jeu. Dans la commande ci-dessous, alice est votre compte Linux, celui de votre connexion SSH : remplacez-le par le vôtre, et l'adresse par celle de votre serveur. Le compte Nextcloud, admincloud, créé à l'étape 2, ne sert que dans le navigateur. Gardez la fenêtre du tunnel ouverte tant que vous utilisez Nextcloud.

Sur votre ordinateur
ssh -L 8082:127.0.0.1:8082 alice@203.0.113.10

Ouvrez ensuite http://localhost:8082 dans votre navigateur. Saisissez l'identifiant fixé dans le fichier Compose (admincloud ici) et le mot de passe de 24 caractères copié à l'étape 1. Vous arrivez dans votre espace. Si la page ne s'ouvre pas, vérifiez que la fenêtre du tunnel est toujours ouverte.

Vérifier le compte côté serveur (facultatif)

La commande occ est l'outil de Nextcloud que l'on pilote en tapant des commandes. L'option -u www-data la lance sous le compte qui fait tourner l'application dans sa boîte.

Sur le serveur
cd ~/nextcloud
sudo docker compose exec -u www-data app php occ user:list
Résultat attendu
  - admincloud: admincloud

Si la page s'ouvre et que le mot de passe passe, l'essentiel est fait : Nextcloud tourne chez vous, et seul votre ordinateur y accède, par le tunnel. Les deux étapes suivantes ne servent que pour l'ouvrir à Internet sous un nom de domaine ; sinon, passez directement à l'étape 7.

5Déclarer les noms de domaine autorisés

Cette étape ne sert que si vous voulez joindre Nextcloud par un nom de domaine. Nextcloud ne répond qu'aux noms qui figurent dans sa liste de domaines de confiance (trusted_domains). Il refuse les autres, pour qu'on ne puisse pas l'appeler sous un faux nom. Notre fichier y a mis cloud.exemple.fr, et localhost y figure déjà : voilà pourquoi le tunnel a marché.

Lire et modifier la liste avec occ

Voici la liste actuelle.

Sur le serveur
sudo docker compose exec -u www-data app php occ config:system:get trusted_domains
Résultat attendu
localhost
cloud.exemple.fr

Si vous appelez Nextcloud par un nom absent de la liste, par exemple l'adresse du serveur, il répond « Access through untrusted domain », « accès par un domaine non approuvé ». Pour l'autoriser, ajoutez ce nom à la liste avec occ. Le nombre 2 est la place du nouveau nom dans la liste, dont la première place est la 0.

Sur le serveur
sudo docker compose exec -u www-data app php occ config:system:set trusted_domains 2 --value=203.0.113.10
sudo docker compose exec -u www-data app php occ config:system:get trusted_domains
Résultat attendu
System config value trusted_domains => 2 set to string 203.0.113.10
localhost
cloud.exemple.fr
203.0.113.10

Pour que cloud.exemple.fr mène vraiment à votre serveur, il faut un enregistrement DNS, comme dans Nom de domaine et DNS. C'est une ligne de l'annuaire qui associe un nom à l'adresse de votre serveur. Avant de l'ouvrir à Internet, reste à le chiffrer.

6Passer en HTTPS

Nextcloud ne parle qu'en HTTP, c'est-à-dire sans chiffrement : tout circule en clair. Le HTTPS, c'est le même échange, mais chiffré. Sans lui, vos mots de passe et vos fichiers circulent en clair : n'ouvrez jamais Nextcloud à Internet sans HTTPS.

Pour l'apporter, on place devant lui un Reverse proxy : un programme-portier qui reçoit les visiteurs en HTTPS et transmet leur demande à 127.0.0.1:8082. Il s'appuie sur le certificat vu dans HTTPS avec Let's Encrypt, une carte d'identité numérique qui prouve que le site est bien le vôtre. Installer ce proxy est le sujet de son propre article. Si vous restez chez vous avec le tunnel, rien à faire ici : passez à l'étape 7. Sinon, installez le proxy, puis ouvrez l'encadré ci-dessous.

Après avoir installé le proxy : dire à Nextcloud qu'il est derrière lui

Une fois le proxy en place, Nextcloud doit savoir que les visiteurs arrivent en HTTPS, pour écrire des liens en https://. Dans le fichier docker-compose.yml, sous NEXTCLOUD_TRUSTED_DOMAINS et avec la même indentation, ajoutez la ligne suivante, puis recréez le conteneur.

Dans docker-compose.yml
      OVERWRITEPROTOCOL: https
Sur le serveur
sudo docker compose up -d
sudo docker compose exec -u www-data app php occ config:system:get overwriteprotocol
Résultat attendu
https

Attention : tant que cette ligne est là, le tunnel SSH de l'étape 4 ne marche plus, car Nextcloud réécrit tous ses liens en HTTPS. Ouvrez-le par son adresse en HTTPS. Pour retrouver le tunnel, retirez la ligne et relancez up -d.

Que vous ayez ouvert Nextcloud à Internet ou non, avant d'y mettre vos vrais fichiers, assurons-nous de pouvoir les récupérer.

7Sauvegarder les volumes

Ce qui compte tient dans les deux volumes : la base pour l'un, les fichiers et la configuration pour l'autre. La sauvegarde copie les deux pendant que Nextcloud est en pause (son mode maintenance ferme le site aux visiteurs le temps de la copie). Sans cette pause, un fichier pourrait changer entre les deux copies, et la base ne correspondrait plus aux fichiers.

Compose nomme les volumes d'après le dossier : le volume des fichiers s'appelle ici nextcloud_nextcloud. Copiez le bloc ci-dessous tel quel ; le détail des outils est dans l'encadré juste au-dessus.

Ce que font les outils de la sauvegarde
  • mariadb-dump exporte la base en un fichier texte, depuis le conteneur db. L'option --single-transaction évite de bloquer les lectures.
  • tar archive les fichiers, dans un conteneur jetable fait avec alpine:3.20, une image Linux minuscule.

Les deux fichiers contiennent tous vos secrets : chmod 600 les rend lisibles par vous seul. Docker a créé l'archive au nom de l'administrateur du serveur, donc chown la rend d'abord à votre compte, sinon chmod ne pourrait pas la réserver.

Si une commande échoue, lancez occ maintenance:mode --off avant de chercher la cause, sinon le site reste fermé.

Sur le serveur
cd ~/nextcloud
sudo docker compose exec -u www-data app php occ maintenance:mode --on
sudo docker compose exec -T db sh -c 'mariadb-dump --single-transaction -u root -p"$MYSQL_ROOT_PASSWORD" nextcloud' > nextcloud-base.sql
sudo docker run --rm -v nextcloud_nextcloud:/donnees:ro -v "$PWD":/sauvegarde alpine:3.20 tar czf /sauvegarde/nextcloud-fichiers.tar.gz -C /donnees .
sudo docker compose exec -u www-data app php occ maintenance:mode --off
sudo chown "$USER" nextcloud-fichiers.tar.gz && chmod 600 nextcloud-base.sql nextcloud-fichiers.tar.gz
Résultat attendu
Maintenance mode enabled
Maintenance mode disabled

Vous avez deux fichiers dans ~/nextcloud. L'archive pèse plusieurs centaines de Mo, car le volume contient aussi le programme Nextcloud. Une sauvegarde qui reste sur le serveur ne protège pas d'une panne du serveur : copiez-la ailleurs, par exemple avec Première sauvegarde avec rsync. Reste à savoir la remettre en place si le pire arrive.

Restaurer une sauvegarde

Une sauvegarde ne vaut que si on sait la rejouer. Restaurer, c'est remettre la base, puis les fichiers, application arrêtée. Un détail à connaître : la sauvegarde a été prise pendant la maintenance, donc après restauration Nextcloud se croit encore en maintenance. La dernière commande coupe ce mode, et le site rouvre.

Les commandes de restauration
Sur le serveur
cd ~/nextcloud
sudo docker compose stop app
sudo docker compose exec -T db sh -c 'mariadb -u root -p"$MYSQL_ROOT_PASSWORD" nextcloud' < nextcloud-base.sql
sudo docker run --rm -v nextcloud_nextcloud:/donnees -v "$PWD":/sauvegarde alpine:3.20 tar xzf /sauvegarde/nextcloud-fichiers.tar.gz -C /donnees
sudo docker compose start app
sudo docker compose exec -u www-data app php occ maintenance:mode --off
Résultat attendu
Maintenance mode disabled

Reste le moment où Nextcloud sort une nouvelle version.

8Mettre à jour

Une mise à jour remplace le conteneur par un autre, plus récent, qui reprend les mêmes volumes. Sauvegardez d'abord, comme à l'étape 7, car une mise à jour ratée ne se défait pas toute seule. Ensuite, la méthode est celle de tout service Compose : télécharger, puis recréer.

Sur le serveur
cd ~/nextcloud
sudo docker compose pull
sudo docker compose up -d

Au démarrage, Nextcloud compare la version du volume à celle de l'image, et met la base à jour s'il y a un écart. Voici la version qui tourne.

Sur le serveur
sudo docker compose exec -u www-data app php occ status | head -3
Résultat attendu
  - installed: true
  - version: 34.0.5.1
  - versionstring: 34.0.5

L'étiquette (tag) est la partie du nom d'image après les deux-points : 34-apache reçoit les mises à jour de la série 34. Pour la série suivante, changez le chiffre dans le fichier, sans en sauter : Nextcloud ne monte que d'une version majeure à la fois, de la 34 à la 35, puis de la 35 à la 36.

Si ça échoue

Quatre situations reviennent :

  • La page affiche « Access through untrusted domain ». Le nom saisi dans le navigateur n'est pas dans la liste. Ajoutez-le comme à l'étape 5.
  • The "DB_PASSWORD" variable is not set. Defaulting to a blank string.. Compose n'a pas trouvé le fichier .env. Placez-vous dans ~/nextcloud et vérifiez avec ls -a que le fichier y est. Ne démarrez pas avec des mots de passe vides.
  • Le journal répète « Connection refused » puis « Retrying install... ». C'est normal pendant la première minute : la base démarre. Attendez que « successfully installed » apparaisse.
  • port is already allocated. Le port 8082 est pris. Changez le premier 8082 dans le fichier, comme dans l'article sur Docker.

La suite

Votre espace de fichiers tourne, avec sa base, ses volumes et une sauvegarde. Vous pouvez maintenant employer la même méthode pour d'autres services : un fichier, un dossier, des mots de passe à part. L'article suivant, Jellyfin, l'applique à un lecteur pour vos propres vidéos et votre musique.

Sources (consultées le 4 novembre 2026)