Immich ist eine Open-Source-Plattform für Fotos und Videos, die auf dem eigenen Server läuft. Diese Anleitung beschreibt die Einrichtung unter Windows 11 mit WSL2 und Docker Desktop. Sie behandelt außerdem Port 2283, Speicherorte, Docker-Volumes und Backups.

Was ist Immich?
Immich ist eine datenschutzfreundliche Alternative zu Google Fotos. Die Mediathek bleibt unter Ihrer Kontrolle und bietet automatische Uploads vom Smartphone, schnelle Suche, Gesichts- und Objekterkennung sowie Teilen.
Voraussetzungen
| Komponente | Minimum | Empfehlung |
|---|---|---|
| CPU | 2 Kerne | 4 Kerne |
| RAM | 6 GB | 8 GB |
| Betriebssystem | 64-Bit-Betriebssystem | Windows 11 mit WSL2 |
- Windows-11-PC mit Administratorrechten
- Docker Desktop für Windows
- WSL2 mit einer Ubuntu-Distribution
- Ausreichend Speicher für Mediathek und Datenbank
WSL2 aktivieren
- PowerShell als Administrator öffnen.
- Den folgenden Befehl ausführen.
- Windows neu starten, wenn Sie dazu aufgefordert werden.
- Ubuntu aus dem Startmenü öffnen und die Ersteinrichtung abschließen.
wsl --install
Docker Desktop installieren
- Docker Desktop von der offiziellen Website herunterladen.
- Bei der Installation das WSL-2-Backend aktiviert lassen.
- Unter Einstellungen → Resources → WSL Integration die Ubuntu-Distribution aktivieren.
Die aktuellen Installationsschritte finden Sie in der offiziellen Docker-Desktop-Dokumentation.
Immich-Dateien herunterladen
Öffnen Sie ein Ubuntu- oder WSL-Terminal und legen Sie ein Arbeitsverzeichnis an. Die folgenden Befehle laden die aktuelle Docker-Compose-Datei und die Beispiel-Umgebungsdatei aus dem Immich-Release.
mkdir -p ~/immich-app
cd ~/immich-app
wget -O docker-compose.yml https://github.com/immich-app/immich/releases/latest/download/docker-compose.yml
wget -O .env https://github.com/immich-app/immich/releases/latest/download/example.env
Speicherorte konfigurieren
Prüfen Sie in .env die Variablen UPLOAD_LOCATION und DB_DATA_LOCATION. UPLOAD_LOCATION enthält Fotos und Videos; DB_DATA_LOCATION enthält die PostgreSQL-Datenbank. Verwenden Sie ein Laufwerk mit genügend Platz und sichern Sie beide Speicherorte.
Docker-Volume verwenden
Alternativ können Sie in der Compose-Konfiguration benannte Volumes verwenden. Das ist portabel, ersetzt aber kein separates Backup der Volumes.
Immich starten
docker compose up -d
Prüfen Sie die laufenden Container:
docker ps
Öffnen Sie http://localhost:2283. Für Geräte im gleichen Netzwerk verwenden Sie http://Server-IP:2283 und erlauben den Port gegebenenfalls in der Windows-Firewall.
Ersteinrichtung und mobiles Backup
- Das erste Konto im Webinterface anlegen.
- Die Immich-App installieren.
- Die Server-URL eintragen und anmelden.
- Automatische Backups für die gewünschten Alben aktivieren.
Backups und Updates
Immich ersetzt kein Backup. Sichern Sie Upload-Verzeichnis und Datenbank auf ein anderes Laufwerk oder einen Speicherdienst und testen Sie die Wiederherstellung regelmäßig. Lesen Sie vor einem Update die Release-Hinweise und sichern Sie die .env-Datei.
Fehlerbehebung
- Wenn die Seite nicht erreichbar ist, prüfen Sie Docker Desktop und Port 2283.
- Mit docker ps und den Container-Logs finden Sie wiederholt gestartete Dienste.
- Bei vollem Speicher den Stack stoppen, Daten vorsichtig verschieben und alle Pfade konsistent ändern.
Zusammenfassung
Mit WSL2, Docker Desktop und den aktuellen Immich-Compose-Dateien lässt sich eine private Fotomediathek unter Windows 11 betreiben. Dokumentieren Sie Speicherpfade, Port 2283 und einen getesteten Backup-Plan.
Haftungsausschluss: Dieser Artikel dient nur zu Informationszwecken. Immich, Docker Desktop, Windows und ihre Einstellungen können sich ändern. Sichern Sie Ihre Daten vor Änderungen und prüfen Sie die Befehle in der offiziellen Dokumentation Ihrer Version.

コメント