Ir para o conteúdo principal

Requisitos

Requisitos de hardware e software para o Immich:

Hardware​

  • SO: Recomenda-se sistema operacional Linux ou *nix (Ubuntu, Debian, etc).
    • Sistemas operacionais não Linux tendem a oferecer uma experiência ruim com Docker e são fortemente desencorajados. Nossa capacidade de ajudar com configuração ou solução de problemas em sistemas não Linux será severamente reduzida. Se você ainda quiser tentar usar um sistema operacional não Linux, pode configurá-lo da seguinte maneira:
    • Immich funciona bem em um ambiente virtualizado ao executar em uma máquina virtual completa. O uso do Docker em contêineres LXC não é recomendado, mas pode ser possível para usuários avançados. Se você tiver problemas, recomendamos que mude para uma implementação compatível com VM.
  • RAM: Mínimo de 4GB, recomendado 6GB.
  • CPU: Mínimo de 2 núcleos, recomendado 4 núcleos.
  • Armazenamento: Recomendado sistema de arquivos compatível com Unix (EXT4, ZFS, APFS, etc.) com suporte para propriedade e permissões de usuário/grupo.
    • A geração de miniaturas e vídeo transcodificado pode aumentar o tamanho da biblioteca de fotos em 10-20% em média.
dica

Bom desempenho e uma conexão estável ao banco de dados Postgres são fundamentais para uma experiência tranquila no Immich. Os arquivos do banco de dados Postgres normalmente variam entre 1-3 GB de tamanho. Por essa razão, o banco de dados Postgres (DB_DATA_LOCATION) deve idealmente usar armazenamento SSD local e nunca compartilhamento de rede, de qualquer tipo. Além disso, se forem usados limites de recursos do Docker, o banco de dados Postgres requer pelo menos 2GB de RAM. Usuários do Windows podem enfrentar problemas com sistemas de arquivos não compatíveis com Unix, veja abaixo para mais detalhes.

Software​

Immich requer Docker com o plugin Docker Compose:

  • Docker Engine: Esta variante CLI foi projetada para servidores Linux (ou Windows via WSL2).
  • Docker Desktop: Esta variante GUI não é recomendada para Linux, mas está disponível para Windows ou macOS.

O plugin Compose será instalado tanto pelo Docker Engine quanto pelo Desktop ao seguir os guias de instalação vinculados; ele também pode ser instalado separadamente.

nota

Immich requer o comando docker compose; o similarmente nomeado docker-compose está obsoleto e não é mais suportado pelo Immich.

Requisitos especiais para usuários do Windows​

Armazenamento de banco de dados em sistemas Windows

O banco de dados Postgres Immich (DB_DATA_LOCATION) deve estar localizado em um sistema de arquivos que suporte propriedade e permissões de usuário/grupo (EXT2/3/4, ZFS, APFS, BTRFS, XFS, etc.). Não funcionará em nenhum sistema de arquivos formatado em NTFS ou ex/FAT/32. Não funcionará no WSL (Subsistema do Windows para Linux) ao usar um diretório montado do host (comumente em /mnt). Se isso for um problema, você pode alterar o ponto de montagem para um volume do Docker, conforme segue:

Faça a seguinte alteração no .env:

- DB_DATA_LOCATION=./postgres
+ DB_DATA_LOCATION=pgdata

Adicione a seguinte linha na parte inferior do docker-compose.yml:

volumes:
  model-cache:
+ pgdata: