Technical Anshu
Tutorials Blog
📸 Immich Docker Install

Installieren Sie Immich mit Docker für Ihre eigene private Foto-Cloud

Der Speicherplatz von Google Fotos wird voll, die Preise steigen und die Erinnerungen Ihrer Familie bleiben auf dem Computer einer anderen Person. Immich stellt eine vollständige Foto-Cloud – Zeitleiste, Alben, Gesichtssuche, automatische Telefonsicherung – auf einem Computer bei Ihnen zu Hause bereit. Hier ist die vollständige ehrliche Installation in der Reihenfolge, in der sie funktioniert.

✍️ Technical Anshu🐳 Docker / Linux Server⏱️ 15 minute install
🎥 Sehen Sie sich die schnellste Methode im Video an – vollständige Immich Docker-Installation, Schritt für Schritt

Immich kommt Google Fotos auf Ihrer eigenen Hardware am nächsten: Ihr Telefon wird automatisch gesichert, Fotos werden in einer übersichtlichen Zeitleiste angezeigt und Sie können nach Gesicht, Ort oder Objekt suchen. Die Installation ist bekanntermaßen kurz – zwei Dateien zum Herunterladen, eine Datei zum Bearbeiten, ein Befehl zum Ausführen – aber die wenigen Auswahlmöglichkeiten in dieser einen Datei entscheiden darüber, ob Ihre Bibliothek jahrelang sicher oder vom ersten Tag an anfällig ist. Dieser Leitfaden trifft diese Entscheidungen sorgfältig.

Terminal — the whole install is four commands
$ mkdir ./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 $ docker compose up -d

👆 Die offizielle Installationsroute aus der Immich-Dokumentation – zwei heruntergeladene Dateien, ein Befehl und der Server ist live.

1

Was Sie vor dem Start benötigen

Immich ist eine selbstgehostete Foto- und Video-Backup-Plattform – denken Sie an Google Fotos, aber der Server ist eine Maschine bei Ihnen zu Hause und niemand sonst speichert Ihre Bilder. Es ist kostenlos und Open Source und die offizielle Möglichkeit, es auszuführen, ist Docker Compose auf einem Linux-Server, einem alten PC, einem Mini-PC oder einem NAS, das Docker unterstützt.

  1. Eine Maschine, die eingeschaltet bleibt: ein Mini-PC, ein alter Desktop, ein Heimserver oder ein NAS. Ein Laptop, der jeden Abend schläft, ist ein schlechter Fotoserver
  2. Docker und Docker Compose installiert und funktionieren – testen Sie mit docker compose version
  3. RAM: Etwa 4 GB sind die praktische Grundausstattung; Der Container für maschinelles Lernen ist der hungrige Teil, daher sind 6–8 GB deutlich zufriedener
  4. Speicherplatz: Ihre vollständige Fotobibliothek plus etwa 10–20 Prozent zusätzlich für Miniaturansichten und transkodierte Videos. Der Speicher – nicht die CPU – ist das, was Ihnen zuerst ausgehen wird
  5. Ehrliche Erwartung: Immich ist ein junges Projekt in aktiver Entwicklung. Es ist ausgezeichnet, aber die Entwickler selbst haben immer dazu geraten, ein weiteres Backup der unersetzlichen Fotos aufzubewahren. Dieser Leitfaden folgt diesem Rat überall
2

Laden Sie die beiden offiziellen Dateien herunter

Kopieren Sie niemals eine zufällige Docker-Compose-Datei aus einem Blog oder einem Forumsbeitrag – Versionen driften ab und die Datei eines Fremden kann Sie an einen alten Build binden. Die offiziellen Dateien sind immer live auf der GitHub-Release-Seite des Projekts verfügbar:

  1. Erstellen Sie den Ordner: mkdir ./immich-app und verschieben Sie ihn mit cd ./immich-app
  2. Laden Sie die Compose-Datei herunter: wget -O docker-compose.yml https://github.com/immich-app/immich/releases/latest/download/docker-compose.yml
  3. Laden Sie die Umgebungsvorlage herunter: wget -O .env https://github.com/immich-app/immich/releases/latest/download/example.env
  4. Beachten Sie die Umbenennung in diesem zweiten Befehl – die Vorlage heißt example.env, aber Docker liest sie nur, wenn die Datei genau .env heißt.
3

Bearbeiten Sie die .env-Datei – die einzige Konfiguration, die zählt

Die Datei .env enthält die wenigen Werte, die Immich nicht erraten kann. Öffnen Sie es mit nano .env und legen Sie Folgendes fest:

  1. UPLOAD_LOCATION=./library – wo Ihre Originalfotos und -videos gespeichert werden. Richten Sie dies auf Ihre größte und zuverlässigste Festplatte. Es muss ein Ordner mit ausreichend freiem Speicherplatz für die gesamte Bibliothek sein
  2. DB_DATA_LOCATION=./postgres – wo sich die Datenbank befindet. Bewahren Sie dies auf einer lokalen SSD auf. Immichs Dokumentation ist unverblümt: Netzwerkfreigaben werden für die Datenbank nicht unterstützt, und wenn man sie darüber laufen lässt, kann sie beschädigt werden
  3. DB_PASSWORD= – ändern Sie dies in ein langes zufälliges Passwort. Verwenden Sie nur Buchstaben und Zahlen (A-Z, a-z, 0-9) – Sonderzeichen können die Analyse der Datei durch Docker unterbrechen
  4. TZ=Asia/Kolkata – Entfernen Sie die Kommentarfunktion und legen Sie Ihre Zeitzone fest, damit Fototermine und geplante Aufträge übereinstimmen
  5. Lassen Sie IMMICH_VERSION und alles unterhalb der markierten Linie für eine Erstinstallation in Ruhe
4

Starten Sie den Stack und erstellen Sie das Admin-Konto

  1. Führen Sie docker compose up -d aus – Docker lädt vier Container-Images herunter und startet sie zusammen. Der erste Durchgang dauert je nach Internetgeschwindigkeit einige Minuten
  2. Überprüfen Sie, ob alles mit docker compose ps angezeigt wurde – Sie sollten sehen, dass der Server, das maschinelle Lernen, die Datenbank und die Redis-Container ausgeführt werden
  3. Öffnen Sie http://YOUR-SERVER-IP:2283 in einem Browser im selben Netzwerk. Immich antwortet auf Port 2283
  4. Klicken Sie sich durch den Willkommensbildschirm und registrieren Sie sich. Das allererste erstellte Konto wird zum Administrator – führen Sie diesen Schritt also sofort selbst aus, bevor jemand anderes in Ihrem Netzwerk die Seite findet
  5. Öffnen Sie im Inneren die Verwaltung und führen Sie die Speicher- und Bibliotheksprüfungen durch. Installieren Sie dann die kostenlose Immich-App auf Ihrem Telefon, melden Sie sich mit derselben Serveradresse an und aktivieren Sie die automatische Sicherung
5

Was gerade angefangen hat – vier Container, vier Jobs

Die von Ihnen heruntergeladene Compose-Datei führt ein kleines Team aus, kein einzelnes Programm:

  1. immich-server – das Gehirn. Die Weboberfläche, die API, mit der Ihr Telefon kommuniziert, Uploads, Alben, Freigabe und Suche
  2. immich-machine-learning – die Augen. Gesichtserkennung, Gesichtserkennung und intelligente Suche laufen hier im Hintergrund
  3. Datenbank (PostgreSQL) – der Speicher. Hier sind der Name, das Datum, das Album, das Gesicht und die Suchdaten jedes Fotos gespeichert. Die Originale sind Akten; Die Bedeutung befindet sich in dieser Datenbank
  4. redis – der Bote. Es leitet Jobs zwischen dem Server und den Hintergrundarbeitern weiter

Später ist es wichtig, diese Aufteilung zu kennen: Wenn die Suche abbricht, überprüfen Sie das maschinelle Lernen. Wenn Fotos aus der Timeline verschwinden, sich die Dateien aber noch auf der Festplatte befinden, überprüfen Sie die Datenbank. Der Begleitleitfaden auf dieser Seite entschlüsselt jeden Dienst vollständig.

6

Die drei Regeln, die Sie vom ersten Tag an befolgen sollten

  1. Vor dem Update lesen. Immich-Releases werden oft veröffentlicht und einige Releases enthalten Breaking Changes, die einen bestimmten Upgrade-Schritt erfordern. Zwei Minuten mit den Versionshinweisen sind besser als ein Wochenende der Erholung
  2. Sichern Sie das Paar, nicht nur die Fotos. Ihre Bibliotheksdateien verlieren ohne die Datenbank ihre Alben, Gesichter und Organisation. Ein echtes Backup deckt beides ab
  3. Setzen Sie den Raw-Port niemals dem Internet aus. Port 2283 in Ihrem Heimnetzwerk ist in Ordnung. Verwenden Sie im offenen Internet ein VPN oder einen Tunnel – der Fernzugriffsleitfaden auf dieser Seite erklärt warum und wie

Wenn Sie diese drei befolgen, ist Immich eine wirklich zuverlässige private Cloud. Ignorieren Sie sie und dieselbe Software wird zur Warnung – der Unterschied liegt in den Gewohnheiten, nicht im Werkzeug.

🔴 Die ehrliche Bemerkung von Immich selbst: Das Projekt befindet sich in aktiver Entwicklung und verändert sich schnell. Behandeln Sie Immich als Ihre Foto-Plattform, nicht als Ihre einzige Kopie. Führen Sie eine separate Sicherung der Bibliothek und der Datenbank durch. Die auf dieser Seite verlinkte Sicherungsanleitung zeigt die vollständige Routine.

🎥 Sehen Sie sich den kompletten Vorgang im Video an

Die komplette Installation – Servereinrichtung, Telefon-App-Verbindung und erstes Backup – wird live im Video demonstriert.

▶️ Watch Full Video
❓ Häufig gestellte Fragen

Ist Immich wirklich kostenlos oder gibt es eine kostenpflichtige Stufe?

Immich ist kostenlos und Open Source unter der AGPL-Lizenz, und das Projekt hat sich verpflichtet, alle Funktionen kostenlos zu halten – es gibt keine Paywall-Stufe. Ein optionaler Kauf dient lediglich der Unterstützung der Entwickler und schaltet nichts frei. Ihre tatsächlichen Kosten sind Ihre eigene Hardware und Strom.

Wie viel RAM und Speicher benötigt Immich tatsächlich?

Planen Sie etwa 4 GB RAM als Grundfläche ein – der Container für maschinelles Lernen ist der hungrigste Teil – und Speicherplatz in der Höhe Ihrer gesamten Fotobibliothek plus etwa 10–20 Prozent zusätzlich für Miniaturansichten und transkodierte Videos. Der Speicher ist lange vor der CPU erschöpft.

Kann ich Immich unter Windows oder einem Raspberry Pi ausführen?

Der offiziell unterstützte Weg ist Docker unter Linux – was die meisten NAS-Systeme und Mini-PCs umfasst. Unter Windows ist Docker in WSL2 oder eine kleine virtuelle Linux-Maschine der praktische Weg. Ein Raspberry Pi kann es ausführen, aber Gesichtserkennung und Videojobs werden langsam sein; Ein günstiger gebrauchter Mini-PC ist dafür ein viel glücklicheres Zuhause.

Dieser Leitfaden basiert auf dem oben verlinkten Technical Anshu-Video. • Sie stecken auf einer Stufe fest? Fragen Sie in den Videokommentaren – dort kommen die Antworten am schnellsten 🙏