Migracja z innego serwera Immich

Jeśli korzystasz już z samodzielnie hostowanego serwera Immich i chcesz przenieść swoją bibliotekę do PixelUnion, możesz to zrobić bezpośrednio za pomocą Immich Go. Migracja przenosi Twoje zdjęcia, filmy i strukturę albumów z jednej instancji Immich do drugiej, bez konieczności przechodzenia przez lokalny komputer.

Czego będziesz potrzebować

• Dostępu do istniejącego serwera Immich (musi być dostępny przez sieć)
• Klucza API z istniejącego serwera Immich
• Klucza API z konta PixelUnion
• Immich Go pobranego na komputer

Krok 1: Utwórz klucz API na serwerze źródłowym

1. Zaloguj się do istniejącego serwera Immich
2. Kliknij ikonę profilu (w prawym górnym rogu) i przejdź do Ustawień konta
3. Przejdź do Klucze API i kliknij Nowy klucz API
4. Nadaj mu nazwę (np. “Migracja”) i upewnij się, że uprawnienia asset.read i asset.copy są włączone
5. Skopiuj wygenerowany klucz i przechowaj go w bezpiecznym miejscu

Krok 2: Utwórz klucz API w PixelUnion

1. Zaloguj się do swojej domeny PixelUnion (np. https://twojanazwa.pixelunion.eu)
2. Kliknij ikonę profilu (w prawym górnym rogu) i przejdź do Ustawień konta
3. Przejdź do Klucze API i kliknij Nowy klucz API
4. Nadaj mu nazwę (np. “Migracja”) i skopiuj wygenerowany klucz

Krok 3: Pobierz Immich Go

Przejdź na stronę wydań Immich Go i pobierz wersję dla swojego systemu operacyjnego:

• Windows: plik z rozszerzeniem .exe
• macOS: plik z darwin w nazwie
• Linux: plik z linux w nazwie

Wypakuj archiwum i umieść plik wykonywalny immich-go w wygodnym folderze.

Krok 4: Uruchom migrację

Otwórz terminal, przejdź do folderu z immich-go i uruchom:

macOS / Linux:

./immich-go upload from-immich \
  --from-server=https://twoj-stary-serwer.com \
  --from-api-key=TWOJ_KLUCZ_API_ZRODLA \
  --server=https://twojanazwa.pixelunion.eu \
  --api-key=TWOJ_KLUCZ_API_PIXELUNION

Windows:

.\immich-go.exe upload from-immich --from-server=https://twoj-stary-serwer.com --from-api-key=TWOJ_KLUCZ_API_ZRODLA --server=https://twojanazwa.pixelunion.eu --api-key=TWOJ_KLUCZ_API_PIXELUNION

Zastąp symbole zastępcze rzeczywistymi adresami URL serwerów i kluczami API.

Immich Go łączy się z oboma serwerami, wykrywa pliki już obecne w miejscu docelowym i przenosi wszystko pozostałe. Struktura albumów jest zachowywana automatycznie.

Wskazówki

Przyspiesz migrację uruchamiając wiele równoległych transferów:

./immich-go upload from-immich \
  --from-server=https://twoj-stary-serwer.com \
  --from-api-key=TWOJ_KLUCZ_API_ZRODLA \
  --server=https://twojanazwa.pixelunion.eu \
  --api-key=TWOJ_KLUCZ_API_PIXELUNION \
  --concurrent-tasks=4

Migruj tylko określone albumy:

./immich-go upload from-immich \
  --from-server=https://twoj-stary-serwer.com \
  --from-api-key=TWOJ_KLUCZ_API_ZRODLA \
  --server=https://twojanazwa.pixelunion.eu \
  --api-key=TWOJ_KLUCZ_API_PIXELUNION \
  --from-album="Rodzina" \
  --from-album="Wakacje"

Wznów przerwaną migrację: Jeśli proces zostanie przerwany, po prostu uruchom to samo polecenie ponownie. Immich Go śledzi, co zostało już przeniesione, i pomija te pliki.

Jak długo to potrwa?

Szybkość migracji zależy od rozmiaru biblioteki i połączenia internetowego. Jako przybliżony przewodnik:

• 10 GB: około 30-60 minut
• 100 GB: kilka godzin, najlepiej uruchomić na noc
• 500 GB lub więcej: zaplanuj cały dzień lub więcej

Rozwiązywanie problemów

Błędy połączenia: Sprawdź, czy adres URL serwera źródłowego jest prawidłowy i dostępny z Twojego komputera. Adres URL musi zawierać https:// lub http://.

Błędy uprawnień: Sprawdź, czy klucz API serwera źródłowego ma włączone uprawnienia asset.read i asset.copy.

Brakujące albumy: Albumy są tworzone podczas transferu. Jeśli album nie pojawia się po zakończeniu migracji, uruchom polecenie ponownie – Immich Go pominie już przeniesione pliki i ponowi próbę dla niekompletnych części.

Jeśli napotkasz problemy, skontaktuj się z naszym zespołem wsparcia.