Em resumo: coloque a base de dados do Immich num SSD local compatível com Unix e monte o HDD USB como suporte multimédia
O caso de 2025 tornou-se confuso porque “utilizar o HDD externo para o Immich” pode significar duas coisas muito diferentes. A base de dados PostgreSQL do Immich tem requisitos rigorosos relativamente ao sistema de ficheiros. As fotografias existentes num HDD USB devem ser ligadas como uma biblioteca externa, enquanto a base de dados permanece num armazenamento SSD local e estável.
Não coloque a base de dados PostgreSQL do Immich em NTFS, exFAT ou numa partilha de rede
Os requisitos atuais do Immich indicam explicitamente que o diretório de dados do PostgreSQL deve, idealmente, estar num armazenamento SSD local e utilizar um sistema de ficheiros compatível com proprietários/permissões Unix. NTFS e exFAT não são suportados para a base de dados. Consulte os requisitos da base de dados do Immich.
O armazenamento externo do Immich traduz esse modelo para o ZimaOS.
Utilize o HDD USB como biblioteca externa quando as fotografias já existem nele
Mapeie o caminho real do anfitrião ZimaOS para o immich-server, de preferência em modo só de leitura para suportes de arquivo:
/media/YourUSB/Photos:/external_library:roEm seguida, adicione /external_library dentro do Immich. O nome exato no lado do contentor pode ser diferente; só precisa de corresponder ao caminho que o contentor efetivamente vê. A documentação das bibliotecas externas do Immich explica esta regra.
Porque é que uma instalação pode funcionar e a seguinte falhar
O estado dos contentores, os volumes antigos, os caminhos incorretos do anfitrião e os diretórios da base de dados podem persistir ou mudar entre tentativas. Antes de reinstalar repetidamente, verifique os mapeamentos e registos reais:
docker ps -a
docker logs --tail=200 immich_server
lsblk -fOs caminhos das aplicações do ZimaOS ajudam a distinguir o caminho do anfitrião ZimaOS do caminho visível dentro do Immich.
Não considere a antiga resposta “atualize para a versão 1.5.0 e funcionará” como solução
A atualização do ZimaOS melhorou o suporte para USB, mas o autor original reproduziu posteriormente a falha mesmo após uma instalação personalizada bem-sucedida. Isso prova que a versão, por si só, não era suficiente. A configuração atual deve ser validada com base no formato do armazenamento, no caminho de montagem, na localização da base de dados e nos registos dos contentores.
Uma disposição estável para arquivos de fotografias baseados em USB
- Dados da aplicação ZimaOS/Immich: SSD.
- Base de dados PostgreSQL do Immich: SSD local compatível com Unix.
- Arquivo de fotografias existente: HDD USB mapeado como biblioteca externa.
- Cópia de segurança independente: outro disco ou destino externo.
A cópia de segurança do ZimaOS cobre a última camada.
