🚀 Déménager une instance Nextcloud bien installée vers un serveur neuf (avec Bash & Ansible)

🌐 Aussi en: English · Deutsch · Español

(Cet article est la suite logique du script de sauvegarde décrit ici : Nextcloud Backup Like a Pro – Automated with Bash. Les deux articles vont de pair et forment ensemble le workflow complet de migration et de reprise après sinistre.)

Après plusieurs années passées avec une fidèle instance Nextcloud – avec ses innombrables fichiers utilisateurs, calendriers, contacts et dossiers partagés plus ou moins farfelus –, il était temps de passer à la vitesse supérieure. L’ancien serveur commençait à accuser son âge, et une toute nouvelle machine avait été provisionnée avec Ansible pour repartir sur des bases saines.

Plutôt que de bricoler avec des exports manuels, des interfaces web capricieuses ou des plugins de sauvegarde dans le navigateur, j’ai opté pour un script Bash sobre et efficace qui gère toute la migration. Il m’a permis de déplacer l’ensemble de la pile Nextcloud (fichiers du cœur, données utilisateurs et base de données) vers le nouveau serveur – de façon reproductible et avec un temps d’arrêt minimal.

🧠 Ce que fait ce script

1. Arrête proprement les services sur le serveur cible pour éviter les verrous de fichiers et les conflits.
2. Synchronise les fichiers de l’application Nextcloud (sans le répertoire data/).
3. Transfère les données utilisateurs séparément vers leur nouveau chemin de destination.
4. Restaure la base de données à partir d’un dump local avec scp et mysql.
5. Corrige propriétaires et permissions pour l’accès du serveur web.
6. Redémarre PHP et les services web une fois que tout est en place.
7. Confirme la fin de l’opération par un message d’état final.

📁 Remarques sur l’arborescence

Dans le cadre de la migration, nous avons aussi déplacé le répertoire data/ vers un emplacement dédié, en dehors de la racine web d’Apache. C’est une approche plus propre et plus sûre que de stocker les données utilisateurs dans le répertoire d’installation principal de Nextcloud (ce qui était le cas auparavant).

Le script tient compte de ce changement : il transfère le dossier data/ séparément et le place à son nouvel emplacement externe sur le serveur cible.

⚙️ Le script de migration

#!/bin/bash

# === CONFIGURATION ===

REMOTE_USER="root"
REMOTE_HOST="your.remote.ip"
REMOTE_SSH_PORT=22
SSH_KEY="$HOME/.ssh/id_rsa"

BACKUP_DIR="/data/backup/nextcloud/instance-a"
REMOTE_NEXTCLOUD_DIR="/var/www/html/nextcloud"
REMOTE_DATA_DIR="/data"
DB_NAME="your.db.name"
DB_USER="your.user"
DB_PASS="********"  # 🔐 Password removed for security
WWW_USER="www-data"

SSH_CMD="ssh -i $SSH_KEY -p $REMOTE_SSH_PORT -o LogLevel=ERROR $REMOTE_USER@$REMOTE_HOST"

echo "🛑 [1/7] Stopping remote web and PHP services ..."
$SSH_CMD "systemctl stop apache2 2>/dev/null || systemctl stop httpd 2>/dev/null"
$SSH_CMD "systemctl stop php8.2-fpm 2>/dev/null || true"

echo "📤 [2/7] Transferring Nextcloud files (excluding data/) to remote server ..."
rsync -a --delete --exclude "data/" \
  -e "ssh -i $SSH_KEY -p $REMOTE_SSH_PORT -o LogLevel=ERROR" \
  "$BACKUP_DIR/nextcloud/" "$REMOTE_USER@$REMOTE_HOST:$REMOTE_NEXTCLOUD_DIR/"

echo "📤 [3/7] Transferring user data (nextcloud/data/) to remote /data ..."
rsync -a --delete \
  -e "ssh -i $SSH_KEY -p $REMOTE_SSH_PORT -o LogLevel=ERROR" \
  "$BACKUP_DIR/nextcloud/data/" "$REMOTE_USER@$REMOTE_HOST:$REMOTE_DATA_DIR/"

echo "🛢️  [4/7] Transferring and restoring database dump ..."
scp -i "$SSH_KEY" -P $REMOTE_SSH_PORT "$BACKUP_DIR/db.sql" "$REMOTE_USER@$REMOTE_HOST:/tmp/db.sql"
$SSH_CMD "mysql -u '$DB_USER' -p'********' '$DB_NAME' < /tmp/db.sql && rm /tmp/db.sql" echo "🔒 [5/7] Setting remote file permissions ..." $SSH_CMD "chown -R '$WWW_USER:$WWW_USER' '$REMOTE_NEXTCLOUD_DIR'" $SSH_CMD "chown -R '$WWW_USER:$WWW_USER' '$REMOTE_DATA_DIR'" echo "🚀 [6/7] Starting remote services ..." $SSH_CMD "systemctl start php8.2-fpm 2>/dev/null || true"
$SSH_CMD "systemctl start apache2 2>/dev/null || systemctl start httpd 2>/dev/null"

echo "✅ [7/7] Remote restore complete. Please verify your Nextcloud instance at: https://$REMOTE_HOST"

🎉 Le mot de la fin

Migrer une instance Nextcloud en production qui tourne depuis des années – avec de vraies données et de vrais utilisateurs – peut intimider. Mais avec une démarche structurée et une automatisation digne de ce nom, pas de quoi paniquer. Grâce à ce script et à un environnement cible propre, monté avec Ansible, toute l’opération a pris moins de 30 minutes, sans le moindre ajustement manuel. Les nerds jubilent.

Si vous préparez votre propre migration Nextcloud, surtout avec de gros volumes de données et zéro marge pour l’erreur humaine, essayez cette approche – et adaptez-la à votre façon de gérer votre infra.