Self-hosting Immich on a VPS: disk, RAM, and the machine-learning trade-offImmich selbst hosten auf einem VPS: Speicherplatz, RAM und der Machine-Learning-Trade-off

Get the official compose file, not one from memoryHolen Sie sich die offizielle Compose-Datei, nicht eine aus dem Gedächtnis

Immich publishes a working docker-compose.yml and an example.env as release assets, and the project's own install instructions are to download them rather than hand-assemble the stack:Immich veröffentlicht eine funktionierende docker-compose.yml und eine example.env als Release-Assets, und die eigenen Installationsanweisungen des Projekts lauten, sie herunterzuladen, statt den Stack von Hand zusammenzubauen:

mkdir ./immich-app && cd ./immich-app
curl -o docker-compose.yml https://github.com/immich-app/immich/releases/latest/download/docker-compose.yml
curl -o .env https://github.com/immich-app/immich/releases/latest/download/example.env

Do this even if you have run Immich before. The compose file's shape changes between releases — a service gets added, a volume gets renamed — and a file you copied from an old guide (this one included, eventually) will drift from what the version you are installing actually expects. Read the file after you download it; the rest of this guide tells you what to change in it, not a replacement for it.Machen Sie das auch dann, wenn Sie Immich schon einmal betrieben haben. Die Form der Compose-Datei ändert sich zwischen den Releases — ein Service kommt dazu, ein Volume wird umbenannt —, und eine Datei, die Sie aus einer alten Anleitung kopiert haben (irgendwann auch diese hier), driftet von dem ab, was die Version, die Sie installieren, tatsächlich erwartet. Lesen Sie die Datei, nachdem Sie sie heruntergeladen haben; der Rest dieser Anleitung sagt Ihnen, was Sie darin ändern, er ersetzt sie nicht.

Sizing: disk is the constraint, not CPUDimensionierung: Der Speicherplatz ist der begrenzende Faktor, nicht die CPU

Immich stores your originals, its own generated thumbnails, and — if you turn on transcoding — re-encoded video, all under one path you set as UPLOAD_LOCATION in .env. That path wants to be on the VPS's main disk, and it is the number that actually runs out.Immich speichert Ihre Originale, seine eigenen erzeugten Thumbnails und — wenn Sie Transcoding einschalten — neu kodiertes Video, alles unter einem Pfad, den Sie als UPLOAD_LOCATION in .env festlegen. Dieser Pfad will auf der Hauptfestplatte des VPS liegen, und sie ist die Größe, die Ihnen tatsächlich ausgeht.

Put a rough figure on it before you commit to a tier: a phone camera library is commonly tens of gigabytes a year once video is in the mix, and Immich keeps the originals untouched alongside its derived files, so you are never storing less than the library itself. An 80 GB Standard disk is comfortable for a modest personal library — one phone, a browsed-in second one, a few years of photos — but it is not a lot of headroom once video backups are on, and it fills faster than people expect from a "just photos" app. If you already know the library is large, or belongs to a household of phones rather than one, size up before you install rather than migrating UPLOAD_LOCATION later. add extra storage to your VPS covers growing the disk on our machines if you need to.Setzen Sie sich eine grobe Zahl, bevor Sie sich auf einen Tarif festlegen: Eine Handykamera-Bibliothek liegt üblicherweise bei einigen Dutzend Gigabyte pro Jahr, sobald Video mit im Spiel ist, und Immich lässt die Originale unangetastet neben seinen abgeleiteten Dateien liegen, sodass Sie nie weniger speichern als die Bibliothek selbst. Eine 80-GB-Festplatte im Standard-Tarif ist komfortabel für eine bescheidene private Bibliothek — ein Handy, ein zweites, das gelegentlich mitläuft, ein paar Jahre Fotos —, aber sie bietet nicht viel Spielraum, sobald Video-Backups laufen, und sie füllt sich schneller, als man es von einer „nur Fotos“-App erwarten würde. Wissen Sie bereits, dass die Bibliothek groß ist oder einem ganzen Haushalt an Handys statt nur einem gehört, dimensionieren Sie vor der Installation größer, statt UPLOAD_LOCATION später zu migrieren. Speicherplatz zu Ihrem VPS hinzufügen beschreibt, wie Sie die Festplatte auf unseren Maschinen vergrößern, falls Sie das brauchen.

RAM: the honest machine-learning storyRAM: die ehrliche Machine-Learning-Geschichte

Immich's core server is not the heavy part. The machine-learning container is — it is what does facial recognition, object detection and the CLIP-based smart search, and it holds real models in memory to do it. Run it on a box that is genuinely tight on RAM and it either gets OOM-killed mid-job or drags everything else on the machine down with it.Immichs Kernserver ist nicht der schwere Teil. Das ist der Machine-Learning-Container — er übernimmt Gesichtserkennung, Objekterkennung und die CLIP-basierte Smart Search, und dafür hält er echte Modelle im Speicher. Läuft er auf einer Maschine, die wirklich knapp bei RAM ist, wird er entweder mitten im Job per OOM gekillt oder reißt alles andere auf der Maschine mit runter.

4 GiB is the number that keeps coming up from people who have actually run the machine-learning container on a small box without it falling over, and it matches what vps-standard gives you. On a 2 GiB box, do not pretend the ML container will behave: either remove the immich-machine-learning service from the compose file, and also turn off Smart Search and Face Recognition under Administration > Settings so the server stops queuing jobs against a machine-learning service that no longer exists rather than leaving them to fail silently, or point the server at a machine-learning instance running somewhere with more headroom, which Immich's admin settings support as a URL you configure rather than a service you have to run locally. Running it anyway "to see" on 2 GiB is how people end up debugging an unrelated crash that was actually the kernel reaping the ML container for memory.4 GiB ist die Zahl, die immer wieder von Leuten kommt, die den Machine-Learning-Container tatsächlich auf einer kleinen Maschine betrieben haben, ohne dass er zusammenbricht, und das entspricht genau dem, was vps-standard bietet. Auf einer 2-GiB-Maschine sollten Sie sich nichts vormachen, was den ML-Container angeht: Entfernen Sie entweder den Service immich-machine-learning aus der Compose-Datei und schalten Sie zusätzlich Smart Search und Gesichtserkennung unter Administration > Einstellungen ab, damit der Server aufhört, Jobs gegen einen Machine-Learning-Service einzureihen, der gar nicht mehr existiert, statt sie still scheitern zu lassen, oder richten Sie den Server auf eine Machine-Learning-Instanz aus, die irgendwo mit mehr Spielraum läuft — das unterstützen Immichs Admin-Einstellungen als konfigurierbare URL, nicht als Service, den Sie lokal betreiben müssen. Ihn trotzdem „nur um zu sehen“ auf 2 GiB laufen zu lassen, ist der Weg, auf dem Leute am Ende einen scheinbar unabhängigen Absturz debuggen, der in Wirklichkeit der Kernel war, der dem ML-Container den Speicher wegnahm.

What ships in the compose file, and the one image you must not swapWas in der Compose-Datei mitgeliefert wird, und das eine Image, das Sie nicht austauschen dürfen

The downloaded file wires up four services: immich-server (the API and web UI), immich-machine-learning, redis for job queuing, and a database service. That database image is the detail every "just use Postgres" instinct gets wrong: Immich ships a Postgres image built with the vector-search extension its facial and CLIP search rely on, not the official postgres image. Leave that image line exactly as the file sets it, and do not repoint it at a plain postgres:16 or similar — the extension is not something you can CREATE EXTENSION your way into afterwards, and a schema Immich created against the wrong image will not open correctly against the real one later.Die heruntergeladene Datei verdrahtet vier Services: immich-server (die API und die Weboberfläche), immich-machine-learning, redis für die Job-Warteschlange und einen Datenbank-Service. Genau bei diesem Datenbank-Image liegt jeder „nehmen Sie einfach Postgres“-Instinkt falsch: Immich liefert ein Postgres-Image, das mit der Vector-Search-Erweiterung gebaut ist, auf die seine Gesichts- und CLIP-Suche angewiesen sind, nicht das offizielle postgres-Image. Lassen Sie diese Image-Zeile exakt so, wie die Datei sie setzt, und richten Sie sie nicht auf ein einfaches postgres:16 oder ähnliches um — die Erweiterung ist nichts, was Sie sich nachträglich mit CREATE EXTENSION erschließen können, und ein Schema, das Immich gegen das falsche Image erstellt hat, öffnet sich später nicht korrekt gegen das richtige.

The two changes worth making in .env before you bring the stack up:Die zwei Änderungen, die sich in .env lohnen, bevor Sie den Stack hochfahren:

UPLOAD_LOCATION=./library
DB_DATA_LOCATION=./postgres
DB_PASSWORD=<a-long-random-password>
IMMICH_VERSION=release

Set a real DB_PASSWORD — the example file ships an obvious placeholder — and point UPLOAD_LOCATION at wherever the library should actually live on this disk. Then pin the version:Setzen Sie ein echtes DB_PASSWORD — die Beispieldatei liefert einen offensichtlichen Platzhalter — und richten Sie UPLOAD_LOCATION auf den Ort, an dem die Bibliothek auf dieser Festplatte tatsächlich liegen soll. Dann pinnen Sie die Version:

IMMICH_VERSION=v1.XXX.X   # replace with the exact tag from github.com/immich-app/immich/releases

release tracks whatever the project currently calls stable, which means docker compose pull can hand you a different Immich the day you least expect it. Pinning a real tag turns every update into something you chose and read about first, not something that happened to you on a routine restart.release folgt dem, was das Projekt gerade als stabil bezeichnet, das heißt, docker compose pull kann Ihnen ausgerechnet an dem Tag ein anderes Immich unterschieben, an dem Sie es am wenigsten erwarten. Einen echten Tag zu pinnen macht aus jedem Update etwas, das Sie bewusst gewählt und vorher darüber gelesen haben, nicht etwas, das Ihnen bei einem Routine-Neustart einfach passiert ist.

Bring it up once both files are edited:Fahren Sie ihn hoch, sobald beide Dateien bearbeitet sind:

docker compose up -d

First run: the first account is the admin accountErster Start: Das erste Konto ist das Admin-Konto

Point a browser at the server (http://<vps-ip>:2283 before you have HTTPS in front of it, matching the port the compose file maps) and register. Immich makes the first account created the instance's administrator, with no separate setup step — so do this yourself, immediately after the stack comes up, before anyone else who might have the URL gets there first.Richten Sie einen Browser auf den Server (http://<vps-ip>:2283, solange noch kein HTTPS davor liegt, passend zum Port, den die Compose-Datei mappt) und registrieren Sie sich. Immich macht das zuerst angelegte Konto automatisch zum Administrator der Instanz, ohne separaten Einrichtungsschritt — machen Sie das also selbst, sofort nachdem der Stack hochgekommen ist, bevor irgendjemand sonst, der die URL kennen könnte, Ihnen zuvorkommt.

HTTPS with Caddy, and the NAT catch for port 443HTTPS mit Caddy, und der NAT-Haken bei Port 443

Immich's own container serves plain HTTP; put a reverse proxy in front for a real certificate and a normal URL:Immichs eigener Container liefert schlichtes HTTP aus; setzen Sie einen Reverse-Proxy davor für ein echtes Zertifikat und eine normale URL:

photos.example.com {
    reverse_proxy 127.0.0.1:2283
}

That is the whole file — Caddy requests and renews the certificate on its own once this config is running, provided the domain's A record already points at the box. Point DNS first (point your domain at your service if you have not done that on our machines before), let it resolve, then start Caddy.Das ist die gesamte Datei — Caddy fordert das Zertifikat selbstständig an und erneuert es auch selbst, sobald diese Konfiguration läuft, vorausgesetzt der A-Record der Domain zeigt schon auf die Maschine. Richten Sie zuerst den DNS-Eintrag ein (Ihre Domain auf Ihren Dienst zeigen lassen, falls Sie das auf unseren Maschinen noch nicht gemacht haben), lassen Sie ihn auflösen, und starten Sie dann Caddy.

Read this before you buy: our VPS plans reach the internet through NAT IPv4 with a dedicated SSH port and a small number of forwarded ports besides it — whether 80 and 443 are among them depends on the plan, and it is not something to assume either way. Check what your tier actually forwards before you point a domain at it and expect a certificate to issue; NAT IPv4, ports and forwarding has the mechanics, and NAT IPv4 vs a dedicated IP explains why NAT works this way at all. A dedicated IPv4, if you decide later you want a fixed port 443 of your own regardless of plan, is not something we offer today.Lesen Sie das, bevor Sie kaufen: Unsere VPS-Pläne erreichen das Internet über NAT-IPv4 mit einem dedizierten SSH-Port und einer kleinen Zahl weiterer weitergeleiteter Ports — ob 80 und 443 darunter sind, hängt vom Tarif ab, und das ist nichts, was Sie in die eine oder andere Richtung einfach annehmen sollten. Prüfen Sie, was Ihr Tarif tatsächlich weiterleitet, bevor Sie eine Domain darauf richten und ein Zertifikat erwarten; NAT IPv4, Ports und Weiterleitung erklärt die Mechanik, und NAT IPv4 vs. dedizierte IP erklärt, warum NAT überhaupt so funktioniert. Eine dedizierte IPv4 bieten wir derzeit nicht an, auch nicht, falls Sie sich später für einen festen eigenen Port 443 entscheiden, unabhängig vom Tarif.

The mobile app is the point — set it up properlyDie Handy-App ist der Punkt — richten Sie sie richtig ein

Install the Immich app, and when it asks for a server, give it the same HTTPS URL Caddy answers on — https://photos.example.com, no port number, since the certificate and the reverse proxy are what make that address work at all. Log in with the account you registered, then turn on background backup in the app's settings; that continuous phone-to-server sync, not the web UI, is what actually replaces the thing you were leaving.Installieren Sie die Immich-App, und wenn sie nach einem Server fragt, geben Sie ihr genau die HTTPS-URL, unter der Caddy antwortet — https://photos.example.com, ohne Portnummer, denn das Zertifikat und der Reverse-Proxy sind es, die diese Adresse überhaupt funktionieren lassen. Melden Sie sich mit dem Konto an, das Sie registriert haben, und schalten Sie dann in den App-Einstellungen das Hintergrund-Backup ein; dieser dauerhafte Sync vom Handy zum Server, nicht die Weboberfläche, ist es, was tatsächlich das ersetzt, was Sie hinter sich lassen wollten.

Backups: the database dump and the library, both off the boxBackups: der Datenbank-Dump und die Bibliothek, beide weg von der Maschine

A snapshot of the disk is not a backup plan by itself, and Immich's own documentation is specific about what a real one needs: a dump of the Postgres database, taken with pg_dumpall against the running container, plus the upload directory as a separate copy.Ein Snapshot der Festplatte ist für sich genommen kein Backup-Plan, und Immichs eigene Dokumentation ist konkret, was ein echter braucht: einen Dump der Postgres-Datenbank, erstellt mit pg_dumpall gegen den laufenden Container, plus das Upload-Verzeichnis als separate Kopie.

docker exec -t immich_postgres pg_dumpall --clean --if-exists --username=postgres > "immich-db-$(date +%F).sql"

That captures the database's actual state — accounts, albums, face and search metadata — in a form the project's own restore instructions expect. It does not capture the photos and videos themselves; those live under UPLOAD_LOCATION and need copying separately, and they are the far larger of the two. Do both, and copy both off the VPS entirely: a dump sitting on the same disk as the library it describes survives neither a full-disk failure nor your own rm mistake. back up your VPS is our general write-up of what off-machine backup means on our machines.Das erfasst den tatsächlichen Zustand der Datenbank — Konten, Alben, Gesichts- und Such-Metadaten — in einer Form, die die eigenen Restore-Anweisungen des Projekts erwarten. Es erfasst nicht die Fotos und Videos selbst; die liegen unter UPLOAD_LOCATION und müssen separat kopiert werden, und sie sind die weitaus größeren der beiden. Machen Sie beides, und kopieren Sie beides vollständig vom VPS herunter: Ein Dump, der auf derselben Festplatte liegt wie die Bibliothek, die er beschreibt, übersteht weder einen kompletten Festplattenausfall noch einen eigenen rm-Fehler. Backup Ihres VPS ist unser allgemeiner Leitfaden dazu, was Backup abseits der Maschine auf unseren Maschinen bedeutet.

Updates: read the release notes before you pullUpdates: Lesen Sie die Release Notes, bevor Sie pullen

Because the tag is pinned rather than tracking release, an update is a step you take on purpose:Weil der Tag gepinnt ist, statt release zu folgen, ist ein Update ein Schritt, den Sie bewusst gehen:

docker compose pull
docker compose up -d

Do it in that order, and do it after reading the release notes for the version you are jumping to — Immich announces breaking changes there, including ones that touch the database schema or expect a manual step before the containers come back up. A pinned tag protects you from an update landing on you unannounced; it does not protect you from skipping the one paragraph that tells you a migration needs your attention first. Take the database dump above immediately before you pull, not after something has already gone sideways.Machen Sie es in dieser Reihenfolge, und machen Sie es erst, nachdem Sie die Release Notes für die Version gelesen haben, auf die Sie springen — Immich kündigt dort Breaking Changes an, einschließlich solcher, die das Datenbankschema betreffen oder einen manuellen Schritt erwarten, bevor die Container wieder hochkommen. Ein gepinnter Tag schützt Sie davor, dass Sie ein Update unangekündigt trifft; er schützt Sie nicht davor, den einen Absatz zu überspringen, der Ihnen sagt, dass eine Migration zuerst Ihre Aufmerksamkeit braucht. Machen Sie den Datenbank-Dump von oben unmittelbar vor dem Pull, nicht erst, nachdem schon etwas schiefgelaufen ist.

On overnight.hostBei overnight.host

Full disclosure: this is what we sell. Standard (4 GiB / 80 GB) runs the full stack, machine learning included, for a modest library; move to Pro once the library or the recognition workload outgrows it.Zur vollen Transparenz: Das ist, was wir verkaufen. Standard (4 GiB / 80 GB) betreibt den vollständigen Stack, Machine Learning inklusive, für eine bescheidene Bibliothek; wechseln Sie zu Pro, sobald die Bibliothek oder die Erkennungslast das übersteigt.

Linux KVM VPS — EUR 4.99 to EUR 59.99 a month, on our own single-tenant bare metal in Dallas, TX and Charlotte, NC. US locations (Dallas, TX and Charlotte, NC) are available; VPS plans can be ordered. Full hardware virtualisation (KVM), your own kernel, full root. Six tiers, vps-starter to vps-ultra. Starter is 1 vCPU, 1 GiB RAM, 25 GB disk.Linux-KVM-VPS — 4,99 bis 59,99 EUR im Monat, auf unserer eigenen Single-Tenant-Bare-Metal-Hardware in Dallas, TX und Charlotte, NC. US-Standorte (Dallas, TX und Charlotte, NC) sind verfügbar; VPS-Tarife können bestellt werden. Vollständige Hardware-Virtualisierung (KVM), eigener Kernel, volles Root. Sechs Tarife, vps-starter bis vps-ultra. Starter hat 1 vCPU, 1 GiB RAM, 25 GB Speicherplatz.

You order in the shop, pay by card (Stripe) or SEPA bank transfer, and your login details are e-mailed to you once the service is set up. Support is e-mail, run by one person, with no guaranteed response time. All prices are final totals under the German small-business rule (§19 UStG); no VAT is added or shown.Sie bestellen im Shop, zahlen per Karte (Stripe) oder SEPA-Überweisung, und Ihre Zugangsdaten werden Ihnen per E-Mail zugeschickt, sobald der Dienst eingerichtet ist. Support läuft per E-Mail, von einer einzelnen Person betrieben, ohne garantierte Reaktionszeit. Alle Preise sind Endpreise. Gemäß § 19 UStG wird keine Umsatzsteuer ausgewiesen.

Want your photos hosted in Germany instead of running a VPS yourself? Our VPS plans run in Dallas, TX and Charlotte, NC and are available to order. You can also order Nextcloud File Cloud: your own isolated Nextcloud instance, hosted in Germany (EU), from EUR 8 a month. Nextcloud is a different tool from Immich (file sync and sharing rather than a photo library), but its mobile apps can upload your phone photos automatically.Fotos lieber in Deutschland gehostet, statt selbst einen VPS zu betreiben? Unsere VPS-Tarife laufen in Dallas, TX und Charlotte, NC und sind wieder bestellbar. Zusätzlich bestellbar ist Nextcloud File Cloud: Ihre eigene isolierte Nextcloud-Instanz, gehostet in Deutschland (EU), ab 8 EUR im Monat. Nextcloud ist ein anderes Werkzeug als Immich (Dateisync und Teilen statt Fotobibliothek), aber die Mobil-Apps laden Ihre Handyfotos automatisch hoch.

Order VPS Standard (US: Dallas, TX / Charlotte, NC) → · Linux KVM VPS overviewVPS Standard bestellen (USA: Dallas, TX / Charlotte, NC) → · Übersicht Linux-KVM-VPS

Order Nextcloud File Cloud → · Linux KVM VPS overviewNextcloud File Cloud bestellen → · Übersicht Linux-KVM-VPS

Written by the person who runs overnight.host: a small, honest hosting company on dedicated bare metal — Linux VPS, game servers, web hosting. Live status at up.overnight.host.Geschrieben von der Person, die overnight.host betreibt: ein kleines, ehrliches Hosting-Unternehmen auf dedizierter Bare-Metal-Hardware — Linux-VPS, Gameserver, Webhosting. Live-Status unter up.overnight.host.