O que é o Immich

O Immich é uma plataforma open source de gerenciamento de fotos e vídeos feita para rodar no seu próprio servidor. A proposta é direta: oferecer a experiência do Google Fotos, com backup automático do celular, linha do tempo e busca inteligente, mas com os arquivos guardados em hardware que você controla.

O projeto foi criado em 2022 pelo desenvolvedor Alex Tran, que queria uma alternativa real ao Google Fotos depois que o serviço acabou com o armazenamento ilimitado gratuito. Em 2024 o Immich passou a ser mantido com apoio da FUTO, organização que financia software de código aberto, e a equipe principal passou a trabalhar no projeto em tempo integral.

Depois de anos como um dos repositórios que mais cresciam no GitHub, com dezenas de milhares de stars, o projeto lançou sua primeira versão estável no fim de 2025. Agora, em julho de 2026, a chegada do Immich 3.0 levou o projeto de novo ao topo do Hacker News, com centenas de votos e uma discussão enorme sobre self-hosting de fotos.

Como funciona

A arquitetura do Immich é composta por alguns serviços que rodam juntos, normalmente via Docker Compose. O servidor principal é escrito em TypeScript, os dados ficam em um banco PostgreSQL e um serviço separado de machine learning cuida da parte inteligente: reconhecimento facial e busca por conteúdo.

A busca inteligente usa modelos do tipo CLIP, que transformam cada imagem em um vetor numérico. Quando você digita "cachorro na praia", o texto também vira um vetor, e o banco encontra as fotos mais próximas dele. Tudo isso acontece localmente, sem enviar nenhuma imagem para serviços externos.

Uma analogia ajuda: o Google Fotos é um prédio alugado onde o sindico pode mudar as regras quando quiser. O Immich é a casa própria: dá mais trabalho de manutenção, mas ninguém muda o preço do aluguel, encerra o serviço ou treina modelos com as suas fotos de família.

No celular, o aplicativo oficial para iOS e Android faz o mesmo papel do app do Google Fotos: mostra a galeria, faz upload automático das fotos novas e permite liberar espaço no aparelho depois que tudo está seguro no servidor.

Principais recursos

O conjunto de recursos do Immich é o que mais impressiona quem vem de outras soluções self-hosted. Os destaques:

  • Backup automático do celular: apps nativos para iOS e Android com upload em segundo plano, incluindo álbuns selecionados;
  • Busca com IA: busca por conteúdo da imagem em linguagem natural, sem depender de tags manuais;
  • Reconhecimento facial: agrupa fotos por pessoa e permite nomear cada rosto;
  • Linha do tempo e memórias: navegação por data com relembranças de anos anteriores;
  • Mapa: fotos com GPS aparecem em um mapa interativo;
  • Álbuns compartilhados e parceiro: compartilhamento com outros usuários do servidor, incluindo o modo parceiro para casais;
  • Suporte a RAW e vídeos: formatos de câmeras dedicadas e transcodificação de vídeo com ffmpeg;
  • Multiusuário com cotas: cada pessoa da família tem sua conta, com limite de espaço opcional.

O diferencial em relação a outras galerias self-hosted é o foco na experiência mobile. A maioria dos concorrentes trata o celular como cidadão de segunda classe. No Immich, o app é o centro do produto, o que faz diferença enorme na adoção pela família.

Outro ponto forte é o ritmo de desenvolvimento. O projeto tem lançamentos frequentes, changelog detalhado e uma comunidade muito ativa no GitHub e no Discord, o que dá confiança para quem vai investir tempo na instalação.

Como começar: instalação passo a passo

O caminho recomendado é o Docker Compose. Você precisa de uma máquina com Docker instalado: um servidor Linux, um mini PC em casa ou um NAS que rode containers.

O passo a passo básico:

  • Passo 1: crie uma pasta para o projeto, por exemplo mkdir immich && cd immich;
  • Passo 2: baixe o arquivo Docker-compose.yml e o arquivo de exemplo .env do repositório oficial do Immich no GitHub;
  • Passo 3: edite o .env e defina UPLOAD_LOCATION, a pasta onde as fotos serão gravadas, e a senha do banco;
  • Passo 4: suba tudo com Docker compose up -d;
  • Passo 5: acesse a interface web na porta 2283, crie a conta de administrador e instale o app no celular apontando para o endereço do servidor.

Os requisitos mínimos são modestos para uma biblioteca pequena, mas a recomendação prática é ter pelo menos 4 GB de RAM, já que o serviço de machine learning consome memória ao indexar as fotos. O espaço em disco depende só do tamanho da sua biblioteca.

Para acessar de fora de casa, as opções mais comuns são uma VPN como Tailscale ou WireGuard, ou um proxy reverso com HTTPS. Expor a porta diretamente na internet sem proteção não é recomendado.

Exemplo prático

Imagine migrar uma biblioteca de 50 mil fotos do Google Fotos para o Immich. O primeiro passo é exportar tudo pelo Google Takeout, que gera arquivos zip com as imagens e metadados em JSON.

Com o servidor no ar, existem ferramentas da comunidade que leem o formato do Takeout e enviam tudo para o Immich preservando datas, descrições e álbuns. Para uploads em massa também existe a CLI oficial, que percorre pastas locais e envia os arquivos direto para a sua conta.

Depois do upload, o serviço de machine learning começa a indexar em segundo plano: gera miniaturas, extrai vetores para busca e agrupa rostos. Em uma máquina modesta isso pode levar horas ou dias para bibliotecas grandes, mas acontece uma vez só. No fim, você digita "bolo de aniversário" na busca e as fotos certas aparecem, como no Google Fotos.

Comparação com alternativas

O Immich não é a única opção para quem quer sair do Google Fotos. As alternativas principais são o PhotoPrism, o Nextcloud com o app Memories e o Ente.

O PhotoPrism é maduro e tem busca boa, mas o backup automático do celular depende de apps de terceiros. O Nextcloud faz sentido para quem já usa a plataforma para arquivos e agenda, embora a experiência de fotos seja menos polida. O Ente é open source com criptografia de ponta a ponta e oferece tanto plano pago hospedado quanto self-hosting, sendo a escolha de quem prioriza criptografia acima de tudo.

Quando usar cada um: Immich para quem quer a experiência mais próxima do Google Fotos com apps móveis de primeira linha; PhotoPrism para catalogar grandes acervos em desktop; Nextcloud para quem quer uma suite completa; Ente para quem não abre mão de criptografia de ponta a ponta.

O ponto forte único do Immich é o conjunto: app mobile excelente, busca com IA local e ritmo de desenvolvimento acelerado, tudo gratuito e open source sob licença AGPL.

Pontos positivos e limitações

Entre os pontos positivos, o mais citado pelos usuários é a qualidade do aplicativo mobile, que não deixa nada a dever aos serviços comerciais. A busca com IA rodando local, o reconhecimento facial e a interface web rápida completam o pacote. E o custo é imbatível: zero mensalidade, para qualquer tamanho de biblioteca.

As limitações são as de todo self-hosting. Você vira o responsável pela disponibilidade e, principalmente, pelo backup. O Immich guarda as fotos no seu servidor, mas se o disco morrer sem uma cópia externa, as fotos morrem junto. A regra 3-2-1 de backup deixa de ser teoria e vira obrigação.

Também vale citar o consumo de recursos do machine learning em máquinas fracas, a curva de aprendizado com Docker para quem nunca usou containers e o fato de que atualizações de versão maior podem exigir passos manuais de migração. Nada disso é impeditivo, mas é bom saber antes de migrar a biblioteca da família inteira.

Casos de uso reais

O perfil mais óbvio é o desenvolvedor com homelab: já tem um servidor em casa, roda outros serviços em Docker e quer parar de pagar mensalidade por armazenamento de fotos. Para esse público, a instalação é trivial.

O segundo perfil é a família preocupada com privacidade. Com o modo multiusuário e o compartilhamento com parceiro, um único servidor atende todo mundo, e as fotos das crianças ficam fora das nuvens de big techs.

O terceiro é o fotógrafo amador ou profissional com acervo grande em RAW. Armazenar terabytes no Google Fotos ou iCloud custa caro todo mês; um disco local de 4 TB resolve por um custo único.

Por fim, tem o pequeno estúdio ou agência que precisa centralizar fotos de eventos e produções com controle de acesso por usuário, sem depender de plano corporativo de nuvem.

Dicas e boas práticas

A dica número um de quem já usa: configure o backup do próprio servidor antes de migrar tudo. Um snapshot do banco PostgreSQL mais uma cópia da pasta de uploads em outro disco ou em storage externo. Só depois desative o backup antigo.

Erros comuns de iniciantes incluem expor a porta do Immich direto na internet sem HTTPS, esquecer de fixar a versão da imagem Docker e atualizar sem ler as notas de lançamento. O projeto avisa quando uma atualização tem passos manuais, mas só ajuda quem lê o changelog.

Boas práticas recomendadas pela comunidade: usar Tailscale ou WireGuard para acesso remoto, ativar as cotas por usuário desde o início, apontar bibliotecas externas somente para pastas que o Immich não gerência e testar a restauração do backup de tempos em tempos. Backup que nunca foi restaurado é só uma esperança.

Vale a pena?

Para quem já tem um servidor em casa ou não tem medo de Docker, o Immich é hoje a resposta mais completa para sair do Google Fotos. A versão 3.0 chega com o projeto maduro, estável e com uma comunidade gigante por trás.

Para quem não quer administrar servidor nenhum, a resposta honesta é não. Nesse caso, um serviço gerenciado com criptografia, como o Ente, ou até continuar no Google Fotos pagando o plano, pode fazer mais sentido do que manter uma máquina ligada em casa.

O próximo passo natural é testar sem compromisso: suba o Immich com Docker Compose em qualquer máquina, instale o app no celular e faça backup de um álbum pequeno. Em uma tarde você descobre se o self-hosting de fotos é para você.