Migreren vanuit een andere Immich-server

Als u al een zelf gehoste Immich-server gebruikt en uw bibliotheek naar PixelUnion wilt verplaatsen, kunt u dit rechtstreeks doen via Immich Go. De migratie zet uw foto’s, video’s en albumstructuur over van het ene Immich-exemplaar naar het andere, zonder dat alles via uw computer hoeft te lopen.

Wat u nodig heeft

• Toegang tot uw bestaande Immich-server (die bereikbaar moet zijn via het netwerk)
• Een API-sleutel van uw bestaande Immich-server
• Een API-sleutel van uw PixelUnion-account
• Immich Go gedownload op uw computer

Stap 1: API-sleutel aanmaken op de bronserver

1. Log in op uw bestaande Immich-server
2. Klik op uw profielicoontje (rechtsboven) en ga naar Accountinstellingen
3. Ga naar API-sleutels en klik op Nieuwe API-sleutel
4. Geef het een naam (bijv. “Migratie”) en zorg dat de machtigingen asset.read en asset.copy zijn ingeschakeld
5. Kopieer de gegenereerde sleutel en bewaar hem op een veilige plek

Stap 2: API-sleutel aanmaken op PixelUnion

1. Log in op uw PixelUnion-domein (bijv. https://uwnaam.pixelunion.eu)
2. Klik op uw profielicoontje (rechtsboven) en ga naar Accountinstellingen
3. Ga naar API-sleutels en klik op Nieuwe API-sleutel
4. Geef het een naam (bijv. “Migratie”) en kopieer de gegenereerde sleutel

Stap 3: Immich Go downloaden

Ga naar de Immich Go releases-pagina en download de versie voor uw besturingssysteem:

• Windows: het .exe-bestand
• macOS: het bestand met darwin in de naam
• Linux: het bestand met linux in de naam

Pak het archief uit en plaats het uitvoerbare bestand immich-go in een handige map.

Stap 4: De migratie uitvoeren

Open een terminal, navigeer naar de map met immich-go en voer het volgende uit:

macOS / Linux:

./immich-go upload from-immich \
  --from-server=https://uw-oude-server.com \
  --from-api-key=UW_BRON_API_SLEUTEL \
  --server=https://uwnaam.pixelunion.eu \
  --api-key=UW_PIXELUNION_API_SLEUTEL

Windows:

.\immich-go.exe upload from-immich --from-server=https://uw-oude-server.com --from-api-key=UW_BRON_API_SLEUTEL --server=https://uwnaam.pixelunion.eu --api-key=UW_PIXELUNION_API_SLEUTEL

Vervang de plaatshouders door uw werkelijke server-URL’s en API-sleutels.

Immich Go verbindt met beide servers, detecteert bestanden die al aanwezig zijn op de bestemming en zet de rest over. Uw albumstructuur wordt automatisch bewaard.

Tips

Versnel de migratie door meerdere parallelle overdrachten uit te voeren:

./immich-go upload from-immich \
  --from-server=https://uw-oude-server.com \
  --from-api-key=UW_BRON_API_SLEUTEL \
  --server=https://uwnaam.pixelunion.eu \
  --api-key=UW_PIXELUNION_API_SLEUTEL \
  --concurrent-tasks=4

Alleen specifieke albums migreren:

./immich-go upload from-immich \
  --from-server=https://uw-oude-server.com \
  --from-api-key=UW_BRON_API_SLEUTEL \
  --server=https://uwnaam.pixelunion.eu \
  --api-key=UW_PIXELUNION_API_SLEUTEL \
  --from-album="Familie" \
  --from-album="Vakanties"

Onderbroken migratie hervatten: Als het proces wordt onderbroken, voert u gewoon dezelfde opdracht opnieuw uit. Immich Go houdt bij wat al is overgedragen en slaat die bestanden over.

Hoe lang duurt het?

De migratiesnelheid hangt af van de grootte van uw bibliotheek en uw internetverbinding. Als grove richtlijn:

• 10 GB: ongeveer 30–60 minuten
• 100 GB: meerdere uren, het beste ’s nachts laten draaien
• 500 GB+: plan een volledige dag of meer

Problemen oplossen

Verbindingsfouten: Controleer of de URL van uw bronserver correct is en bereikbaar is vanaf uw computer. Zorg dat de URL begint met https:// of http://.

Machtigingsfouten: Controleer of de API-sleutel van uw bronserver de machtigingen asset.read en asset.copy heeft.

Albums ontbreken: Albums worden aangemaakt tijdens de overdracht. Als een album ontbreekt na de migratie, voert u de opdracht opnieuw uit — Immich Go slaat al overgedragen bestanden over en probeert onvolledige onderdelen opnieuw.

Heeft u problemen? Neem contact op met ons supportteam.