Setup
Install, configure, verify, update, and roll back with confidence.
Recommended Installation
Immich Docker Compose
Install Immich with the official Docker Compose files. Configure storage and .env, verify startup, understand the Builder, and update safely.
Last reviewed 2026-10-14Start Installation Guide →Other setup guides
How to Update Immich: Docker Compose & v3
Update Immich safely with Docker Compose: read release notes, back up database and media, update .env, then verify migrations, uploads and thumbnails.
Immich Hardware Acceleration: GPU Setup for Video & ML
Enable Immich GPU acceleration for video transcoding or machine learning. Compare supported backends, configure Compose and verify actual device usage.
Immich Reverse Proxy: Nginx, HTTPS & Cloudflare Guide
Configure an Immich reverse proxy with HTTPS, correct headers and upload limits. Troubleshoot Nginx, Cloudflare, mobile connections and public access.
Official Installation Documentation
Docker Compose installation ↗
Immich’s recommended installation path using the official Compose files.
Requirements ↗
Check supported hardware, storage, and software requirements before installing.
Post-installation steps ↗
Complete the first admin, storage, and mobile setup after the server starts.
Other platforms
Immich on Synology: Install & Setup Guide
Install Immich on Synology with Container Manager. Plan local database storage, existing photo libraries, firewall access, backups and project updates.
Last reviewed 2026-09-16Immich on Proxmox: VM, Docker & Storage Guide
Install Immich in a Proxmox Linux VM with Docker Compose. Choose CPU features, database and NAS storage, then verify uploads, updates and backup coverage.
Last reviewed 2026-09-16Immich on TrueNAS: Install & Storage Setup Guide
Install Immich on TrueNAS with the Community app. Configure datasets, permissions, external libraries and port access, then plan updates and recovery.
Last reviewed 2026-09-16