Schwierigkeit: Mittel · Dauer: 35–65 Min · Ziel: Immich Wartung im Alltag: Updates, Datenbank-Backup, Speicherhygiene
Kurzproblem und Zielbild
In vielen Homelabs funktioniert die Erstinstallation, aber der Dauerbetrieb wird schnell unübersichtlich. Dieses Tutorial zeigt einen reproduzierbaren Ablauf für Immich Wartung im Alltag mit Fokus auf Stabilität, klare Checks und einfache Fehlerbehebung.
Ziel ist ein Setup, das nicht nur heute läuft, sondern auch nach Updates und Änderungen beherrschbar bleibt.
Voraussetzungen
- Aktuelles Debian/Ubuntu oder kompatible Appliance
- Administrative Rechte und Wartungsfenster
- Backup- oder Snapshot-Möglichkeit vor Änderungen
Schnellstart (funktionierende Basis)
# Basisprüfung
hostnamectl
ip a
# Dienste prüfen
systemctl --failed
# Logs kurz prüfen
journalctl -p 3 -xb --no-pager | tail -n 30Was macht das? Du prüfst erst den Grundzustand und vermeidest, dass Altfehler in neue Änderungen hineinwirken.
Schritt-für-Schritt Umsetzung
1) Ausgangszustand dokumentieren
date -Iseconds
uname -a
# versions/relevante configs sichernErklärung: Mit einer kurzen Bestandsaufnahme lassen sich spätere Fehler schneller eingrenzen.
2) Kernkonfiguration sauber setzen
cd /opt/immich
docker compose pull
docker compose ps
docker exec -t immich_postgres pg_dump -U postgres immich > immich-$(date +%F).sql
ls -lh immich-*.sql
docker compose up -dErklärung: Änderungen gezielt umsetzen, danach direkt den Dienst-/Funktionszustand prüfen.
3) Dienst kontrolliert neu laden
sudo systemctl daemon-reload
sudo systemctl restart
sudo systemctl status --no-pager 4) Betriebsgrenzen testen
docker compose ps
docker compose logs --tail=120 server
docker compose logs --tail=120 microservices
curl -I http://127.0.0.1:2283Validierung / Checks
docker compose ps
docker exec -t immich_postgres psql -U postgres -d immich -c "select now();"
docker volume ls | grep immich
df -hTroubleshooting
Konfiguration wird nicht übernommen
Ursache: Syntax-, Reload- oder Parameterfehler.
docker compose logs --tail=200 server
docker compose logs --tail=200 microservices
docker compose logs --tail=200 immich_postgresDienst läuft, Funktion aber fehlerhaft
Ursache: Abhängigkeiten, Routing oder Berechtigungen sind inkonsistent.
createdb -U postgres immich_restore_test
psql -U postgres immich_restore_test < immich-YYYY-MM-DD.sql
psql -U postgres -d immich_restore_test -c "\dt"Fazit
Mit einem klaren Ablauf für Immich Wartung im Alltag reduzierst du Ausfälle und erhöhst die Wartbarkeit deutlich. Der wichtigste Hebel ist die Kombination aus kleiner Änderung, sofortigem Check und dokumentiertem Ergebnis.
Nächster Schritt: den Ablauf als monatliche Betriebsroutine einplanen und regelmäßig gegen echte Störfälle testen.
