Saltar al contenido principal

Requisitos

Requisitos de hardware y software para Immich:

Hardware​

  • OS: Sistema operativo Linux o *nix recomendado (Ubuntu, Debian, etc).
    • Los sistemas operativos que no son Linux tienden a proporcionar una experiencia deficiente con Docker y están fuertemente desaconsejados. Nuestra capacidad para ayudar con la configuración o solución de problemas en sistemas operativos que no sean Linux se reducirá significativamente. Si aún deseas intentar usar un sistema operativo que no sea Linux, puedes configurarlo de la siguiente manera:
    • Immich funciona bien en un entorno virtualizado cuando se ejecuta en una máquina virtual completa. El uso de Docker en contenedores LXC no está recomendado, pero puede ser posible para usuarios avanzados. Si tienes problemas, recomendamos cambiar a una implementación de máquina virtual compatible.
  • RAM: Mínimo 4GB, recomendado 6GB.
  • CPU: Mínimo 2 núcleos, recomendado 4 núcleos.
  • Almacenamiento: Se recomienda un sistema de archivos compatible con Unix (EXT4, ZFS, APFS, etc.) con soporte para propiedad y permisos de usuario/grupo.
    • La generación de miniaturas y vídeos transcodificados puede aumentar el tamaño de la biblioteca de fotos en un promedio del 10-20%.
consejo

Un buen rendimiento y una conexión estable a la base de datos Postgres es crucial para una experiencia fluida con Immich. Los archivos de la base de datos Postgres suelen tener entre 1-3 GB de tamaño. Por este motivo, lo ideal es que la base de datos Postgres (DB_DATA_LOCATION) utilice almacenamiento local en SSD, y nunca un recurso compartido en red de ningún tipo. Además, si se usan límites de recursos en Docker, la base de datos Postgres requiere al menos 2GB de RAM. Los usuarios de Windows pueden tener problemas con sistemas de archivos no compatibles con Unix; consulta más abajo para obtener más detalles.

Software​

Immich requiere Docker con el complemento Docker Compose:

  • Motor Docker: Esta variante de CLI está diseñada para servidores Linux (o Windows vía WSL2).
  • Docker Desktop: Esta variante GUI no está recomendada para Linux, pero está disponible para Windows o macOS.

El complemento Compose será instalado tanto por Docker Engine como por Desktop siguiendo las guías de instalación vinculadas; también puede ser instalado por separado.

nota

Immich requiere el comando docker compose; el similar docker-compose está obsoleto y ya no es compatible con Immich.

Requisitos especiales para usuarios de Windows​

Almacenamiento de base de datos en sistemas Windows

La base de datos Postgres de Immich (DB_DATA_LOCATION) debe estar ubicada en un sistema de archivos que soporte propiedad y permisos de usuario/grupo (EXT2/3/4, ZFS, APFS, BTRFS, XFS, etc.). No funcionará en ningún sistema de archivos formateado en NTFS o ex/FAT/32. No funcionará en WSL (Windows Subsystem for Linux) cuando se utilice un directorio de host montado (comúnmente bajo /mnt). Si esto es un problema, puedes cambiar el montaje vinculado a un volumen de Docker como sigue:

Haz el siguiente cambio en .env:

- DB_DATA_LOCATION=./postgres
+ DB_DATA_LOCATION=pgdata

Añade la siguiente línea al final de docker-compose.yml:

volumes:
  model-cache:
+ pgdata: