PUBLISHED ARTIFACT // immich
High-performance self-hosted photo and video backup, management, search, and sharing.
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
# Set UPLOAD_LOCATION, DB_DATA_LOCATION, and a strong DB_PASSWORD in .env
docker compose up -dMinimum 6 GB RAM and 2 CPU cores; 8 GB RAM and 4 cores are recommended. Immich v3 machine learning on AMD64 requires x86-64-v2. Generated thumbnails and transcoded video commonly add 10–20% to library storage.
Docker Engine with the Docker Compose plugin. The official stack includes PostgreSQL with VectorChord, Valkey, and a machine-learning service. Keep DB_DATA_LOCATION on local SSD storage, never a network share.
Built-in multi-user accounts and administration, plus OAuth/OIDC support and API keys. Use HTTPS for production access.
Back up both UPLOAD_LOCATION and the PostgreSQL database; database dumps contain metadata but not photos or videos. Immich recommends a 3-2-1 strategy and stores automatic database dumps under UPLOAD_LOCATION/backups.
The project is under active development and must not be the only copy of photos or videos. Immich v3 machine learning on AMD64 requires x86-64-v2, and Docker inside LXC is not recommended.
Immich provides polished mobile backup, search, sharing, and machine-learning features, but requires more CPU, RAM, storage, and backup coordination than a simple gallery.