Configurações do Sistema
O usuário administrador pode gerenciar as configurações da instância do Immich aqui.
Você pode sempre retornar às configurações padrão clicando no botão Redefinir para o padrão.
Configurações de Autenticação
Gerencie senha, OAuth e outras configurações de autenticação.
Autenticação OAuth
O Immich suporta Autenticação OAuth. Leia mais sobre este recurso e sua configuração aqui.
Autenticação por Senha
O administrador pode optar por desativar o login com nome de usuário e senha para toda a instância. Isso significa que ninguém, incluindo o administrador do sistema, poderá fazer login usando esse método. Se a Autenticação OAuth também estiver desativada, nenhum usuário poderá fazer login usando nenhum método. Essa alteração não afeta sessões existentes, apenas novas tentativas de login.
Você pode sempre usar o CLI do Servidor para reativar o login por senha.
Configurações de Imagem (miniaturas e pré-visualizações)
- Miniaturas - Usadas na linha do tempo principal.
- Pré-visualizações - Usadas no visualizador de ativos.
Por padrão, o Immich cria 3 miniaturas para cada ativo: Desfocadas (thumbhash), pequenas (webp) e grandes - pré-visualizações (jpeg/webp). Com essas configurações, você pode alterar a qualidade dos arquivos de miniaturas e pré-visualizações que são criados.
Formato da Miniatura
Permite escolher o tipo de formato desejado para as imagens de miniatura. Webp produz arquivos menores do que jpeg, mas é mais lento para codificar.
Você pode ler em detalhes sobre as vantagens e desvantagens de usar webp em vez de jpeg no site da Adobe.
Resolução da Miniatura
Usada ao visualizar grupos de fotos (linha do tempo principal, visualização do álbum, etc.). Resoluções mais altas podem preservar mais detalhes, mas demoram mais para codificar, possuem tamanhos maiores de arquivo e podem reduzir a responsividade do aplicativo.
Formato da Pré-visualização
Permite escolher o tipo de formato desejado para as pré-visualizações. Webp produz arquivos menores em comparação ao jpeg, mas é mais lento para codificar.
Resolução da Pré-visualização
Usada ao visualizar uma foto individual e para aprendizado de máquina. Resoluções mais altas podem preservar mais detalhes, mas demoram mais para codificar, têm tamanhos maiores de arquivo e podem reduzir a responsividade do aplicativo.
Qualidade
Qualidade da imagem de 1 a 100. Valores mais altos resultam em maior qualidade, mas produzem arquivos maiores; essa opção afeta as imagens de Pré-visualização e Miniatura.
Preferir gama ampla
Usa Display P3 para miniaturas. Isso preserva melhor a vivacidade de imagens com espaços de cores amplos, mas as imagens podem parecer diferentes em dispositivos mais antigos com versões antigas de navegador. Imagens sRGB permanecem como sRGB para evitar mudanças de cor.
Preferir pré-visualização incorporada
Usa pré-visualizações incorporadas em fotos RAW como entrada para o processamento de imagens, quando disponível. Isso pode produzir cores mais precisas para algumas imagens, mas a qualidade da pré-visualização depende da câmera e a imagem pode conter mais artefatos de compressão.
A resolução padrão das miniaturas grandes pode ser reduzida de 1440p (padrão) para 1080p ou 720p para economizar espaço de armazenamento.
Configurações de Tarefas
Com essas configurações, você pode determinar a quantidade de trabalho que será executado simultaneamente para cada tarefa nos microsserviços. Algumas tarefas podem ser configuradas para valores mais altos em computadores com hardware potente e armazenamento com boa capacidade de I/O.
Com maior concorrência, o host trabalhará em mais ativos simultaneamente, essa configuração melhora o rendimento, não a latência. Por exemplo, fará com que tarefas de Pesquisa Inteligente sejam processadas mais rapidamente, mas não tornará a busca mais rápida.
É importante lembrar que tarefas como Pesquisa Inteligente, Detecção Facial, Reconhecimento Facial e Transcodificação de Vídeos exigem muita potência de processamento. Portanto, não exagere na quantidade dessas tarefas, pois você pode sobrecarregar o servidor.
:::perigo IMPORTANTE Se você aumentar a concorrência além dos padrões definidos, especialmente para geração de miniaturas, certifique-se de não ultrapassar a quantidade de núcleos de CPU disponíveis. Fazer isso pode impactar a responsividade da API sem ganho na velocidade de geração de miniaturas. :::
O valor de Concorrência no Reconhecimento Facial não pode ser alterado porque DBSCAN é tradicionalmente sequencial, embora existam implementações paralelas dele. Nossa implementação não é paralela.
Biblioteca Externa
Monitoramento de Biblioteca (EXPERIMENTAL)
Bibliotecas externas podem importar automaticamente arquivos alterados sem uma reanálise completa. O arquivo será importado sempre que o sistema operacional relatar uma alteração no arquivo. Se suas fotos estiverem montadas em rede, isso não funcionará.
Varredura Periódica
Você pode definir um intervalo personalizado para disparar a reanálise da biblioteca externa em Administração -> Configurações -> Biblioteca.
Você pode definir o intervalo de varredura usando os valores predefinidos ou no formato cron. Para mais informações, consulte Crontab Guru, por exemplo.
Registro de Logs
O nível de log padrão do Immich é Log (comumente conhecido como Info). O administrador do Immich pode escolher um nível de log mais alto ou mais baixo, de acordo com sua preferência pessoal ou conforme solicitado pela equipe de suporte do Immich.
Configurações de Aprendizado de Máquina
Através desta configuração, você pode gerenciar todas as configurações relacionadas ao aprendizado de máquina no Immich, desde a configuração do aprendizado de máquina remoto até o modelo e seus parâmetros. Você pode optar por desabilitar um tipo específico de aprendizado de máquina, como pesquisa inteligente ou reconhecimento facial.
URL
O servidor incorporado (http://immich-machine-learning:3003) para aprendizado de máquina será configurado por padrão, mas você pode alterar isso ou adicionar servidores adicionais.
Hospedar o container immich-machine-learning em uma máquina com uma GPU mais poderosa pode ser útil para processar um grande número de fotos (como durante a importação em lote) ou para uma busca mais rápida.
Se mais de uma URL for fornecida, cada servidor será tentado, um por vez, até que um responda com sucesso, em ordem da primeira para a última. Servidores que não responderem serão temporariamente ignorados até voltarem a ficar online.
Pesquisa Inteligente
As configurações de pesquisa inteligente permitem modificar o modelo CLIP. Modelos maiores geralmente oferecem resultados de busca mais precisos, mas consomem mais poder de processamento e RAM. Ao alterar o modelo CLIP, é obrigatório executar novamente o trabalho de Pesquisa Inteligente em todas as imagens para aplicar totalmente a mudança.
Alterar modelos requer conexão com a Internet para baixar o modelo. Após o download, não é necessário que o Immich se conecte à rede, a menos que a verificação de versão tenha sido habilitada nas configurações.
Detecção de Duplicados
Use embeddings CLIP para encontrar possíveis duplicados. A distância máxima de detecção pode ser configurada para melhorar/reduzir o nível de precisão.
- Distância máxima de detecção - Distância máxima entre duas imagens para considerá-las duplicadas. O valor pode variar de 0.001 a 0.1. Valores mais altos detectam mais duplicados, mas podem resultar em falsos positivos.
Reconhecimento Facial
Nessas configurações, você pode alterar as configurações de reconhecimento facial. Configurações editáveis:
- Modelo de Reconhecimento Facial
- Pontuação Mínima de Detecção
- Distância Máxima de Reconhecimento
- Número Mínimo de Rostos Reconhecidos
Você pode saber mais sobre essas opções na página de Reconhecimento Facial.
Ao alterar os valores em Pontuação Mínima de Detecção, Distância Máxima de Reconhecimento e Número Mínimo de Rostos Reconhecidos, você terá que reiniciar apenas a tarefa de RECONHECIMENTO FACIAL - TODOS.
Se você substituir o Modelo de Reconhecimento Facial, será necessário executar a tarefa de DETECÇÃO FACIAL - TODOS.
Se você tiver gêmeos, pode ser útil reduzir um pouco o valor da Distância Máxima de Reconhecimento para diferenciá-los.
Configurações de Mapa e GPS
Configurações de Mapa
Nessas configurações, você pode alterar a aparência do mapa nos modos noturno e diurno, conforme suas preferências pessoais e as opções suportadas. O mapa pode ser ajustado via OpenMapTiles por exemplo.
Configurações de Geocodificação Reversa
O Immich suporta Geocodificação Reversa usando dados do banco de dados geográfico GeoNames.
Configurações de Notificação
Configuração do servidor SMTP, para notificações de criação de usuários, novos álbuns, etc. Mais informações podem ser encontradas aqui.
Modelos de Notificação
Substitua o texto padrão das notificações por modelos de notificação. Mais informações podem ser encontradas aqui.
Configurações do Servidor
Domínio Externo
Substitui o nome de domínio em links compartilhados e notificações por email. A URL não deve incluir uma barra no final.
Mensagem de Boas-vindas
O administrador pode definir uma mensagem personalizada na tela de login (a mensagem será exibida para todos os usuários).
Modelo de Armazenamento
O Immich suporta um Modelo de Armazenamento personalizado. Saiba mais sobre esse recurso e sua configuração aqui.
Configurações de Tema
Você pode escrever CSS personalizado que será carregado no aplicativo web para todos os usuários. Isso permite aos administradores alterar fontes, cores e outros estilos.
Por exemplo:
p {
color: green;
}
Configurações da Lixeira
Na opção do administrador do sistema, é possível configurar uma lixeira para arquivos excluídos. Esses arquivos permanecerão na lixeira até a data de exclusão de 30 dias (padrão) ou conforme definido pelo administrador do sistema.
A lixeira pode ser desativada, mas isso não é recomendado, pois arquivos futuros que forem excluídos serão deletados permanentemente.
Você pode selecionar ativos e pressionar Ctrl + Del a partir da linha do tempo para exclusão permanente rápida sem a opção da lixeira.
Configurações do Usuário
Atraso para exclusão
O administrador do sistema pode escolher deletar usuários através do painel de administração; o administrador pode apagar imediatamente ou, alternativamente, adiar a exclusão dos usuários (7 dias por padrão). Esta ação exclui permanentemente a conta e os ativos de um usuário. A tarefa de exclusão de usuários é executada à meia-noite para verificar os usuários prontos para exclusão. Alterações nesta configuração serão avaliadas na próxima execução.
Verificação de Versão
Quando esta opção está habilitada, o immich-server fará solicitações periódicas ao GitHub para verificar novas versões.
Configurações de Transcodificação de Vídeo
O administrador do sistema pode configurar quais arquivos de vídeo serão convertidos para diferentes formatos. As configurações podem ser alteradas em profundidade; para saber mais sobre a terminologia usada aqui, consulte a documentação do FFmpeg para o codec H.264, o codec HEVC e o codec VP9.
Quais streams de um arquivo de vídeo serão transcodificados é determinado pela Política de Transcodificação. Streams transcodificados usam as configurações a seguir (nome do arquivo de configuração entre parênteses). Streams que não são transcodificados permanecem inalterados e preservam suas configurações originais.
Contêineres aceitos (ffmpeg.acceptedContainers)
Se o formato contêiner do ativo de vídeo não estiver nesta lista, será reempacotado para MP4, mesmo que nenhum stream precise ser transcodificado.
O conjunto padrão de formatos de contêineres aceitos é mov, ogg e webm.
Predefinição (ffmpeg.preset)
A quantidade de "esforço computacional" para aplicar na transcodificação. Estas predefinições usam os nomes de predefinição do h264 e serão convertidas em valores apropriados para codificadores que configuram esforço de maneiras diferentes.
O valor padrão é ultrafast.
Codec de áudio (ffmpeg.targetAudioCodec)
Qual codec de áudio usar quando o stream de áudio estiver sendo transcodificado. Pode ser mp3, aac ou libopus.
O valor padrão é aac.
Codec de vídeo (ffmpeg.targetVideoCodec)
Qual codec de vídeo usar quando o stream de vídeo estiver sendo transcodificado. Pode ser h264, hevc, vp9 ou av1.
O valor padrão é h264.
Resolução alvo (ffmpeg.targetResolution)
Ao transcodificar um stream de vídeo, reduzir a maior dimensão para este valor, preservando a proporção. Vídeos nunca são ampliados.
O valor padrão é 720.
Política de transcodificação (ffmpeg.transcode)
A política de transcodificação configura quais streams de um ativo de vídeo serão transcodificados. A decisão de transcodificação é feita de forma independente para streams de vídeo e streams de áudio. Isso significa que, se um stream de vídeo precisar ser transcodificado e um stream de áudio não, o stream de vídeo será transcodificado, enquanto o stream de áudio será copiado. Se a política de transcodificação não exigir que nenhum stream seja transcodificado e não exigir que o vídeo seja reempacotado, então nenhum arquivo de vídeo separado será criado.
A política padrão é required.
Todos os vídeos (all)
Os vídeos são sempre transcodificados. Isso garante consistência durante a reprodução do vídeo.
Não transcodificar nenhum vídeo (disabled)
Os vídeos nunca são transcodificados. Isso economiza espaço e recursos no servidor, mas pode impedir a reprodução em dispositivos que não suportam o formato de origem (especialmente navegadores da web) ou resultar em alto uso de largura de banda durante a reprodução de arquivos com alta taxa de bits.
Apenas vídeos que não estão em um formato aceito (required)
Os streams de vídeo são transcodificados quando qualquer uma das seguintes condições é atendida:
- O vídeo é HDR.
- O vídeo não está no formato de pixel yuv420p.
- O codec de vídeo não está em
acceptedVideoCodecs.
O áudio é transcodificado se o codec de áudio não estiver em acceptedAudioCodecs.
Vídeos com taxa de bits acima do máximo ou que não estão em um formato aceito (bitrate)
Além das condições em required, os streams de vídeo também são transcodificados se sua taxa de bits estiver acima de maxBitrate.
Vídeos com resolução maior que a resolução alvo ou que não estão em um formato aceito (optimal)
Além das condições em required, os streams de vídeo também são transcodificados se as dimensões horizontais e verticais forem maiores que targetResolution.