Serveur : whvd2001 (10.21.60.16) — Debian 12
Répertoire : /home/debianadmin/wikijs/
URL : https://wiki.carontech.net
Méthode : Manuelle (pas de Watchtower, pas de cron)
Se connecter sur whvd2001 :
ssh [email protected]
cd ~/wikijs
Effectuer le dump PostgreSQL :
docker exec wikijs-db-1 pg_dump -U wiki wiki \
> ~/wikijs/backup-wikijs-$(date +%Y%m%d).sql
Vérifier que le fichier est présent et non vide :
ls -lh ~/wikijs/backup-wikijs-*.sql
💡 Conserver ce fichier jusqu'à validation complète de la mise à jour. Le supprimer une fois confirmé.
docker ps --format "table {{.Names}}\t{{.Image}}\t{{.Status}}"
La version actuelle est visible dans l'interface Wiki.JS :
Administration → Système → version affichée en bas de page.
Version actuelle : 2.5.312
nano ~/wikijs/docker-compose.yml
Modifier la ligne image du service wiki pour épingler la version cible :
wiki:
image: requarks/wiki:2.5.xxx # remplacer par la version cible
⚠️ Ne pas laisser
requarks/wiki:2sans version épinglée en production — cela applique automatiquement toute nouvelle version sans contrôle.
docker compose pull
Les images sont téléchargées mais les conteneurs ne sont pas encore redémarrés.
docker compose up -d
Docker remplace les conteneurs avec les nouvelles images. Les migrations de base de données s'exécutent automatiquement au démarrage.
# État des conteneurs (attendre que tous soient healthy)
docker ps
# Logs Wiki.JS — vérifier l'absence d'erreurs
docker compose logs --tail=50 wiki
Accéder à l'interface web et vérifier :
Une fois la mise à jour validée :
docker image prune -f
Et supprimer le fichier de sauvegarde si tout est correct :
rm ~/wikijs/backup-wikijs-<DATE>.sql
Si la mise à jour cause un problème :
1. Remettre l'ancienne version dans docker-compose.yml :
nano ~/wikijs/docker-compose.yml
# image: requarks/wiki:2.5.<ancienne-version>
2. Redémarrer avec l'ancienne image :
docker compose up -d
3. Si la base de données est corrompue — restaurer le dump :
# Arrêter Wiki.JS (garder PostgreSQL actif)
docker compose stop wiki
# Restaurer
docker exec -i wikijs-db-1 psql -U wiki -d wiki < ~/wikijs/backup-wikijs-<DATE>.sql
# Redémarrer
docker compose up -d