Migrer depuis un autre serveur Immich

Si vous utilisez déjà un serveur Immich auto-hébergé et souhaitez déplacer votre bibliothèque vers PixelUnion, vous pouvez le faire directement avec Immich Go. La migration transfère vos photos, vidéos et la structure de vos albums d’une instance Immich à l’autre, sans passer par votre ordinateur local.

Ce dont vous aurez besoin

• Accès à votre serveur Immich existant (il doit être accessible sur le réseau)
• Une clé API de votre serveur Immich existant
• Une clé API de votre compte PixelUnion
• Immich Go téléchargé sur votre ordinateur

Étape 1 : Créer une clé API sur le serveur source

1. Connectez-vous à votre serveur Immich existant
2. Cliquez sur votre icône de profil (en haut à droite) et allez dans Paramètres du compte
3. Accédez à Clés API et cliquez sur Nouvelle clé API
4. Donnez-lui un nom (ex. : “Migration”) et assurez-vous que les autorisations asset.read et asset.copy sont activées
5. Copiez la clé générée et conservez-la en lieu sûr

Étape 2 : Créer une clé API sur PixelUnion

1. Connectez-vous à votre domaine PixelUnion (ex. : https://votrenom.pixelunion.eu)
2. Cliquez sur votre icône de profil (en haut à droite) et allez dans Paramètres du compte
3. Accédez à Clés API et cliquez sur Nouvelle clé API
4. Donnez-lui un nom (ex. : “Migration”) et copiez la clé générée

Étape 3 : Télécharger Immich Go

Rendez-vous sur la page des versions d’Immich Go et téléchargez la version pour votre système d’exploitation :

• Windows : le fichier .exe
• macOS : le fichier contenant darwin dans le nom
• Linux : le fichier contenant linux dans le nom

Extrayez l’archive et placez l’exécutable immich-go dans un dossier pratique.

Étape 4 : Lancer la migration

Ouvrez un terminal, naviguez vers le dossier contenant immich-go et exécutez :

macOS / Linux :

./immich-go upload from-immich \
  --from-server=https://votre-ancien-serveur.com \
  --from-api-key=VOTRE_CLE_API_SOURCE \
  --server=https://votrenom.pixelunion.eu \
  --api-key=VOTRE_CLE_API_PIXELUNION

Windows :

.\immich-go.exe upload from-immich --from-server=https://votre-ancien-serveur.com --from-api-key=VOTRE_CLE_API_SOURCE --server=https://votrenom.pixelunion.eu --api-key=VOTRE_CLE_API_PIXELUNION

Remplacez les espaces réservés par vos URLs de serveur et clés API réelles.

Immich Go se connecte aux deux serveurs, détecte les fichiers déjà présents à la destination et transfère tout le reste. La structure de vos albums est préservée automatiquement.

Conseils

Accélérer la migration en lançant plusieurs transferts en parallèle :

./immich-go upload from-immich \
  --from-server=https://votre-ancien-serveur.com \
  --from-api-key=VOTRE_CLE_API_SOURCE \
  --server=https://votrenom.pixelunion.eu \
  --api-key=VOTRE_CLE_API_PIXELUNION \
  --concurrent-tasks=4

Migrer uniquement certains albums :

./immich-go upload from-immich \
  --from-server=https://votre-ancien-serveur.com \
  --from-api-key=VOTRE_CLE_API_SOURCE \
  --server=https://votrenom.pixelunion.eu \
  --api-key=VOTRE_CLE_API_PIXELUNION \
  --from-album="Famille" \
  --from-album="Vacances"

Reprendre une migration interrompue : Si le processus est interrompu, relancez simplement la même commande. Immich Go suit ce qui a déjà été transféré et ignore ces fichiers.

Combien de temps cela prend-il ?

La vitesse de migration dépend de la taille de votre bibliothèque et de votre connexion internet. À titre indicatif :

• 10 Go : environ 30 à 60 minutes
• 100 Go : plusieurs heures, de préférence à lancer la nuit
• 500 Go et plus : prévoyez une journée complète ou davantage

Résolution des problèmes

Erreurs de connexion : Vérifiez que l’URL de votre serveur source est correcte et accessible depuis votre ordinateur. L’URL doit commencer par https:// ou http://.

Erreurs de permission : Vérifiez que la clé API de votre serveur source dispose des autorisations asset.read et asset.copy.

Albums manquants : Les albums sont créés pendant le transfert. Si un album est absent après la migration, relancez la commande – Immich Go ignorera les fichiers déjà transférés et réessaiera les parties incomplètes.

Si vous rencontrez des problèmes, contactez notre équipe d’assistance.