É possível configurar o Immich para usar um serviço PostgreSQL externo, mas isso não torna as atualizações automaticamente seguras; transfere para fora da stack predefinida a responsabilidade pela versão da base de dados, pelas extensões, pelos privilégios, pelas cópias de segurança e pelo restauro.
Considere uma base de dados externa um limite avançado de compatibilidade, não uma simples opção de desempenho. Antes de cada atualização do Immich ou do PostgreSQL, verifique os requisitos da versão exata do Immich que pretende executar, confirme que o servidor externo pode fornecer as extensões e os privilégios necessários, faça uma cópia de segurança que possa ser restaurada e altere apenas uma camada de atualização de cada vez, para saber qual foi o componente que causou uma falha.
Comece pelo contrato da base de dados externa
Documente o ponto de ligação à base de dados, o nome da base de dados, a conta de serviço, o modo TLS, a versão principal do PostgreSQL, os nomes e as versões das extensões instaladas e quem pode atualizá-las. Guarde este registo junto da definição da implementação do Immich para que a recriação de um contentor não o volte a ligar silenciosamente a outro servidor ou base de dados.
É possível usar um servidor PostgreSQL preexistente, mas esta não é a configuração predefinida recomendada para o Immich. Nas versões atuais, a utilização de uma base de dados autónoma requer pgvector e VectorChord; sabe-se que o Immich funciona com PostgreSQL 14 a 19, pgvector >=0.7 e <0.9, e VectorChord >=0.3 e <2.0. Volte a verificar estes intervalos antes de cada atualização, porque podem mudar.
Planeie os privilégios antes da transição. O Immich espera normalmente uma função de base de dados com permissões de superutilizador; a execução sem esses privilégios é uma opção avançada que pode exigir intervenção manual durante as atualizações, e as cópias de segurança automatizadas atuais da base de dados exigem permissões de superutilizador. Se o seu fornecedor externo não conseguir satisfazer estes requisitos, pare antes de migrar os dados de produção.
Verifique a compatibilidade do PostgreSQL e das extensões antes de alterar o que quer que seja
Indique as versões atuais e de destino do PostgreSQL, juntamente com todas as extensões de que o Immich depende. Uma atualização principal do PostgreSQL pode exigir ficheiros binários das extensões compilados para a versão principal de destino, enquanto uma atualização do Immich pode exigir uma extensão mais recente ou um comportamento de migração diferente, mesmo que o próprio PostgreSQL continue a arrancar.
Os ficheiros dos pacotes das extensões e o estado das extensões em SQL têm de ser migrados deliberadamente com a base de dados, em vez de se assumir que acompanham uma atualização do PostgreSQL. Consulte Dependências de atualização das extensões do PostgreSQL antes de alterar a versão principal da base de dados ou os pacotes das extensões de que o Immich precisa.
Se o seu fornecedor externo não permitir instalar ou atualizar a extensão necessária, alterar as definições de pré-carregamento partilhadas, quando necessário, ou conceder os privilégios de que a migração precisa, pare antes de atualizar o Immich. Uma base de dados que aceita consultas comuns pode continuar a não ser adequada para a próxima migração da aplicação.
Mantenha as atualizações principais da base de dados separadas das atualizações do Immich
Evite combinar uma atualização para uma nova versão principal do PostgreSQL, uma atualização de extensões e uma atualização da aplicação Immich na mesma operação de manutenção, a menos que já tenha ensaiado toda a sequência. Quando várias fronteiras de compatibilidade mudam ao mesmo tempo, uma falha no arranque deixa de indicar que camada a causou.
As atualizações secundárias do PostgreSQL e as atualizações para uma nova versão principal são operações de manutenção diferentes. As atualizações para uma nova versão principal exigem que o ambiente de destino, incluindo as extensões de terceiros, seja preparado com antecedência. Sempre que possível, mantenha as atualizações para uma nova versão principal do PostgreSQL separadas de uma atualização da aplicação Immich, para que, se o arranque falhar, haja uma única alteração a investigar.
Para um servidor doméstico, a sequência de menor risco costuma ser: criar cópias de segurança, verificar um restauro, atualizar uma camada, executar a validação e, depois, prosseguir. Se uma versão do Immich exigir uma alteração à base de dados, siga a ordem indicada para essa versão, em vez de aplicar uma receita genérica de atualização do PostgreSQL.
Preserve um caminho de reversão que abranja a base de dados e os ficheiros multimédia
Com uma base de dados externa, é fácil esquecer que o estado do Immich está dividido entre o PostgreSQL e a biblioteca multimédia. Faça uma cópia de segurança da base de dados com um método que garanta a sua consistência e preserve o estado relevante dos ficheiros multimédia e da configuração dentro da mesma janela de recuperação, antes de uma migração que possa alterar esquemas ou metadados dos elementos.
O estado da base de dados, os ficheiros da aplicação, a configuração e os carregamentos têm de ser coerentes no momento do restauro. Utilize uma cópia de segurança consistente do contentor da base de dados como modelo de aceitação, e não se limite a verificar se o PostgreSQL arranca.
Não considere a reversão pronta até saber o que acontece a ambos os lados se a migração da aplicação for concluída parcialmente. Mantenha disponíveis a versão antiga da aplicação, a definição da implementação, a cópia de segurança da base de dados e o estado dos ficheiros multimédia durante tempo suficiente para recuperar sem substituir o único estado comprovadamente funcional por um estado mais recente.
Valide a atualização como aplicação, não apenas como ligação à base de dados
Após a alteração, confirme que o PostgreSQL aceita a função do Immich prevista, que as extensões necessárias estão presentes nas versões esperadas e que a migração do Immich é concluída sem erros repetidos na base de dados. Uma ligação TCP bem-sucedida ou um `SELECT 1` comprova a conectividade, não a compatibilidade da aplicação.
Depois, utilize o Immich normalmente: carregue álbuns antigos, abra algumas fotografias e vídeos representativos, pesquise, verifique os utilizadores ou a partilha, se for relevante, e carregue um ficheiro descartável. Durante estas ações, observe os registos da aplicação e da base de dados para detetar extensões em falta, erros de permissões, falhas de migração ou tentativas repetidas.
Só depois de a aplicação passar essas verificações deve retomar a retenção normal das cópias de segurança e eliminar a cópia de reversão. Se a base de dados externa fizer com que as atualizações de rotina do Immich dependam repetidamente de tarefas manuais relacionadas com extensões ou privilégios, que não consegue ensaiar de forma fiável, o ciclo de vida predefinido da base de dados dedicada é a opção operacional mais segura.
Assistência e dicas
Mais para ler

Como manter vídeos para adultos no seu NAS ocultos dos membros da família
Mantenha os vídeos para adultos privados num NAS familiar. Verifique as permissões das pastas, o acesso às bibliotecas do Plex e do Jellyfin, as...

O que verificar antes de carregar um modelo da comunidade em Transformers
Utilize a atualização da sandbox Jinja do Transformers para rever a proveniência dos modelos, os modelos de chat, o código remoto, os pesos serializados...

Execute o Mirage localmente: OCR e deteção de objetos a partir de uma imagem
Experimente o pequeno modelo de visão local da Cactus Compute, valide o OCR e a extração de objetos com dados reais e compreenda os...



