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
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.
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.
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:
EOFSix choix méritent un mot :
- Pas de
portssurdb: la base n'est joignable que parapp, jamais depuis Internet. 127.0.0.1:8082:80surapp: 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 :
dbgarde la base,nextcloudgarde le programme, la configuration et tous vos fichiers. - Des versions fixes :
34-apachepour Nextcloud (la variante qui embarque Apache, le logiciel qui répond aux navigateurs ; il est présenté dans Premier site avec Apache), et11.8pour MariaDB, une version que la documentation de Nextcloud accepte. Rien ne change sans que vous l'ayez décidé. NEXTCLOUD_ADMIN_USERetNEXTCLOUD_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.
sudo docker compose up -d
sudo docker compose psNAME 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/tcpLes 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.
sudo docker compose logs app | grep -E "Retrying|successfully"app-1 | Retrying install...
app-1 | Retrying install...
app-1 | Nextcloud was successfully installedLes 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.
curl -s http://127.0.0.1:8082/status.php{"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.
ssh -L 8082:127.0.0.1:8082 alice@203.0.113.10Ouvrez 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.
cd ~/nextcloud
sudo docker compose exec -u www-data app php occ user:list - admincloud: admincloudSi 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.
sudo docker compose exec -u www-data app php occ config:system:get trusted_domainslocalhost
cloud.exemple.frSi 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.
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_domainsSystem config value trusted_domains => 2 set to string 203.0.113.10
localhost
cloud.exemple.fr
203.0.113.10Pour 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.
OVERWRITEPROTOCOL: httpssudo docker compose up -d
sudo docker compose exec -u www-data app php occ config:system:get overwriteprotocolhttpsAttention : 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-dumpexporte la base en un fichier texte, depuis le conteneurdb. L'option--single-transactionévite de bloquer les lectures.tararchive les fichiers, dans un conteneur jetable fait avecalpine: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é.
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.gzMaintenance mode enabled
Maintenance mode disabledVous 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
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 --offMaintenance mode disabledReste 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.
cd ~/nextcloud
sudo docker compose pull
sudo docker compose up -dAu 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.
sudo docker compose exec -u www-data app php occ status | head -3 - installed: true
- version: 34.0.5.1
- versionstring: 34.0.5L'é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~/nextcloudet vérifiez avecls -aque 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.