Ir para o conteúdo principal

Integridade do Sistema

Verificação de Pastas​

informação

As pastas consideradas para essas verificações incluem: upload/, library/, thumbs/, encoded-video/, profile/, backups/

Quando o Immich inicia, ele realiza uma série de verificações para validar se consegue ler e escrever arquivos nos pontos de montagem de volume usados pelo sistema de armazenamento. Se não conseguir executar todas as operações necessárias, ele falhará ao iniciar. As verificações incluem:

  • Criar um arquivo oculto inicial (.immich) em cada pasta
  • Ler um arquivo oculto (.immich) em cada pasta
  • Sobrescrever um arquivo oculto (.immich) em cada pasta

As verificações são projetadas para detectar as seguintes situações:

  • Permissões incorretas (não é possível ler/gravar arquivos)
  • Montagem de volume ausente (os arquivos .immich deveriam existir, mas estão ausentes)

Problemas Comuns​

nota

Os arquivos .immich servem como marcadores e ajudam a rastrear os pontos de montagem usados pelo Immich. Exceto nas situações listadas abaixo, eles nunca devem ser criados ou excluídos manualmente.

Arquivos .immich Ausentes​

Verificando as pastas de montagem do sistema (habilitado=true)
...
ENOENT: arquivo ou diretório não encontrado, abrir 'upload/encoded-video/.immich'

As mensagens de erro acima mostram que o servidor anteriormente (com sucesso) escreveu arquivos .immich em cada pasta, mas agora não os detecta. Isso pode ser devido a qualquer uma das seguintes razões:

  • Erro de permissão - não é possível ler o arquivo, mas ele existe
  • O arquivo não existe - o ponto de montagem do volume foi alterado e deve ser corrigido
  • O arquivo não existe - o usuário o excluiu manualmente e ele deve ser recriado manualmente (touch .immich)
  • O arquivo não existe - o usuário restaurou a partir de um backup, mas não restaurou cada pasta (o usuário deve restaurar todas as pastas ou criar manualmente o .immich em qualquer pasta ausente)

Ignorando as Verificações​

aviso

As verificações são projetadas para identificar problemas comuns que os usuários tiveram no passado e frequentemente indicam que há algo errado que você deve resolver. Se você sabe o que está fazendo e deseja desativá-las, pode definir a seguinte variável de ambiente:

IMMICH_IGNORE_MOUNT_CHECK_ERRORS=true