Migration von einem anderen Immich-Server

Wenn Sie bereits einen selbst gehosteten Immich-Server betreiben und Ihre Bibliothek zu PixelUnion umziehen möchten, können Sie dies direkt mit Immich Go tun. Die Migration überträgt Ihre Fotos, Videos und Albumstruktur von einer Immich-Instanz zur anderen, ohne dass alles über Ihren lokalen Computer laufen muss.

Was Sie benötigen

• Zugriff auf Ihren bestehenden Immich-Server (er muss über das Netzwerk erreichbar sein)
• Einen API-Schlüssel Ihres bestehenden Immich-Servers
• Einen API-Schlüssel Ihres PixelUnion-Kontos
• Immich Go auf Ihrem Computer heruntergeladen

Schritt 1: API-Schlüssel auf dem Quell-Server erstellen

1. Melden Sie sich bei Ihrem bestehenden Immich-Server an
2. Klicken Sie auf Ihr Profilsymbol (oben rechts) und gehen Sie zu Kontoeinstellungen
3. Navigieren Sie zu API-Schlüssel und klicken Sie auf Neuer API-Schlüssel
4. Vergeben Sie einen Namen (z. B. “Migration”) und stellen Sie sicher, dass die Berechtigungen asset.read und asset.copy aktiviert sind
5. Kopieren Sie den generierten Schlüssel und bewahren Sie ihn sicher auf

Schritt 2: API-Schlüssel bei PixelUnion erstellen

1. Melden Sie sich bei Ihrer PixelUnion-Domain an (z. B. https://ihrname.pixelunion.eu)
2. Klicken Sie auf Ihr Profilsymbol (oben rechts) und gehen Sie zu Kontoeinstellungen
3. Navigieren Sie zu API-Schlüssel und klicken Sie auf Neuer API-Schlüssel
4. Vergeben Sie einen Namen (z. B. “Migration”) und kopieren Sie den generierten Schlüssel

Schritt 3: Immich Go herunterladen

Gehen Sie zur Immich Go Releases-Seite und laden Sie die Version für Ihr Betriebssystem herunter:

• Windows: die .exe-Datei
• macOS: die Datei mit darwin im Namen
• Linux: die Datei mit linux im Namen

Entpacken Sie das Archiv und legen Sie die ausführbare Datei immich-go in einem geeigneten Ordner ab.

Schritt 4: Migration starten

Öffnen Sie ein Terminal, wechseln Sie in den Ordner mit immich-go und führen Sie folgenden Befehl aus:

macOS / Linux:

./immich-go upload from-immich \
  --from-server=https://ihr-alter-server.com \
  --from-api-key=IHR_SOURCE_API_KEY \
  --server=https://ihrname.pixelunion.eu \
  --api-key=IHR_PIXELUNION_API_KEY

Windows:

.\immich-go.exe upload from-immich --from-server=https://ihr-alter-server.com --from-api-key=IHR_SOURCE_API_KEY --server=https://ihrname.pixelunion.eu --api-key=IHR_PIXELUNION_API_KEY

Ersetzen Sie die Platzhalter durch Ihre tatsächlichen Server-URLs und API-Schlüssel.

Immich Go verbindet sich mit beiden Servern, erkennt bereits vorhandene Dateien am Ziel und überträgt alles andere. Ihre Albumstruktur wird automatisch beibehalten.

Tipps

Migration beschleunigen durch parallele Übertragungen:

./immich-go upload from-immich \
  --from-server=https://ihr-alter-server.com \
  --from-api-key=IHR_SOURCE_API_KEY \
  --server=https://ihrname.pixelunion.eu \
  --api-key=IHR_PIXELUNION_API_KEY \
  --concurrent-tasks=4

Nur bestimmte Alben migrieren:

./immich-go upload from-immich \
  --from-server=https://ihr-alter-server.com \
  --from-api-key=IHR_SOURCE_API_KEY \
  --server=https://ihrname.pixelunion.eu \
  --api-key=IHR_PIXELUNION_API_KEY \
  --from-album="Familie" \
  --from-album="Urlaub"

Unterbrochene Migration fortsetzen: Falls der Vorgang unterbrochen wird, führen Sie denselben Befehl einfach erneut aus. Immich Go merkt sich, was bereits übertragen wurde, und überspringt diese Dateien.

Wie lange dauert es?

Die Migrationsgeschwindigkeit hängt von der Größe Ihrer Bibliothek und Ihrer Internetverbindung ab. Als grobe Orientierung:

• 10 GB: etwa 30–60 Minuten
• 100 GB: mehrere Stunden, am besten über Nacht laufen lassen
• 500 GB+: planen Sie einen vollen Tag oder mehr ein

Fehlerbehebung

Verbindungsfehler: Überprüfen Sie, ob die URL Ihres Quell-Servers korrekt und von Ihrem Computer aus erreichbar ist. Die URL muss mit https:// oder http:// beginnen.

Berechtigungsfehler: Stellen Sie sicher, dass der API-Schlüssel für Ihren Quell-Server die Berechtigungen asset.read und asset.copy besitzt.

Alben fehlen: Alben werden während der Übertragung erstellt. Falls ein Album nach Abschluss der Migration fehlt, führen Sie den Befehl erneut aus – Immich Go überspringt bereits übertragene Dateien und wiederholt unvollständige Teile.

Bei Problemen wenden Sie sich an unser Support-Team.