So migrierst Du von ownCloud zu Nextcloud: Schritt-für-Schritt-Anleitung

Die Migration von ownCloud zu Nextcloud ermöglicht es Unternehmen und Self-Hostern, ihre vorhandenen Dateien, Benutzer, Freigaben und Konfigurationen weiterhin zu nutzen und gleichzeitig auf eine Plattform mit einem größeren Ökosystem und kontinuierlicher Weiterentwicklung umzusteigen. Eine erfolgreiche Migration erfordert jedoch eine sorgfältige Planung, um Kompatibilitätsprobleme, Datenverlust oder Serviceunterbrechungen zu vermeiden.

In diesem Leitfaden erfährst Du Schritt für Schritt, wie Du von ownCloud zu Nextcloud migrierst. Außerdem lernst Du, wie Du Deine Umgebung vorbereitest, Backups erstellst, den Migrationsprozess durchführst, die Ergebnisse überprüfst und häufige Probleme behebst, die dabei auftreten können.

Warum von ownCloud zu Nextcloud migrieren?

Viele Unternehmen und Self-Hoster entscheiden sich für die Migration von ownCloud zu Nextcloud, um von einem größeren Ökosystem, regelmäßigen Feature-Updates und einer Vielzahl an Integrationen zu profitieren. Nextcloud unterstützt die Synchronisierung und Freigabe von Dateien und bietet außerdem Tools für Zusammenarbeit, Kommunikation, Office-Produktivität und Workflow-Automatisierung.

Ein weiterer Grund für die Migration ist die Flexibilität. Nextcloud bietet eine Open-Source-Plattform, die auf privater Infrastruktur, Virtual Private Servern oder dedizierten Servern bereitgestellt werden kann. Dadurch erhältst Du mehr Kontrolle über Datenverwaltung und Sicherheit. Für Unternehmen, die bereits ownCloud nutzen, kann die Migration zu Nextcloud den Mehrwert ihrer bestehenden Installation erweitern, ohne dass Benutzer von Grund auf neu beginnen müssen.

Bei CloudBased Backup bieten wir vollständig verwaltetes Nextcloud Hosting an, das Infrastrukturverwaltung, Backups, Sicherheitsupdates und kontinuierliche Wartung umfasst. Wenn Du Fragen zur Migration von ownCloud zu Nextcloud hast oder Unterstützung bei Deiner Bereitstellung benötigst, kannst Du unser Team über unsere Kontaktseite erreichen.

Was Du vor der Migration von ownCloud zu Nextcloud überprüfen solltest

Bevor Du mit der Migration von ownCloud zu Nextcloud beginnst, solltest Du Dir die Zeit nehmen, Deine Umgebung zu überprüfen und mögliche Kompatibilitätsprobleme zu identifizieren. Wenn Du diese Punkte im Voraus berücksichtigst, kannst Du Migrationsfehler, Anwendungskonflikte und unerwartete Ausfallzeiten vermeiden.

Aktuelle ownCloud-Version: Überprüfe, welche Version Du verwendest, und sieh Dir den unterstützten Migrationspfad an. Bei einigen älteren ownCloud-Versionen kann zunächst ein Upgrade auf eine Zwischenversion von Nextcloud erforderlich sein, bevor Du auf die neueste Version wechseln kannst.

PHP-Kompatibilität: Stelle sicher, dass Deine geplante Nextcloud-Version Deine installierte PHP-Version unterstützt. Eine nicht unterstützte PHP-Version kann Upgrade-Fehler oder Probleme mit Anwendungen verursachen.

Datenbank-Kompatibilität: Überprüfe Deine Datenbankversion und stelle sicher, dass sie die Anforderungen von Nextcloud erfüllt. Dies ist besonders wichtig, wenn Du ältere Versionen von MySQL, MariaDB, PostgreSQL oder SQLite verwendest.

Installierte Apps und Erweiterungen: Überprüfe alle aktivierten ownCloud-Apps und stelle fest, ob entsprechende Nextcloud-Apps verfügbar sind. Einige Erweiterungen sind nach der Migration möglicherweise nicht kompatibel.

Verfügbarer Speicherplatz: Stelle sicher, dass ausreichend Speicherplatz für Backups, temporäre Dateien und Upgrade-Daten während des Migrationsprozesses vorhanden ist.

Wartungsfenster: Plane eine Ausfallzeit und informiere Deine Benutzer im Voraus. Wenn Du die Migration während eines Wartungsfensters durchführst, lassen sich Dateiänderungen und Synchronisierungskonflikte vermeiden, solange das Upgrade läuft.

Migration von ownCloud zu Nextcloud

Sobald Du die Kompatibilitätsanforderungen überprüft und Backups erstellt hast, kannst Du mit der Migration beginnen. Die Migration von ownCloud zu Nextcloud wird ähnlich wie ein manuelles Upgrade durchgeführt, wobei der Versionspfad eine entscheidende Rolle spielt.

Laut der offiziellen Nextcloud-Dokumentation funktioniert die Migration von ownCloud nur dann, wenn die Versionen von ownCloud und Nextcloud ausreichend kompatibel sind. Für aktuelle ownCloud-10-Versionen ist das offiziell dokumentierte Migrationsziel:

Migriere nicht direkt auf die neueste Nextcloud-Version. Nachdem Du auf die kompatible Nextcloud-Version migriert hast, aktualisiere Nextcloud entsprechend der offiziellen Nextcloud-Dokumentation jeweils um eine Hauptversion nach der anderen.

Schritt 1: Versions- und Umgebungskompatibilität überprüfen

Bevor Du beginnst, überprüfe Deine aktuelle ownCloud-Version:

sudo -u www-data php occ status

Überprüfe, ob Deine ownCloud-Version für die Migration zu Nextcloud unterstützt wird.

Du solltest außerdem Folgendes überprüfen:

• •PHP-Version
• •Datenbankversion
• •Webserver-Konfiguration
• •Installierte ownCloud-Apps
• •Speicherort des data/-Verzeichnisses
• •Verfügbaren Speicherplatz
• •Aktuelle cron-Konfiguration

Wichtig: ownCloud unterstützt PHP 8.0 oder höher nicht. Nextcloud 25 ist die letzte Nextcloud-Version, die PHP 7 unterstützt. Nachdem Du auf Nextcloud 25 migriert hast, aktualisiere PHP, bevor Du mit neueren Nextcloud-Versionen fortfährst.

Schritt 2: Ein vollständiges Backup erstellen

Bevor Du Änderungen vornimmst, erstelle ein aktuelles Backup von:

• •ownCloud-Datenbank
• •config/config.php
• •data-Verzeichnis
• •Benutzerdefinierten Apps
• •Benutzerdefinierten Themes
• •Webserver-Konfiguration

Erstelle beispielsweise ein Backup der Datenbank:

mysqldump -u root -p owncloud > owncloud-db-backup.sql

Erstelle ein Backup des ownCloud-Installationsverzeichnisses:

cp -a /var/www/owncloud /var/www/owncloud-backup

Falls sich Dein data-Verzeichnis außerhalb des ownCloud-Installationsverzeichnisses befindet, sichere es separat:

cp -a /path/to/owncloud-data /path/to/owncloud-data-backup

Fahre erst fort, nachdem Du bestätigt hast, dass sich das Backup bei Bedarf wiederherstellen lässt.

Schritt 3: Drittanbieter-Apps nach Möglichkeit deaktivieren

Deaktiviere vor der Migration nach Möglichkeit alle Drittanbieter-Apps, die nicht zum Core von ownCloud gehören. Dadurch verringerst Du das Risiko von App-Kompatibilitätsproblemen während des Upgrades.

Installierte Apps auflisten:

sudo -u www-data php occ app:list

Deaktiviere bei Bedarf Drittanbieter-Apps:

sudo -u www-data php occ app:disable app_name

Ersetze app_name durch die tatsächliche App-ID.

Einige Apps aus dem ownCloud Marketplace sind möglicherweise nicht mit Nextcloud kompatibel und müssen später aus dem Nextcloud App Store erneut installiert werden.

Schritt 4: Wartungsmodus aktivieren

Versetze die ownCloud-Instanz in den Wartungsmodus, damit Benutzer während der Migration keine Dateien hochladen oder Daten ändern können.

Führe dies im ownCloud-Installationsverzeichnis aus:

cd /var/www/owncloud
sudo -u www-data php occ maintenance:mode --on

Falls Dein Webserver ein anderes Benutzerkonto verwendet, ersetze www-data durch den entsprechenden Benutzer.

Schritt 5: Webserver stoppen und cron deaktivieren

Stoppe den Webserver, bevor Du die Anwendungsdateien ersetzt.

Für Apache:

sudo systemctl stop apache2

Für Nginx:

sudo systemctl stop nginx

Falls ownCloud den System-cron verwendet, deaktiviere ihn vorübergehend:

sudo crontab -u www-data -e

Kommentiere den ownCloud-cron-Eintrag aus, indem Du am Anfang der Zeile ein # hinzufügst.

Beispiel:

# */5 * * * * php -f /var/www/owncloud/cron.php

Schritt 6: Die kompatible Nextcloud-Version herunterladen

Verwende nicht latest.zip.

Lade die kompatible Nextcloud-Version von der offiziellen Nextcloud-Releases-Seite herunter. Für ownCloud 10.13.x bis 10.16.x verwende Nextcloud 25.0.13.

cd /tmp
wget https://download.nextcloud.com/server/releases/nextcloud-25.0.13.zip
unzip nextcloud-25.0.13.zip

Offizielles Release-Archiv: https://nextcloud.com/changelog/

Schritt 7: Die ownCloud-Anwendungsdateien ersetzen

Benenne das vorhandene ownCloud-Installationsverzeichnis um, damit es bei Bedarf wiederhergestellt werden kann:

mv /var/www/owncloud /var/www/owncloud-old

Verschiebe die entpackten Nextcloud-Dateien in das Webserver-Verzeichnis:

mv /tmp/nextcloud /var/www/owncloud

Dadurch bleibt der ursprüngliche Webpfad unverändert. Wenn Deine Website stattdessen für die Verwendung von /var/www/nextcloud konfiguriert ist, passe den Pfad entsprechend an.

Lösche /var/www/owncloud-old erst, nachdem die Migration vollständig getestet wurde.

Schritt 8: Die vorhandene Konfigurationsdatei kopieren

Kopiere die alte ownCloud-Konfigurationsdatei in die neue Nextcloud-Installation:

cp /var/www/owncloud-old/config/config.php /var/www/owncloud/config/

Dadurch bleiben Deine Datenbankverbindung, vertrauenswürdigen Domains, der Pfad zum Datenverzeichnis, die installierte Instanz-ID und weitere wichtige Einstellungen erhalten.

Schritt 9: Das Datenverzeichnis verschieben oder beibehalten

Wenn sich Dein data/-Verzeichnis innerhalb des ownCloud-Installationsverzeichnisses befindet, verschiebe es in das neue Nextcloud-Verzeichnis:

mv /var/www/owncloud-old/data /var/www/owncloud/

Wenn sich Dein Datenverzeichnis außerhalb des ownCloud-Installationsverzeichnisses befindet, verschiebe es nicht. Überprüfe stattdessen, ob der Wert datadirectory in config.php weiterhin auf den richtigen Pfad verweist.

Überprüfen:

grep datadirectory /var/www/owncloud/config/config.php

Beispiel:

'datadirectory' => '/mnt/storage/owncloud-data',

Schritt 10: Benutzerdefinierte Apps und Themes bei Bedarf übernehmen

Wenn Du benutzerdefinierte Apps, externe App-Ordner oder Themes verwendet hast, vergleiche die alten und neuen Verzeichnisse.

Alte Apps überprüfen:

ls /var/www/owncloud-old/apps

Neue Apps überprüfen:

ls /var/www/owncloud/apps

Kopiere bei Bedarf kompatible benutzerdefinierte Apps:

cp -a /var/www/owncloud-old/apps/custom_app /var/www/owncloud/apps/

Wenn Du benutzerdefinierte Themes verwendet hast, kopiere diese ebenfalls:

cp -a /var/www/owncloud-old/themes/custom_theme /var/www/owncloud/themes/

Kopiere nur Apps und Themes, die mit der Zielversion von Nextcloud kompatibel sind.

Schritt 11: Die richtigen Eigentümer und Berechtigungen festlegen

Lege den Eigentümer für die Nextcloud-Dateien fest:

sudo chown -R www-data:www-data /var/www/owncloud

Lege die Verzeichnis- und Dateiberechtigungen fest:

sudo find /var/www/owncloud/ -type d -exec chmod 750 {} \;
sudo find /var/www/owncloud/ -type f -exec chmod 640 {} \;

Wenn Dein Webserver ein anderes Benutzerkonto verwendet, ersetze www-data durch den entsprechenden Benutzer.

Schritt 12: Den Webserver neu starten

Starte den Webserver neu, bevor Du den Upgrade-Befehl ausführst.

Für Apache:

sudo systemctl start apache2

Für Nginx:

sudo systemctl start nginx

Schritt 13: Den Nextcloud-Upgrade-Befehl ausführen

Wechsle in das neue Nextcloud-Installationsverzeichnis:

cd /var/www/owncloud

Führe den Upgrade-Befehl aus:

sudo -E -u www-data php occ upgrade

Der Upgrade-Prozess kann je nach Größe der Datenbank und des Dateisystems mehrere Minuten oder länger dauern.

Überprüfe die Ausgabe sorgfältig auf Fehler oder Warnungen.

Schritt 14: Erforderliche Befehle zur Datenbankwartung ausführen

Wenn Du auf Nextcloud 20 oder höher migrierst, empfiehlt die offizielle Nextcloud-Dokumentation, nach occ upgrade die folgenden Befehle auszuführen:

sudo -E -u www-data php occ db:convert-filecache-bigint
sudo -E -u www-data php occ db:add-missing-columns
sudo -E -u www-data php occ db:add-missing-indices
sudo -E -u www-data php occ db:add-missing-primary-keys

Diese Befehle aktualisieren Datenbankspalten, Indizes und Primärschlüssel, die nach der Migration erforderlich sein können.

Wenn Du während der bigint-Konvertierung zur Bestätigung aufgefordert wirst, lies die Meldung sorgfältig durch und fahre während eines geeigneten Wartungsfensters fort.

Schritt 15: Die Wartungsreparatur ausführen

Führe den Befehl zur Wartungsreparatur aus:

sudo -E -u www-data php occ maintenance:repair

Wenn Nextcloud in der Admin-Übersicht oder in der Befehlsausgabe zusätzliche Befehle empfiehlt, führe diese aus, bevor Du das System wieder produktiv nutzt.

Schritt 16: Den Wartungsmodus deaktivieren

Sobald das Upgrade und die Reparaturaufgaben abgeschlossen sind, deaktiviere den Wartungsmodus:

sudo -E -u www-data php occ maintenance:mode --off

Schritt 17: cron wieder aktivieren

Aktiviere den cron-Job, den Du zuvor deaktiviert hast, wieder:

sudo crontab -u www-data -e

Entferne das # aus dem cron-Eintrag.

Für Nextcloud sieht der cron-Eintrag in der Regel wie folgt aus:

*/5 * * * * php -f /var/www/owncloud/cron.php

Wenn Dein cron zuvor occ system:cron verwendet hat, aktualisiere ihn gemäß der offiziellen Nextcloud-Dokumentation zu Background Jobs, sodass der PHP-cron-Befehl verwendet wird.

Schritt 18: Die Migration überprüfen

Melde Dich als Administrator an und überprüfe Folgendes:

• •Benutzer sind vorhanden.
• •Dateien sind zugänglich.
• •Freigaben sind vorhanden.
• •Gruppen sind vorhanden.
• •Externer Speicher funktioniert weiterhin.
• •LDAP oder SSO funktionieren weiterhin, sofern sie verwendet werden.
• •Apps sind kompatibel.
• •Background Jobs werden ausgeführt.
• •E-Mail-Einstellungen funktionieren weiterhin.
• •Dateisperrung funktioniert.
• •In den Protokollen werden keine schwerwiegenden Fehler angezeigt.

Überprüfe die Nextcloud-Version:

sudo -E -u www-data php occ status

Überprüfe Systemwarnungen unter:

Einstellungen → Administration → Übersicht

Überprüfe außerdem die Protokolle:

tail -f /var/www/owncloud/data/nextcloud.log

Schritt 19: Kompatible Apps erneut installieren oder aktivieren

Einige ownCloud-Apps können deaktiviert sein, weil sie nicht mit Nextcloud kompatibel sind.

Installiere oder aktiviere die Nextcloud-Versionen der benötigten Apps aus dem Nextcloud App Store.

Zum Beispiel:

sudo -E -u www-data php occ app:enable calendarsudo -E -u www-data php occ app:enable contacts

Aktiviere nur Apps, die mit Deiner aktuellen Nextcloud-Version kompatibel sind.

Schritt 20: PHP aktualisieren und Nextcloud weiter aktualisieren

Nachdem Du erfolgreich auf Nextcloud 25.0.13 migriert hast, aktualisiere PHP auf eine Version, die von Deiner nächsten Zielversion von Nextcloud unterstützt wird.

Aktualisiere anschließend Nextcloud jeweils um eine Hauptversion nach der anderen.

Überspringe keine Hauptversionen.

Beispiel für den Upgrade-Pfad:

Nextcloud 25 → 26 → 27 → 28 → 29 → 30 → 31 → spätere unterstützte Versionen

Vor jedem Hauptversions-Upgrade:

• •Release Notes prüfen
• •PHP-Kompatibilität bestätigen
• •Datenbank-Kompatibilität bestätigen
• •Apps aktualisieren
• •Ein aktuelles Backup erstellen
• •Das Upgrade durchführen
• •Warnungen in der Admin-Übersicht überprüfen

Häufige Probleme bei der Migration von ownCloud zu Nextcloud und deren Lösungen

Auch wenn Du den empfohlenen Migrationsprozess befolgst, können Kompatibilitäts-, Konfigurations- oder Upgrade-bezogene Probleme auftreten. Hier sind einige der häufigsten Probleme und wie Du sie beheben kannst.

Fehler aufgrund eines nicht unterstützten Upgrade-Pfads: Der Versuch, direkt auf die neueste Nextcloud-Version zu migrieren, kann dazu führen, dass das Upgrade fehlschlägt. Befolge den unterstützten Migrationspfad und aktualisiere jeweils eine Hauptversion nach der anderen über die erforderlichen Nextcloud-Versionen.

Probleme mit der PHP-Kompatibilität: Während der Migration oder des Upgrades können Probleme auftreten, wenn Deine PHP-Version die Anforderungen der Zielversion von Nextcloud nicht erfüllt. Überprüfe vor jedem Upgrade die PHP-Kompatibilität und aktualisiere PHP bei Bedarf.

Probleme mit der App-Kompatibilität: Einige Apps aus dem ownCloud Marketplace sind nicht mit Nextcloud kompatibel. Deaktiviere Drittanbieter-Apps vor der Migration und installiere nach der Migration kompatible Alternativen aus dem Nextcloud App Store.

Fehler bei Dateiberechtigungen: Falsche Eigentümer oder Berechtigungen können verhindern, dass Nextcloud auf Dateien zugreift, Upgrades ausführt oder Background Jobs verarbeitet. Überprüfe, ob der Benutzer des Webservers Eigentümer der Nextcloud-Installation und der Datenverzeichnisse ist.

Wartungsmodus bleibt nach der Migration aktiv: Wenn der Upgrade-Prozess unterbrochen wird oder ein Fehler auftritt, kann Nextcloud im Wartungsmodus verbleiben. Überprüfe die Protokolle, behebe die zugrunde liegende Ursache und deaktiviere den Wartungsmodus, nachdem Du sichergestellt hast, dass das System ordnungsgemäß funktioniert.

cron-Jobs werden nicht ausgeführt: Hintergrundaufgaben wie Dateiscans, Benachrichtigungen und Bereinigungsaufgaben funktionieren möglicherweise nicht mehr, wenn die cron-Jobs nach der Migration nicht wieder aktiviert werden. Überprüfe, ob der geplante cron-Job korrekt konfiguriert ist und wie erwartet ausgeführt wird.

Fehlende Dateien oder Probleme mit externem Speicher: Dateien können als fehlend erscheinen, wenn der Pfad zum Datenverzeichnis nicht korrekt ist oder Verbindungen zu externem Speicher nicht ordnungsgemäß migriert wurden. Überprüfe die Einstellungen in Deiner config.php und teste nach der Migration alle eingebundenen externen Speicher.

Fazit

Die Migration von ownCloud zu Nextcloud kann durchgeführt werden, ohne Benutzer, Dateien, Freigaben oder Konfigurationsdaten zu verlieren, wenn der richtige Migrationspfad eingehalten wird. Die wichtigsten Schritte sind die Überprüfung der Versionskompatibilität, das Erstellen vollständiger Backups und die sorgfältige Validierung der Umgebung nach der Migration.

Da die meisten ownCloud-Installationen nicht direkt auf die neueste Nextcloud-Version migriert werden können, solltest Du unbedingt dem empfohlenen Upgrade-Pfad folgen und jeweils eine unterstützte Hauptversion nach der anderen aktualisieren. Mit einer sorgfältigen Planung und gründlichen Tests kannst Du den Wechsel zu Nextcloud durchführen, während die Stabilität des Systems erhalten bleibt und Ausfallzeiten für Benutzer auf ein Minimum reduziert werden.