Immich Docker Compose: The Recommended Install
Set up Immich with the current Docker Compose files, correct storage paths, and version-aware checks.
Direct answer
Docker Compose is Immich's recommended production deployment. Download the compose file and environment template from the current release, set UPLOAD_LOCATION and local DB_DATA_LOCATION, then run docker compose up -d.
Requirements
Immich documents 6 GB RAM minimum and 8 GB recommended. Postgres should use local SSD storage and never a network share. Use docker compose; the legacy docker-compose command is deprecated.
Installation
Download the files from the official Docker Compose guide, rename the environment template to .env, set a random alphanumeric DB_PASSWORD, and choose a timezone if needed.
Start the stack with docker compose up -d, then open port 2283 and register the first user. The first registered user becomes the admin.
Storage and verification
Keep DB_DATA_LOCATION on a filesystem that supports ownership and permissions. Confirm the four services are healthy, finish onboarding, and review the post-install backup guidance.
Platform notes
The official Compose stack includes Redis and Postgres. An Unraid community template can have different prerequisites. Docker in Proxmox LXC is not recommended; a full VM is the supported boundary described by the requirements.