Optimieren Sie die Datenbankverbindungen von Immich, indem Sie den gesamten Sitzungsbedarf aller Immich-Prozesse und anderen PostgreSQL-Clients messen, anstatt zuerst max_connections zu erhöhen. Die Datenbank benötigt genügend Sitzungen für den tatsächlichen Workload sowie Spielraum für administrative Aufgaben. Zu viele gleichzeitige Verbindungen können jedoch den Speicherverbrauch und die Konkurrenz um Ressourcen erhöhen, ohne Abfragen zu beschleunigen.
Erfassen Sie auf einem Server mit mehreren Containern während der normalen Nutzung und bei gleichzeitigem Start aktive, inaktive und wartende Verbindungen sowie Abfragelatenz, CPU, Arbeitsspeicher und Speicherlatenz. Ein „too many clients“-Fehler kann durch die Gesamtkonfiguration, einen anderen Dienst oder eine Neustartserie verursacht werden, selbst wenn ein einzelner Immich-Container nur eine moderate Last aufweist.
Erfassen Sie alle PostgreSQL-Clients, bevor Sie Limits ändern
Listen Sie jeden Immich-Serverprozess oder jedes Replikat, jede Migrations- oder Wartungsaufgabe, jeden Backup-Auftrag, jedes Überwachungstool und jede nicht zugehörige Anwendung auf, die eine Verbindung zur selben PostgreSQL-Instanz herstellt. Verwenden Sie nach Möglichkeit separate Datenbankbenutzer, damit pg_stat_activity zeigt, wer Sitzungen belegt. Notieren Sie den aktuellen Wert von max_connections und halten Sie für die Reaktion auf Vorfälle einen administrativen Zugangsweg frei.
Eine Diskussion über „too many clients“ bei Immich enthält einen Projektkommentar, dem zufolge Immich in dieser Version standardmäßig einen Pool mit 10 Verbindungen verwendete. In einer separaten Diskussion aus dem Jahr 2026 wird darauf hingewiesen, dass mehrere Immich-Worker jeweils einen eigenen Pool unterhalten können. Betrachten Sie diese Zahlen als versionsspezifischen Implementierungskontext und nicht als Werte, die man für zukünftige Versionen blind multiplizieren sollte. Ist die Datenbank bereits nahe an ihrer Verbindungsobergrenze, während Immich inaktiv ist, ermitteln Sie vor einer Anpassung von Immich, wem diese Sitzungen gehören. Gibt es nur wenige aktive Sitzungen, aber langsame Abfragen, könnte die Verbindungszahl ein Symptom für Speicher- oder Abfragelatenz sein und nicht die eigentliche Engstelle.
Erstellen Sie anhand der gemessenen Parallelität ein Verbindungsbudget
Reservieren Sie Sitzungen für die Datenbankadministration, Backup- und Wiederherstellungstools, Migrationen und Überwachung.
Planen Sie anschließend die verbleibenden Anwendungsverbindungen auf die Anzahl der gleichzeitig laufenden Immich-Prozesse und anderer Anwendungen auf. Ziel ist ein Pool, der groß genug ist, damit normale Aufgaben nicht unnötig warten müssen, aber nicht größer, als die Datenbank effizient verarbeiten kann.
Eine Analyse zur Dimensionierung von PostgreSQL-Verbindungspools beschreibt den idealen Pool als groß genug für den normalen Bedarf und zugleich so klein wie praktikabel, da weniger Backend-Sitzungen die Konkurrenz um Ressourcen verringern. Wenden Sie dieses Prinzip auf den beobachteten Immich-Bedarf an, statt die Poolgröße eines Webservers aus einem anderen Workload zu übernehmen.
Wenn die Immich-Version keine unterstützte Einstellung für die Poolgröße bietet, ändern Sie nicht die Interna, nur um einen bestimmten Zielwert zu erreichen. Steuern Sie, was Sie beeinflussen können: die Anzahl der Anwendungsreplikate, nicht zugehörige Clients, den Zeitpunkt von Neustarts, Überschneidungen mit Backups und die Datenbankkapazität. Prüfen Sie bei Versionswechseln erneut, welche Konfiguration unterstützt wird.
Verringern Sie Verbindungswechsel und Wartezeiten in der Datenbank, bevor Sie weitere Sitzungen hinzufügen
Verteilen Sie Container-Starts zeitlich, damit Immich, Analytics, Backup-Aufgaben und andere Apps nicht alle gleichzeitig erneut Verbindungen herstellen oder Migrationen ausführen. Verwenden Sie Health- und Readiness-Checks, die warten, bis PostgreSQL einsatzbereit ist, vermeiden Sie aber enge Wiederholungsschleifen, die einen Verbindungssturm auslösen, während sich die Datenbank noch erholt.
Der ZimaSpace-Leitfaden zur Sicherheit externer Immich-Datenbanken steckt eine wichtige Grenze ab: Sobald PostgreSQL vom Standard-Stack getrennt wird, werden Verantwortlichkeiten für Versionen, Erweiterungen, Berechtigungen, Backups und Rollbacks ausdrücklich festgelegt. Ein Verbindungsproxy oder ein zusätzlicher Datenbank-Host sollte nicht allein dazu eingeführt werden, langsame Abfragen oder ausgelasteten Speicher zu kaschieren.
Wenn viele Sitzungen inaktiv sind und die Anzahl der Anwendungen tatsächlich hoch ist, kann ein Verbindungspooler in manchen PostgreSQL-Architekturen die Anzahl der Backend-Sitzungen verringern. Testen Sie jedoch zuvor die genaue Immich-Version, Migrationen, Transaktionssemantik und das Verhalten vorbereiteter Anweisungen. Pooling ersetzt weder die Behebung eines außer Kontrolle geratenen Clients noch die Entlastung einer überlasteten Datenbank.
Mit gleichzeitigen Uploads, Suchvorgängen, Aufgaben und einem Neustart validieren
Erzeugen Sie eine reproduzierbare Spitzenlast: Führen Sie repräsentative Uploads von Mobilgeräten, eine ältere Such- oder Browsing-Aktion und die übliche Mischung von Hintergrundaufgaben aus, während andere erwartete Container aktiv sind. Erfassen Sie die Verbindungsanzahl nach Benutzer und Status, Fehler beim Abrufen von Verbindungen oder bei Anfragen, die Abfragelatenz, die CPU-Auslastung der Datenbank, den Arbeitsspeicher und die Festplattenlatenz. Wiederholen Sie den Test anschließend nach einer Änderung.
Eine geeignete Konfiguration hält die Anzahl der Sitzungen unterhalb der Fehlerschwelle und lässt administrativen Spielraum, vermeidet Fehler wie „zu viele Clients“, hält die Abfragelatenz innerhalb des für den Haushalt geltenden Zielwerts und ermöglicht es, Warteschlangen nach Spitzenlasten abzuarbeiten. Mehr Verbindungen sind nur dann gerechtfertigt, wenn Anfragen tatsächlich auf eine Sitzung warten, während die Datenbank noch über CPU-, Arbeitsspeicher- und I/O-Kapazität verfügt.
Starten Sie den Anwendungsstack und anschließend den Host einmal neu, um die höchste Verbindungsspitze zu testen. Tritt der Fehler nur beim Start auf, beheben Sie die Startreihenfolge oder das Wiederholungsverhalten, statt die dauerhafte Obergrenze anzuheben. Wenn sich Sitzungen mit der Zeit ansammeln, erfassen Sie die Benutzer und Abfragen, denen sie gehören, und melden Sie dieses Leckmuster zusammen mit Versionsangaben und Belegen zum Verbindungsstatus.
Support und Tipps
Mehr zum Lesen

So halten Sie Erwachsenenvideos auf Ihrem NAS vor Familienmitgliedern verborgen
Bewahre Videos für Erwachsene auf einem Familien-NAS privat auf. Prüfe Ordnerberechtigungen, den Bibliothekszugriff in Plex und Jellyfin, Vorschaubilder, den Wiedergabeverlauf, gemeinsam genutzte TV-Logins und...

Was vor dem Laden eines Community-Modells in Transformers zu beachten ist
Nutze das Transformers-Jinja-Sandbox-Update, um die Herkunft des Modells, Chat-Vorlagen, Remote-Code, serialisierte Gewichte und isolierte erste Ausführungen zu überprüfen.

Mirage lokal ausführen: OCR und Objekterkennung aus einem einzigen Bild
Testen Sie das kleine lokale Vision-Modell von Cactus Compute, überprüfen Sie die OCR- und Objektextraktion anhand realer Eingaben und verstehen Sie die Grenzen in...



