Arte conceitual 3D de nuvem privada para fotos self-hosted com Immich e Docker

Immich no Docker: O Guia Definitivo para Substituir o Google Fotos no seu Servidor Próprio

Por

Durante anos, o Google Fotos foi a solução padrão da maioria dos usuários para armazenar memórias, sincronizar fotos de viagens e organizar a galeria do smartphone. Contudo, desde o fim do armazenamento ilimitado e gratuito, os usuários se viram encurralados pelo limite dos 15 GB compartilhados com Gmail e Google Drive, sendo forçados a pagar mensalidades perpétuas no plano Google One para não terem o recebimento de e-mails bloqueado.

Além do custo recorrente, há a questão crítica da privacidade digital: entregar fotos íntimas de família, recibos e documentos pessoais para os algoritmos de varredura de dados de gigantes da tecnologia é algo que cada vez mais entusiastas de tecnologia evitam. É nesse cenário que o Immich se consolidou como o projeto open source mais impressionante e revolucionário do ecossistema self-hosted moderno.

O Immich não é apenas uma galeria web simples: ele replica praticamente todas as funções avançadas do Google Fotos, incluindo aplicativo nativo para Android e iOS com sincronização em segundo plano, reconhecimento facial por inteligência artificial local, busca semântica por texto, mapas interativos de GPS e suporte total a Live Photos da Apple e fotos em formato RAW.

A Arquitetura do Immich

Para entregar velocidade instantânea mesmo com bibliotecas contendo centenas de milhares de fotos, o Immich é estruturado em microsserviços modernos:

  • immich-server: A API backend e o servidor central que gerencia autenticação, metadados e serve a interface web.
  • immich-machine-learning: O contêiner de IA que executa modelos de redes neurais locais (CLIP e facial recognition) para reconhecimento de rostos e busca semântica inteligente, sem enviar um único byte para a internet externa.
  • PostgreSQL com extensão PGVector: O banco de dados relacional turbinado com busca vetorial de alta dimensionalidade para cruzar rostos e consultas inteligentes em milissegundos.
  • Redis: Sistema de mensageria em memória ultrarrápido para gerenciar a fila de transcodificação de vídeos e geração de miniaturas.

Passo 1: Preparar o Diretório e Baixar os Arquivos Oficiais

No seu servidor Linux ou máquina homelab (com Docker e Docker Compose instalados), crie uma pasta exclusiva para o Immich:

mkdir -p /opt/immich && cd /opt/immich

Baixe os arquivos oficiais de orquestração do projeto mantidos no repositório do GitHub:

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

Passo 2: Configurar o Arquivo de Variáveis de Ambiente (`.env`)

Abra o arquivo .env com o seu editor preferido (nano .env) e ajuste os parâmetros fundamentais:

# Caminho onde as fotos originais e miniaturas serão gravadas
# (Recomendado apontar para o seu HD maior ou storage array)
UPLOAD_LOCATION=/mnt/storage/fotos_immich

# Caminho para os dados do banco de dados relacional
DB_DATA_LOCATION=./postgres

# Versão do Immich (release para estabilidade)
IMMICH_VERSION=release

# Gere uma senha longa e segura para o PostgreSQL
DB_PASSWORD=SuaSenhaForteSeguraDoBanco123!

Passo 3: Aceleração de Hardware para Vídeos (Opcional, mas Altamente Recomendado)

Vídeos gravados em celulares modernos frequentemente usam os codecs HEVC (H.265) ou AV1 em 4K a 60 FPS. Quando você visualiza esses vídeos no navegador, o servidor precisa transcodificá-los para um formato compatível.

Para evitar que a CPU do servidor vá a 100% durante a transcodificação, você pode repassar a GPU integrada Intel (usando QuickSync via /dev/dri) diretamente no docker-compose.yml no serviço immich-server:

devices:
  - /dev/dri:/dev/dri

Passo 4: Subindo a Stack com Docker Compose

Com as configurações salvas, inicie todos os contêineres em segundo plano:

docker compose up -d

Acompanhe o download das imagens e a inicialização dos serviços com docker compose logs -f. Em cerca de um minuto, o sistema estará pronto para receber acessos.

Passo 5: Primeiro Acesso e Configuração do Aplicativo Móvel

  1. Abra seu navegador e digite o IP do servidor na porta padrão: http://IP_DO_SERVIDOR:2283.
  2. A tela de boas-vindas solicitará a criação da conta de Administrador (nome, e-mail e senha).
  3. Após o login, você terá acesso à interface visual completa com visualizador de linha do tempo e mapa global.
  4. No seu celular (Android ou iPhone), baixe o aplicativo Immich na Play Store ou App Store.
  5. Ao abrir o app, insira a URL do servidor (se estiver fora de casa, utilize a conexão via Tailscale ou seu domínio com proxy reverso seguro HTTPS).
  6. Autorize o acesso à biblioteca de fotos do aparelho e selecione quais álbuns devem ser sincronizados automaticamente.

A Mágica da Busca por Inteligência Artificial Local

Depois que as primeiras fotos forem carregadas, o contêiner de Machine Learning começará a indexar sua galeria em segundo plano. Você poderá ir na barra de pesquisa e buscar termos naturais em português ou inglês como “praia ao pôr do sol”, “gato preto dormindo”, “nota fiscal de supermercado” ou clicar no rosto de uma pessoa específica para ver todas as fotos onde ela aparece através dos anos.

Conclusão

O Immich provou que é possível ter a conveniência de ponta do Google Fotos sem abrir mão da posse dos seus dados e sem pagar taxas mensais abusivas de armazenamento em nuvem. É a solução soberana e indispensável para a sua vida digital em 2026.