Requirements

Hardware and software requirements for Immich

Software

• Docker
• Docker Compose

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).
  • Windows is supported with Docker Desktop on Windows or WSL 2.
  • macOS is supported with Docker Desktop on Mac.
• 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 here for more details and alternatives.
  • 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.