Instalação Immich com Docker - Método mais rápido

Verifique o que você precisa primeiro

Immich é uma plataforma auto-hospedada de backup de fotos e vídeos — gratuita e de código aberto — e a forma oficial de executá-la é o Docker Compose em um servidor Linux, um PC antigo, um mini PC ou um NAS compatível com Docker. A máquina deve permanecer ligada: um laptop que dorme todas as noites é um servidor de fotos ruim. O armazenamento é o que faltará primeiro, então planeje espaço para sua biblioteca de fotos completa e mais cerca de 10 a 20 por cento extra para miniaturas e vídeos transcodificados.

Cerca de 4 GB de RAM é o mínimo prático; o contêiner de aprendizado de máquina é a parte mais faminta, então 6 a 8 GB é visivelmente mais feliz. Confirme se o Docker e o Docker Compose estão instalados e funcionando:

docker compose version

Crie a pasta e baixe os dois arquivos oficiais

Nunca copie um arquivo docker-compose aleatório de uma postagem de blog ou fórum — as versões mudam e o arquivo de um estranho pode fixá-lo em uma compilação antiga. Os arquivos oficiais sempre ficam na página de lançamento do projeto no GitHub. Crie a pasta e vá para ela:

mkdir ./immich-app
cd ./immich-app

Baixe o arquivo de composição e o modelo de ambiente:

wget -O docker-compose.yml https://github.com/immich-app/immich/releases/latest/download/docker-compose.yml
wget -O .env https://github.com/immich-app/immich/releases/latest/download/example.env

Edite o arquivo .env — a única configuração que importa

O arquivo .env contém alguns valores que Immich não consegue adivinhar. Abra:

nano .env

Defina UPLOAD_LOCATION=./library — onde suas fotos e vídeos originais ficarão; aponte-o para o seu disco maior e mais confiável. Defina DB_DATA_LOCATION=./postgres para o banco de dados e altere DB_PASSWORD para uma senha longa e aleatória. Remova o comentário de TZ e defina seu fuso horário (por exemplo, Ásia/Calcutá) para que as datas das fotos e os trabalhos agendados se alinhem. Deixe IMMICH_VERSION e tudo abaixo da linha marcada para uma primeira instalação.

Iniciar a pilha

Um comando inicia tudo. O Docker baixa as imagens do contêiner e as inicia juntas; a primeira execução leva alguns minutos dependendo da velocidade da sua internet:

docker compose up -d
docker compose ps

O segundo comando verifica se tudo apareceu — você deverá ver o servidor, o aprendizado de máquina, o banco de dados e os contêineres Redis em execução.

Abra o Immich e crie a conta de administrador

Abra o Immich em um navegador na mesma rede — ele responde na porta 2283:

http://YOUR-SERVER-IP:2283

Clique na tela de boas-vindas e registre-se. A primeira conta criada torna-se o administrador – portanto, execute esta etapa imediatamente, antes que qualquer outra pessoa na sua rede encontre a página. Em seguida, instale o aplicativo gratuito Immich em seu telefone, faça login com o mesmo endereço de servidor e ative o backup automático.

Conheça os quatro contêineres e as regras

O arquivo de composição é executado por uma pequena equipe, não por um único programa: immich-server é o cérebro — interface web, API, uploads, álbuns e pesquisa; immich-machine-learning são os olhos – detecção de rosto, reconhecimento de rosto e pesquisa inteligente; o banco de dados PostgreSQL é a memória – o nome de cada foto, data, álbum e dados de rosto ficam lá, enquanto os originais são arquivos; e Redis é o mensageiro que passa trabalhos entre o servidor e os trabalhadores em segundo plano. Conhecer essa divisão é importante mais tarde: se a pesquisa falhar, você verifica o aprendizado de máquina; se as fotos desaparecerem da linha do tempo, mas os arquivos ainda estiverem no disco, verifique o banco de dados.