🚀 Een volwassen Nextcloud-instantie verhuizen naar een verse server (met Bash & Ansible)

🌐 Ook in: English · Deutsch · Français · Español · Italiano · Português · Polski
(Dit artikel is het logische vervolg op het back-upscript dat hier beschreven wordt: Nextcloud-back-up als een pro – geautomatiseerd met Bash. Beide posts horen bij elkaar en vormen samen de volledige workflow voor migratie en disaster recovery.)
Na een aantal jaren met een trouwe Nextcloud-instantie — compleet met talloze gebruikersbestanden, agenda’s, contacten en eigenaardige gedeelde mappen — was het tijd voor een upgrade. De oude server begon sporen van ouderdom te vertonen, en een glanzende nieuwe machine was met Ansible ingericht voor een schone start.
In plaats van te rommelen met handmatige exports, wankele web-GUI’s of back-upplugins in de browser, koos ik voor een strak en efficiënt Bash-script dat de hele migratie afhandelt. Daarmee kon ik de complete Nextcloud-stack (core-bestanden, gebruikersdata en database) naar de nieuwe server verhuizen — reproduceerbaar en met minimale downtime.
🧠 Wat dit script doet
- Stopt netjes de services op de doelserver, om problemen met file locks of conflicten te voorkomen.
- Synchroniseert de Nextcloud-applicatiebestanden (zonder de map
data/). - Zet de gebruikersdata apart over naar het nieuwe doelpad.
- Zet de database terug uit een lokale dump met
scpenmysql. - Corrigeert eigenaar/rechten voor toegang door de webserver.
- Herstart PHP en de webservices als alles op zijn plek staat.
- Bevestigt de afronding met een laatste statusmelding.
📁 Opmerkingen over de mappenstructuur
Als onderdeel van de migratie hebben we ook de map data/ verplaatst naar een eigen locatie buiten de webroot van Apache. Dat is netter en veiliger dan gebruikersdata binnen de hoofdinstallatiemap van Nextcloud bewaren (wat eerder het geval was).
Dit script houdt rekening met die wijziging door de map data/ apart over te zetten en op zijn nieuwe, externe locatie op de doelserver te plaatsen.
⚙️ Het migratiescript
⚠️ Dit script verwijdert en overschrijft data op de doelserver. Maak eerst een back-up, probeer het op een testsysteem en pas elk pad aan je eigen omgeving aan.
#!/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"
🎉 Tot slot
Een live Nextcloud-instantie migreren die al jaren meegaat — met echte data en echte gebruikers — kan intimiderend zijn. Maar met een gestructureerde aanpak en degelijke automatisering hoeft dat niet. Dankzij dit script en een schone, op Ansible gebaseerde doelomgeving duurde het hele proces minder dan 30 minuten en was er geen enkele handmatige aanpassing nodig. Nerds, juich.
Als je je eigen Nextcloud-migratie plant, vooral met grote hoeveelheden data en de eis van nul menselijke fouten, probeer deze aanpak dan eens — en pas hem aan de stijl van je eigen infra aan.
