Skip to main content

Requirements

Hardware and software requirements for Immich:

Software​

note

Immich requires the command docker compose - the similarly named docker-compose is deprecated and is no longer compatible with Immich.

Hardware​

  • OS: Recommended Linux operating system (Ubuntu, Debian, etc).
  • RAM: Minimum 4GB, recommended 6GB.
  • CPU: Minimum 2 cores, recommended 4 cores.
  • Storage: Recommended Unix-compatible filesystem (EXT4, ZFS, APFS, etc.) with support for user/group ownership and permissions.
    • This can present an issue for Windows users. See below for details and an alternative setup.
    • The generation of thumbnails and transcoded video can increase the size of the photo library by 10-20% on average.
    • Network shares are supported for the storage of image and video assets only. It is not recommended to use a network share for your database location due to performance and possible data loss issues.

Special requirements for Windows users​

Database storage on Windows systems

The Immich Postgres database (DB_DATA_LOCATION) must be located on a filesystem that supports user/group ownership and permissions (EXT2/3/4, ZFS, APFS, BTRFS, XFS, etc.). It will not work on any filesystem formatted in NTFS or ex/FAT/32. It will not work in WSL (Windows Subsystem for Linux) when using a mounted host directory (commonly under /mnt). If this is an issue, you can change the bind mount to a Docker volume instead as follows:

Make the following change to .env:

- DB_DATA_LOCATION=./postgres
+ DB_DATA_LOCATION=pgdata

Add the following line to the bottom of docker-compose.yml:

volumes:
  model-cache:
+ pgdata: