Zum Hauptinhalt springen

FAQ

Benutzer​

Wie kann ich das Admin-Passwort zurücksetzen?​

Das Admin-Passwort kann durch Ausführen des reset-admin-password-Befehls auf dem Immich-Server zurückgesetzt werden.

Wie kann ich eine Liste aller Benutzer in Immich anzeigen?​

Sie können die Liste aller Benutzer anzeigen, indem Sie den list-users-Befehl auf dem Immich-Server ausführen.

Mobile App​

Was bedeuten die Wolkensymbole in der mobilen App?​

SymbolBeschreibung
cloudDatei ist nur auf dem Server verfügbar und wurde von einem anderen Gerät hochgeladen (wie dem Webclient) oder nach dem Hochladen von diesem Gerät gelöscht
cloud-crossDatei ist nur lokal verfügbar und wurde noch nicht gesichert
cloud-doneDatei wurde von diesem Gerät hochgeladen und ist jetzt auf dem Server gesichert; die Originaldatei befindet sich noch auf dem Gerät

Ich kann mich nach einem Update nicht in die Anwendung einloggen. Was kann ich tun?​

Stellen Sie sicher, dass die mobile App und der Server die gleiche Version (Major und Minor) verwenden.

Notiz

App-Store-Updates dauern manchmal länger, da die Stores (Google Play Store und Apple App Store) das Update zuerst genehmigen müssen, was Zeit in Anspruch nehmen kann.

Wenn Sie sich weiterhin nicht in die App einloggen können, versuchen Sie Folgendes:

  • Überprüfen Sie die mobilen Protokolle
  • Vergewissern Sie sich, dass die Anmeldeinformationen korrekt sind, indem Sie sich in der Webanwendung einloggen

Warum stoppt die Sicherung im Vordergrund, wenn ich die App verlasse? Sollte der Vorgang nicht auf die Hintergrundsicherung übertragen werden?​

Vordergrundsicherung und Hintergrundsicherung sind zwei getrennte Mechanismen. Sie kommunizieren oder interagieren nicht miteinander.

Die Vordergrundsicherung wird durch die Aktionen des Benutzers gesteuert, während die Hintergrundsicherung vom Betriebssystem des Geräts kontrolliert wird. Wenn die App in den Hintergrund verschoben wird, wird die Ausführung von Hintergrundaufgaben dem Scheduling des Betriebssystems des Geräts überlassen. Es entscheidet, wann die Hintergrundaufgabe ausgeführt werden kann und wie lange sie laufen darf.

Das Verhalten unterscheidet sich je nach Gerätehersteller und Betriebssystem, die meisten hängen jedoch mit Energiesparrichtlinien zusammen.

Warum funktioniert die Hintergrundsicherung auf iOS nicht?​

Auf iOS (iPhone und iPad) entscheidet das Betriebssystem basierend auf mehreren Faktoren, ob eine bestimmte App Hintergrundaufgaben ausführen kann, von denen die Immich-App keine Kontrolle hat. Um die Wahrscheinlichkeit zu erhöhen, dass die Hintergrundsicherungsaufgabe ausgeführt wird, befolgen Sie die unten stehenden Schritte:

  • Aktivieren Sie die Hintergrundaktualisierung für Immich in den iOS-Einstellungen unter Einstellungen > Allgemein > Hintergrundaktualisierung.
  • Deaktivieren Sie Niedriger Energieverbrauch, wenn er nicht benötigt wird, da dies verhindern kann, dass Apps im Hintergrund ausgeführt werden.
  • Deaktivieren Sie die Hintergrundaktualisierung für Apps, die keine Hintergrundaufgaben benötigen. Dadurch wird der Wettbewerb um die Ausführung von Hintergrundaufgaben für Immich reduziert.
  • Verwenden Sie die Immich-App häufiger.

Warum funktionieren Funktionen in der mobilen App nicht mit einem selbstsignierten Zertifikat, Basic Auth, benutzerdefinierten Headern oder mutual TLS?​

Diese Netzwerktechnologien sind experimentell. Sie funktionieren oft nicht bei Videowiedergabe, Datei-Uploads oder -Downloads und anderen Funktionen. Viele dieser Einschränkungen werden in #15230 behandelt. Anstelle dieser experimentellen Funktionen empfehlen wir die Verwendung der URL-Umschaltungsfunktion, eines VPNs oder eines kostenlosen vertrauenswürdigen SSL-Zertifikats für Ihre Domain.

Wir entwickeln diese Funktionen nicht aktiv weiter und können keinen Support bieten, begrüßen jedoch Beiträge zur Verbesserung. Bitte besprechen Sie größere PRs mit unserem Entwicklungsteam, um sicherzustellen, dass Ihre Zeit nicht verschwendet wird.

Warum wird die mobile App noch nicht aktualisiert?​

Die App-Stores können einige Tage benötigen, um neue Builds der App zu genehmigen. Wenn Sie ungeduldig sind, können Android-APKs von den GitHub-Releases heruntergeladen werden.

Dateien​

Ändert Immich die Datei?​

Nein, Immich verändert die Originaldateien nicht. Alle bearbeiteten Metadaten werden in begleitenden .xmp-Sidecar-Dateien und in der Datenbank gespeichert. Immich löscht jedoch Originaldateien, die in den Papierkorb verschoben wurden, sobald dieser in der Immich-Benutzeroberfläche geleert wird.

Warum erscheinen meine Dateinamen als zufällige Zeichenfolgen im Dateimanager?​

Wenn die Speicher-Vorlage deaktiviert ist (standardmäßig), speichert Immich die Dateinamen als zufällige Zeichenfolgen (auch bekannt als Zufalls-UUIDs), um doppelte Dateinamen zu verhindern. Um die ursprünglichen Dateinamen wiederherzustellen, müssen Sie die Speicher-Vorlage aktivieren und anschließend den STORAGE TEMPLATE MIGRATION-Job ausführen. Es wird empfohlen, vor der Aktivierung der Speicher-Vorlage zu lesen.

Kann ich meine vorhandene Fotobibliothek hinzufügen?​

Ja, mit einer externen Bibliothek.

Was passiert mit vorhandenen Dateien, nachdem ich eine neue Speicher-Vorlage gewählt habe?​

Vorlagenänderungen gelten nur für neue Dateien. Um die Vorlage nachträglich auf zuvor hochgeladene Dateien anzuwenden, führen Sie den Speicher-Migrationsjob aus, der auf der Jobs-Seite verfügbar ist.

Warum werden nur Fotos und keine Videos auf Immich hochgeladen?​

Dies passiert häufig, wenn ein Reverse-Proxy vor Immich verwendet wird. Stellen Sie sicher, dass Sie Ihren Reverse-Proxy richtig eingestellt haben, um große Anfragen zu ermöglichen. Prüfen Sie auch den Speicherplatz Ihres Reverse-Proxy, da einige Proxies Anfragen zwischenspeichern, bevor sie weitergeleitet werden. Wenn der Speicherplatz ausgeht, schlägt die Anfrage fehl.

Wenn Sie Cloudflare Tunnel verwenden, beachten Sie, dass sie eine maximale Dateigröße von 100 MB festlegen, die nicht geändert werden kann. In einigen Fällen können Dateien größer als diese Grenze funktionieren, möglicherweise bis zu 1 GB. Die offizielle Grenze liegt jedoch bei 100 MB. Wenn Sie Probleme haben, empfehlen wir, zu einer anderen Netzwerkbereitstellung zu wechseln.

Warum werden einige Fotos im Dateisystem mit dem falschen Datum gespeichert?​

Es gibt einige Szenarien, die zu dieser Situation führen können. Die Lösung besteht darin, den Speicher-Migrationsjob erneut auszuführen. Der Job wird nur einmal pro Datei nach dem Hochladen automatisch ausgeführt. Wenn die Metadatenextraktion ursprünglich fehlgeschlagen ist, die Jobs gelöscht/abgebrochen wurden usw., könnte der Job beim ersten Mal nicht automatisch ausgeführt worden sein.

Wie kann ich Fotos aus der Timeline ausblenden?​

Sie können sie archivieren.

Wie kann ich Daten von Immich sichern?​

Siehe Backup und Wiederherstellung.

Unterstützt Immich das Lesen vorhandener Gesichtstags-Metadaten?​

Ja, es erstellt neue Gesichter und Personen aus den importierten Datei-Metadaten. Weitere Details finden Sie im Feature Request #4348 und PR #6455.

Unterstützt Immich das Filtern von NSFW-Bildern?​

Nein, derzeit nicht. Es gibt eine offene Feature-Anfrage auf Github.

Warum gibt es so viele Jobs zur Thumbnail-Erstellung?​

Es gibt drei Thumbnail-Jobs für jedes Asset:

  • Verschwommen (thumbhash)
  • Vorschau (Webp)
  • Miniaturansicht (Jpeg)

Zusätzlich gibt es weitere Jobs für Personen-Thumbnails (Gesichter).

Warum erscheinen Dateien von WhatsApp nicht mit dem richtigen Datum?​

Dateien, die über WhatsApp gesendet werden, werden ohne Metadaten gespeichert. Daher hat Immich keine Möglichkeit, das ursprüngliche Datum der Datei zu erfahren, wenn Dateien von WhatsApp hochgeladen werden, und nicht die Reihenfolge des Ankommens auf dem Gerät. Siehe #9116.

Was passiert, wenn eine Datei in mehr als einem Konto existiert?​

Es gibt keine Anforderungen, dass Dateien zwischen Benutzern eindeutig sein müssen. Wenn mehrere Benutzer das gleiche Bild hochladen, wird es als eigenständige Datei behandelt, und die Jobs werden entsprechend ausgeführt und Thumbnails generiert.

Warum erscheinen HDR-Videos blass im Immich-Player, sehen aber nach dem Download normal aus?​

Immich verwendet einen Player mit bekannten Farbdarstellungsproblemen bei HDR-Inhalten. Wir experimentieren mit einem anderen Player, der bessere Farbprofile für HDR-Inhalte bietet, um zukünftige Verbesserungen zu ermöglichen.

Warum transkodiert Immich meine Videos in niedrigere Qualität?​

Immich behält immer Ihre Originaldateien. Zusätzlich wird eine transkodierte Version aus Kompatibilitäts- und Leistungsgründen erstellt.

Wie kann ich transkodierte Videos löschen, ohne das Original zu löschen?​

Die transkodierte Version einer Datei kann gelöscht werden, indem Sie eine Transkodierungsrichtlinie festlegen, die sie unnötig macht, und anschließend einen Transkodierungsjob für diese Datei ausführen. Dies kann anhand einzelner Dateien durchgeführt werden, indem ein Transkodierungsjob für eine einzelne Datei gestartet wird, indem Sie die Option "Videos neu kodieren" im Dateibetrachter auswählen, oder für alle Dateien, indem Sie Transkodierungsjobs für alle Dateien von der Administrationsseite aus ausführen.

Um die Transkodierungsrichtlinie zu aktualisieren, navigieren Sie zu Verwaltung > Video-Transkodierungs-Einstellungen > Transkodierungsrichtlinien und wählen Sie eine Richtlinie aus dem Dropdown-Menü. Diese Richtlinie bestimmt, ob eine bestehende Transkodierung gelöscht oder im Transkodierungsjob überschrieben wird. Wenn ein Video gemäß dieser Richtlinie transkodiert werden soll, wird eine bestehende Transkodierung überschrieben. Wenn nicht, wird sie gelöscht.

Notiz

Zum Beispiel: Angenommen, Sie haben bestehende Transkodierungen mit der Richtlinie "Videos mit höherer als normaler Auflösung oder nicht im gewünschten Format" und wechseln zu einer engeren Richtlinie: "Videos nicht im gewünschten Format." Wenn eine Datei nur aufgrund ihrer Auflösung transkodiert wurde, wird die bestehende Transkodierung durch Ausführen eines Transkodierungsjobs für diese Datei gelöscht. Dies liegt daran, dass die Auflösung nicht mehr Teil der Transkodierungsrichtlinie ist und die Transkodierung unnötig ist. Ebenso, wenn Sie die Richtlinie auf "Keine Videos transkodieren" setzen und Transkodierungsjobs für alle Dateien ausführen, werden alle bestehenden Transkodierungen gelöscht, da sie unnötig sind.

Ist es möglich, Bilder während des Backups zu komprimieren?​

Nein. Unser Designprinzip ist, dass die ursprünglichen Dateien immer unberührt bleiben.

Wie kann ich ein CIFS/Samba-Volume innerhalb von Docker einbinden?​

Wenn Sie Samba nicht auf dem Host mounten können oder dies vermeiden möchten (z. B. in einer Windows-Umgebung), können Sie das Volume innerhalb von Docker einbinden. Unten finden Sie ein Beispiel in der Datei docker-compose.yml.

Ändern Sie Ihren Benutzernamen, Ihr Passwort, Ihre lokale IP-Adresse und den Freigabenamen. Beachten Sie die folgende Zeile - originals:/usr/src/app/originals, die sich auf den Abschnitt bezieht, in dem das Volume originals erstellt wurde. Sie können diesen Namen beliebig ändern und ihn nach Belieben auf den Docker-Container abbilden. Beispielsweise können Sie originals: in Photos: ändern und - originals:/usr/src/app/originals in Photos:/usr/src/app/photos ändern.

...
services:
  immich-server:
...
    volumes:
      # Bearbeiten Sie die nächste Zeile nicht. Wenn Sie den Speicherort für Mediendateien auf Ihrem System ändern möchten, bearbeiten Sie den Wert von UPLOAD_LOCATION in der .env-Datei
      - ${UPLOAD_LOCATION}:/usr/src/app/upload
      - /etc/localtime:/etc/localtime:ro
+     - originals:/usr/src/app/originals
...
volumes:
  model-cache:
+ originals:
+   driver_opts:
+     type: cifs
+     o: 'iocharset=utf8,username=USERNAMEHERE,password=PASSWORDHERE,rw' # ändern Sie dies in `ro`, wenn nur Lesezugriff gewünscht ist
+     device: '//localipaddress/sharename'

Alben​

Kann ich meine bestehende Albumstruktur beibehalten, während ich Assets in Immich importiere?​

Ja, indem Sie die Immich CLI zusammen mit der --album-Option verwenden.

Gibt es eine Möglichkeit, Fotos innerhalb eines Albums neu anzuordnen?​

Nein, noch nicht. Für Updates zu dieser geplanten Funktion folgen Sie der GitHub-Diskussion.

Externe Bibliothek​

Kann ich eine externe Bibliothek hinzufügen und dabei die bestehende Albumstruktur beibehalten?​

Wir haben noch keinen offiziellen Mechanismus zur Erstellung von Alben aus externen Bibliotheken implementiert, aber es gibt einige Workarounds aus der Community, die Ihnen dabei helfen können.

Was passiert mit Duplikaten in externen Bibliotheken?​

Die Duplikatprüfung existiert nur für Upload-Bibliotheken und basiert auf dem Datei-Hash. Außerdem ist die Duplikatprüfung nicht global, sondern pro Bibliothek. Daher ist es möglich, dass dieselbe Datei zweimal in der Timeline erscheint, insbesondere bei externen Bibliotheken.

Warum werden meine Änderungen an Dateien in schreibgeschützten externen Bibliotheken nicht gespeichert?​

Bilder in beschreibbaren externen Bibliotheken (Standard) können normal bearbeitet werden. In schreibgeschützten Bibliotheken (:ro in der docker-compose.yml) kann Immich die .xmp-Sidecar-Dateien zum Speichern bearbeiteter Dateimetadaten nicht erstellen. Aus diesem Grund können die Metadaten (Zeitstempel, Standort, Beschreibung, Sternbewertung usw.) für Dateien in schreibgeschützten externen Bibliotheken nicht bearbeitet werden.

Wie werden Löschungen von Dateien in externen Bibliotheken gehandhabt?​

Immich wird versuchen, originale Dateien, die im Papierkorb gelandet sind, zu löschen, wenn der Papierkorb geleert wird. In beschreibbaren externen Bibliotheken (Standard) wird Immich die originale Datei löschen. In schreibgeschützten Bibliotheken (:ro in der docker-compose.yml) können Dateien noch immer in der Benutzeroberfläche in den Papierkorb gelegt werden. Wenn jedoch der Papierkorb geleert wird, erscheinen die Dateien wieder in der Haupt-Timeline, da Immich die originale Datei nicht löschen kann.

Maschinelles Lernen​

Wie funktioniert die intelligente Suche?​

Immich verwendet CLIP-Modelle. Ein ML-Modell konvertiert jedes Bild in eine "Einbettung", die im Wesentlichen eine Zahlenfolge ist, die semantisch codiert, was auf dem Bild zu sehen ist. Dasselbe passiert mit dem Text, den Sie bei einer Suche eingeben, und diese Texteinbettung wird dann mit denen der Bilder verglichen, um ähnliche zu finden. Daher werden keine "Tags", "Labels" oder "Beschreibungen" generiert, die Sie ansehen können. Weitere Informationen über CLIP und seine Fähigkeiten finden Sie hier.

Wie funktioniert die Gesichtserkennung?​

Details finden Sie unter Wie Gesichtserkennung funktioniert.

Wie kann ich maschinelles Lernen deaktivieren?​

Info

Das Deaktivieren von maschinellem Lernen führt zu einer schlechteren Benutzererfahrung beim Suchen und auf der Seite 'Erkunden', da diese auf maschinelles Lernen angewiesen sind, um wie vorgesehen zu funktionieren.

Maschinelles Lernen kann unter Verwaltung > Einstellungen > Einstellungen für maschinelles Lernen entweder vollständig oder nach Modellart deaktiviert werden. Beispielsweise können Sie die intelligente Suche mit CLIP deaktivieren, aber die Gesichtserkennung aktiviert lassen. Dies bedeutet, dass der Dienst für maschinelles Lernen nur die aktivierten Jobs verarbeitet.

Das Deaktivieren aller Jobs deaktiviert den Dienst für maschinelles Lernen selbst jedoch nicht. Um zu verhindern, dass dieser überhaupt startet, können Sie den Abschnitt immich-machine-learning in der docker-compose.yml-Datei auskommentieren.

Ich erhalte Fehlermeldungen über beschädigte Modelle oder fehlgeschlagene Downloads. Was kann ich tun?​

Sie können das Model-Cache-Volume löschen, in dem die Modelle heruntergeladen werden. Dadurch erhält der Dienst eine saubere Umgebung, um das Modell erneut herunterzuladen. Wenn Modelle vollständig fehlschlagen heruntergeladen zu werden, können Sie diese manuell von Hugging Face herunterladen und in den Cache-Ordner verschieben.

Kann ich ein benutzerdefiniertes CLIP-Modell verwenden?​

Nein, das wird nicht unterstützt. Nur auf der Hugging Face-Seite gelistete Modelle sind kompatibel. Machen Sie gerne einen Feature-Request, wenn es ein nicht gelistetes Modell gibt, das Ihrer Meinung nach hinzugefügt werden sollte.

Ich möchte in anderen Sprachen als Englisch suchen können. Wie kann ich das tun?​

Sie können auf ein mehrsprachiges CLIP-Modell umschalten. Anweisungen dazu finden Sie hier.

Unterstützt Immich Gesichtserkennung für Videos?​

Die maschinelle Lernfunktion von Immich arbeitet auf Basis des generierten Thumbnails. Wenn auf dem Thumbnail eines Videos ein Gesicht sichtbar ist, wird dies von der Gesichtserkennung erkannt. Das Durchsuchen des gesamten Videos nach Gesichtern könnte in der Zukunft implementiert werden.

Hat Immich eine Tiererkennung?​

Nein.

Tipp

Sie können Intelligente Suche hierfür bis zu einem gewissen Grad verwenden. Wenn Sie beispielsweise einen Golden Retriever und einen Chihuahua haben, geben Sie diese Wörter in der intelligenten Suche ein und sehen Sie sich die Ergebnisse an.

Ich bekomme viele "Gesichter", die keine Gesichter sind. Was kann ich tun?​

Sie können die Mindest-Erkennungswert zu 0.8 erhöhen, um schlechte Thumbnails zu vermeiden. Wenn der Wert zu hoch gesetzt wird (über 0.9), könnten möglicherweise zu viele echte Gesichter abhängig von der verwendeten Bibliothek herausgefiltert werden. Wenn Sie lediglich spezifische Gesichter ausblenden möchten, können Sie die Einstellung 'MIN FACES DETECTED' im Administrations-Panel anpassen, um die Anforderungen für das, was der Algorithmus als "Kern-Gesicht" einer Person betrachtet, zu erhöhen und somit die Wahrscheinlichkeit zu reduzieren, dass schlechte Thumbnails ausgewählt werden.

Das immich_model-cache-Volume nimmt viel Speicherplatz ein. Woran könnte das liegen?​

Wenn Sie mehrere Modelle installiert haben und beschlossen haben, einige davon nicht zu verwenden, lohnt es sich möglicherweise, die alten Modelle zu löschen, die sich im immich_model-cache befinden. Dazu können Sie den Model-Cache mounten und die nicht benötigten Modelle entfernen.

Schritte
docker run -it --rm -v immich_model-cache:/mnt-models alpine sh
cd /mnt-models
ls clip/ facial-recognition/
# rm -r clip/ABC facial-recognition/DEF # Entfernen Sie unbenutzte Modelle

Leistung​

Warum ist Immich langsam auf Systemen mit wenig Speicher wie dem Raspberry Pi?​

Immich verwendet optionales Transcoding und maschinelles Lernen für mehrere Funktionen. Dies kann jedoch zu ressourcenintensiv sein, um auf einem Raspberry Pi ausgeführt zu werden. Sie können dies mildern, Immichs Container für maschinelles Lernen auf einem leistungsstärkeren System hosten, oder maschinelles Lernen vollständig deaktivieren.

Kann ich CPU- und RAM-Nutzung reduzieren?​

Das anfängliche Backup ist aufgrund der Anzahl der laufenden Jobs am intensivsten. Die ressourcenintensivsten Prozesse sind Transcoding und Aufgaben für maschinelles Lernen (Intelligente Suche, Gesichtserkennung) und in geringerem Maße die Thumbnail-Erstellung. Hier sind einige Möglichkeiten, deren CPU-Nutzung zu senken:

  • Verringern Sie die Job-Konkurrenz für diese Jobs auf 1.
  • Unter Einstellungen > Transcoding-Einstellungen > Threads, setzen Sie die Anzahl der Threads auf einen niedrigen Wert wie 1 oder 2.
  • Unter Einstellungen > Maschinelles Lernen-Einstellungen > Gesichtserkennung > Modellname können Sie das Gesichtserkennungs-Modell zu buffalo_s anstelle von buffalo_l ändern. Ersteres ist ein kleineres und schnelleres Modell, wenn auch nicht so genau.
    • Damit die Gesichtserkennung bei neuen Bildern ordnungsgemäß funktioniert, müssen Sie den Gesichtserkennungs-Job für alle Bilder erneut ausführen.
  • Auf Container-Ebene können Sie Ressourcenbeschränkungen einstellen, um die Nutzung weiter zu senken.
    • Es wird empfohlen, diese Beschränkungen erst nach einigen der hier genannten Maßnahmen anzuwenden, um die beste Leistung zu erzielen.
  • Wenn diese Änderungen nicht ausreichen, finden Sie oben Anweisungen zur Deaktivierung des maschinellen Lernens.

Kann ich CPU- und RAM-Nutzung begrenzen?​

Standardmäßig hat ein Container keine Ressourcenbeschränkungen und kann so viel einer Ressource nutzen, wie es der Kernel-Scheduler des Hosts erlaubt. Um dies zu begrenzen, können Sie Folgendes in dem docker-compose.yml-Block eines beliebigen Containers hinzufügen, für den Sie Ressourcen begrenzen möchten.

docker-compose.yml
deploy:
  resources:
    limits:
      # Anzahl der CPU-Threads
      cpus: '1.00'
      # Gigabyte Speicher
      memory: '1G'

Für weitere Details können Sie sich die originalen Docker-Dokumente ansehen oder diesen Leitfaden verwenden.

Beachten Sie, dass Speicherbeschränkungen durch das Beenden des Containers arbeiten, was bei zu niedrigen Einstellungen zu Instabilität führen kann.

Wie kann ich die Geschwindigkeit des maschinellen Lernens steigern?​

Notiz

Dieser Ratschlag verbessert den Durchsatz, nicht die Latenzzeit. Das bedeutet, dass die Jobs der Intelligenten Suche schneller verarbeitet werden, aber die Suchgeschwindigkeit nicht verbessert wird.

Sie können den Durchsatz erhöhen, indem Sie die Job-Konkurrenz für maschinelle Lernjobs (Intelligente Suche, Gesichtserkennung) erhöhen. Mit höherer Konkurrenz arbeitet der Host parallel an mehr Assets. Sie können dies tun, indem Sie zu Verwaltung > Einstellungen > Job-Einstellungen gehen und die Konkurrenz nach Bedarf erhöhen.

Gefahr

Auf einer normalen Maschine können 2 oder 3 gleichzeitige Jobs wahrscheinlich die CPU auslasten. Speicherengeschwindigkeit und Latenz werden schnell zum begrenzenden Faktor, insbesondere bei der Verwendung von HDDs.

Mit einer GPU kann die Parallelität komfortabler erhöht werden, jedoch sollte sie in den meisten Fällen nicht über 16 liegen.

Übertreiben Sie es nicht mit der Job-Parallelität, da Sie den Server wahrscheinlich stark überlasten.

Mein Server zeigt Serverstatus Offline | Version unbekannt. Was kann ich tun?​

Sie müssen WebSockets aktivieren in Ihrem Reverse Proxy.

Docker​

Wie kann ich Immich-Protokolle anzeigen?​

Immich-Komponenten werden typischerweise mit Docker bereitgestellt. Um Protokolle für bereitgestellte Docker-Container anzuzeigen, können Sie das Docker CLI verwenden, insbesondere den docker logs Befehl. Beispiele finden Sie unter Docker-Hilfe.

Wie kann ich die Protokollintensität von Redis reduzieren?​

Um Redis-Protokolle zu reduzieren, können Sie die folgende Zeile zum redis: Abschnitt der docker-compose.yml hinzufügen:

command: redis-server --loglevel warning

Wie kann ich Immich als Nicht-Root-Benutzer ausführen?​

Sie können den Benutzer im Container ändern, indem Sie das user Argument in docker-compose.yml für jeden Dienst festlegen. Möglicherweise müssen Sie Mount-Punkte oder Docker-Volumes für die folgenden internen Containerpfade hinzufügen:

  • immich-machine-learning:/.config
  • immich-machine-learning:/.cache
  • redis:/data

Der Nicht-Root-Benutzer/-Gruppe benötigt Lese- und Schreibzugriff auf die Volume-Mounts, einschließlich UPLOAD_LOCATION und /cache für maschinelles Lernen.

Docker Compose Volumes

Das oberste Docker-Compose-Volume-Element unterstützt keinen Nicht-Root-Zugriff, alle oben genannten Volumes müssen lokale Volume-Mounts sein.

Für ein weiter gehärtetes System können Sie den folgenden Block zu jedem Container hinzufügen.

docker-compose.yml
security_opt:
  # Verhindert Eskalation von Berechtigungen nach dem Start des Containers
  - no-new-privileges:true
cap_drop:
  # Verhindert Zugriff auf Rohnetzwerkverkehr
  - NET_RAW

Wie kann ich Daten aus Immich löschen?​

Daten für Immich gibt es in zwei Arten:

  1. Metadaten, die in einer Postgres-Datenbank gespeichert sind, gespeichert im DB_DATA_LOCATION Ordner (früher pg_data Docker-Volume).
  2. Dateien (Originale, Thumbnails, Profile usw.), gespeichert im UPLOAD_LOCATION Ordner, mehr Infos.
Warnung

Dies zerstört Ihre Datenbank und setzt Ihre Instanz zurück, sodass Sie von vorne beginnen.

Immich (Container und Volumes) entfernen
docker compose down -v

Nach dem Entfernen der Container und Volumes gibt es einige Verzeichnisse, die gelöscht werden müssen, um Immich auf eine neue Installation zurückzusetzen. Sobald diese gelöscht sind, kann Immich wieder gestartet werden und wird eine frische Installation sein.

  • DB_DATA_LOCATION enthält die Datenbank, Medieninformationen und Einstellungen.
  • UPLOAD_LOCATION enthält alle in Immich hochgeladenen Medien.
Portainer

Wenn Sie Portainer verwenden, bringen Sie den Stack in Portainer runter. Gehen Sie in den Volumes-Bereich,
und entfernen Sie alle Volumes, die mit immich verbunden sind, und starten Sie den Stack neu.

Warum meldet der Dienst für maschinelles Lernen abstürzende Arbeiter?​

Notiz

Wenn der Fehler angibt, dass der Arbeiter beendet wird, ist dies normal. Dies ist ein Feature, um den RAM-Verbrauch zu reduzieren, wenn der Dienst nicht genutzt wird.

Es gibt einige Gründe, warum dies passieren kann.

Wenn der Fehler SIGKILL oder Fehlercode 137 erwähnt, bedeutet dies höchstwahrscheinlich, dass dem Dienst der Speicher ausgeht. Überlegen Sie, den RAM des Servers zu erhöhen oder den Dienst auf einen Server mit mehr RAM zu verlegen.

Wenn SIGILL (beachten Sie das Fehlen eines K) oder Fehlercode 132 erwähnt wird, bedeutet dies höchstwahrscheinlich, dass die CPU Ihres Servers mit Immich nicht kompatibel ist.

Datenbank​

Warum erhalte ich Fehler bei der Datenbankbesitzereigenschaft?​

Wenn Sie Datenbankfehler wie FATAL: Datenverzeichnis "/var/lib/postgresql/data" hat falschen Besitz beim Starten der Datenbank erhalten, liegt dies wahrscheinlich an einem Problem mit Ihrem Dateisystem. NTFS und ex/FAT/32-Dateisysteme werden nicht unterstützt. Weitere Details finden Sie hier.

Wie kann ich die Integrität meiner Datenbank überprüfen?​

Datenbankprüfsummen sind standardmäßig für neue Installationen seit v1.104.0 aktiviert. Sie können überprüfen, ob sie aktiviert sind, indem Sie den folgenden Befehl ausführen. Ein Ergebnis von on bedeutet, dass Prüfsummen aktiviert sind.

Prüfen, ob Prüfsummen aktiviert sind
docker exec -it immich_postgres psql --dbname=postgres --username=<DB_USERNAME> --command="show data_checksums"
 data_checksums
----------------
 on
(1 row)

Wenn Prüfsummen aktiviert sind, können Sie den Status der Datenbank mit dem folgenden Befehl überprüfen. Ein normales Ergebnis enthält nur 0s.

Prüfen auf Datenbankbeschädigungen
docker exec -it immich_postgres psql --dbname=postgres --username=<DB_USERNAME> --command="SELECT datname, checksum_failures, checksum_last_failure FROM pg_stat_database WHERE datname IS NOT NULL"
  datname  | checksum_failures | checksum_last_failure
-----------+-------------------+-----------------------
 postgres  |                 0 |
 immich    |                 0 |
 template1 |                 0 |
 template0 |                 0 |
(4 rows)

Sie können auch die Datei-Struktur der Postgres-Datenbank auf Fehler scannen:

Dateistruktur auf Fehler scannen
docker exec -it immich_postgres pg_amcheck --username=<DB_USERNAME> --heapallindexed --parent-check --rootdescend --progress --all --install-missing

Ein normales Ergebnis endet ungefähr so und gibt einen Exit-Code von 0 zurück:

7470/8832 Relations (84%), 730829/734735 Seiten (99%)
8425/8832 Relations (95%), 734367/734735 Seiten (99%)
8832/8832 Relations (100%), 734735/734735 Seiten (100%)

Wenn eine Beschädigung festgestellt wird, sollten Sie sofort ein Backup erstellen, bevor Sie weitere Arbeiten in der Datenbank vornehmen. Dazu müssen Sie möglicherweise das Flag zero_damaged_pages=on für den Datenbankserver setzen, um pg_dumpall zum Abschließen zu bringen. Nach der Erstellung eines Backups wird empfohlen, die Datenbank aus einem intakten Backup wiederherzustellen, bevor die Beschädigung festgestellt wurde. Das beschädigte Datenbankdump kann verwendet werden, um alle seit dem letzten Backup vorgenommenen Änderungen manuell wiederherzustellen, falls erforderlich.

Die Ursachen möglicher Beschädigungen sind vielfältig, können jedoch unerwartete Abschaltungen oder Unmounts, die Nutzung eines Netzlaufwerks für Postgres-Daten oder ein schlechtes Speichermedium wie eine SD-Karte oder ein defektes HDD/SSD umfassen.