Schwierigkeit: Mittel · Dauer: 45–90 Min · Ziel: Immich Storage-Tuning: Upload-Pfade, Transcoding, Datenbankpflege
Kurzproblem und Zielbild
In diesem Guide setzt du Immich Storage-Tuning: Upload-Pfade, Transcoding, Datenbankpflege mit reproduzierbaren Schritten, klaren Checks und belastbaren Recovery-Pfaden um.
Voraussetzungen
- Linux-/CLI-Grundlagen
- Admin-Zugriff auf die Zielsysteme
- Snapshot/Backup vor Änderungen
Schnellstart (funktionierende Basis)
hostnamectl
ip a
systemctl --failed
journalctl -p 3 -xb --no-pager | tail -n 30Schritt-für-Schritt Umsetzung
1) Ausgangszustand dokumentieren
date -Iseconds
uname -a
# aktuelle Versionen und relevante Konfig-Pfade notieren2) Kernkonfiguration sauber setzen
docker compose ps
docker compose logs --tail 120 microservices
df -h
docker volume ls | grep immich3) Dienst/Funktion gezielt prüfen
curl -I http://127.0.0.1:2283
docker exec -t immich_postgres psql -U postgres -d immich -c "select now();"4) Betriebsgrenzen testen
# Gezielten Failover-/Negativtest ausführen
# Reaktionszeit und Fehlerbild protokollieren
# Danach Service normalisieren und Zustand erneut verifizierenValidierung / Checks
curl -I http://127.0.0.1:2283
docker exec -t immich_postgres psql -U postgres -d immich -c "select now();"
# End-to-End Test mit klaren Sollwerten durchführen und Ergebnis dokumentierenTroubleshooting
Konfiguration wird nicht übernommen
Ursache: Syntax-/Reload-Fehler oder falscher Parameterpfad.
journalctl -n 120 --no-pager
# betroffenen Dienst gezielt reload/restarten
# Konfigurationsdatei auf Syntax prüfenDienst läuft, Funktion aber fehlerhaft
Ursache: Abhängigkeiten, Routing, Rechte oder Versionen inkonsistent.
ip a
ip route
ss -tulpn
# Berechtigungen und Abhängigkeiten gegenprüfenFazit
Mit einem klaren Ablauf, harten Checks und dokumentierten Grenzwerten bleibt das Setup wartbar statt zufällig stabil. Nächster Schritt: den Ablauf als monatliche Betriebsroutine einplanen.
