Apresentação de Immich
Alternativa open source ao Google Fotos, o Immich faz o backup automático das fotos e vídeos dos seus celulares para um servidor que você controla. Ele oferece linha do tempo, álbuns compartilhados, busca por conteúdo, reconhecimento de rostos e um mapa dos locais onde as fotos foram tiradas. É usado por quem quer tirar suas memórias de uma nuvem americana, mas também por famílias, pequenas equipes e fotógrafos que precisam de uma biblioteca centralizada.
Na entrega, o script de cloud-init já instalou o Docker Engine e o plugin Compose a partir do repositório oficial do Docker, e baixou o arquivo docker-compose.yml e o exemplo .env da versão mais recente do Immich em /opt/immich. Uma senha aleatória foi gerada para o banco de dados, e os contêineres foram iniciados. A interface web escuta na porta 2283.
Nenhuma conta de administrador é criada previamente: o primeiro usuário registrado se torna administrador. As informações úteis (URL, caminhos, senha do banco) estão em /tmp/credentials.txt, legível apenas pelo root.
O que pode fazer com Immich
Backup automático pelo celular
Os aplicativos para iOS e Android enviam fotos e vídeos ao seu servidor em segundo plano. Você escolhe quais álbuns sincronizar.
Busca inteligente e rostos
O Immich indexa o conteúdo das imagens para encontrar uma foto por descrição e agrupa os rostos por pessoa. Esse processamento roda no seu servidor, não em um terceiro.
Álbuns e compartilhamento sob controle
Crie álbuns compartilhados com outros usuários ou links públicos. Cada membro da família tem sua própria conta e sua própria biblioteca.
Stack oficial via Docker Compose
A instalação usa os arquivos publicados com a versão mais recente do Immich, em
/opt/immich. A atualização se faz com dois comandos do Compose.Dados em pastas simples
A biblioteca fica em
/opt/immich/librarye o banco PostgreSQL em/opt/immich/postgres. Fazer backup ou migrar se resume a copiar duas pastas.Primeira conta de administrador segura
Nenhuma credencial padrão é criada. O primeiro usuário cadastrado se torna administrador, o que evita uma conta conhecida por todos em um servidor exposto.
Começar com Immich
Da encomenda à produção em poucos minutos.
- 1
Peça o VPS com o Immich
Escolha um VPS Linux (Debian 12 ou 13, Ubuntu 22.04 ou 24.04) em Paris ou Frankfurt e marque o Immich na aba Aplicativos do formulário de pedido. Reserve espaço em disco suficiente para a sua biblioteca e pelo menos 6 GB de RAM para a busca inteligente.
- 2
Conecte-se e consulte as informações
Quando o servidor for entregue, conecte-se por SSH. A instalação baixa imagens Docker e pode levar alguns minutos; acompanhe pelo log, depois leia o arquivo de informações e copie-o para o seu gerenciador de senhas, pois ele fica em /tmp.
Bashssh USER@SERVER_IP tail -n 20 /var/log/immich-auto-install.log sudo cat /tmp/credentials.txt - 3
Crie a conta de administrador
Abra http://SERVER_IP:2283 no navegador e siga o assistente de boas-vindas. O primeiro usuário registrado recebe os direitos de administrador. Depois, instale o aplicativo móvel e informe a URL do servidor para ativar o backup.
- 4
Proteja o servidor antes do uso real
Aponte um registro DNS A de YOUR_DOMAIN para SERVER_IP, coloque um reverse proxy HTTPS na frente da porta 2283 e limite as portas abertas. Programe também um backup regular de /opt/immich/library e /opt/immich/postgres.
Bashsudo ufw allow OpenSSH sudo ufw allow 80,443/tcp sudo ufw enable
Casos de uso de Immich
Substituir Google Fotos ou iCloud
Você importa a biblioteca existente e ativa o backup automático nos celulares. Suas fotos ficam em um servidor hospedado na Europa, em Paris ou Frankfurt.
Fototeca compartilhada em família
Cada pessoa tem sua conta, seus álbuns e seu backup móvel. Os álbuns comuns reúnem as fotos de viagem sem depender de aplicativos de mensagem.
Arquivo para fotógrafos amadores
Você centraliza as exportações da câmera em uma única linha do tempo consultável. A busca e a organização por pessoas ou lugares encontram uma foto em poucos segundos.
Ambiente de testes para self-hosting
Você avalia o Immich antes de migrar uma biblioteca grande, ou aprende a operar uma stack Docker Compose com PostgreSQL. O servidor é descartável e reproduzível.
Perguntas frequentes sobre Immich
A documentação do Immich recomenda pelo menos 6 GB de RAM e 2 núcleos, sendo preferíveis 4 núcleos. A busca inteligente e o reconhecimento facial consomem bastante, principalmente na importação inicial de uma biblioteca grande. Dimensione também o disco conforme o volume das suas fotos e vídeos.
Mais sobre Immich
O que está instalado no servidor
Tudo fica em /opt/immich: o docker-compose.yml, o arquivo .env (permissões 600, pois contém a senha do banco), a pasta library para as fotos e postgres para os dados do banco. O log de instalação está em /var/log/immich-auto-install.log.
Os comandos do Compose são executados a partir dessa pasta:
Bashcd /opt/immich docker compose ps docker compose logs -f immich-server
Ativar HTTPS com um reverse proxy
O serviço responde em HTTP simples na porta 2283. Antes de conectar seus celulares a ele pela internet, coloque-o atrás de um reverse proxy (Caddy, Nginx ou Traefik) que obtenha um certificado para YOUR_DOMAIN. Com o Caddy, a configuração cabe em poucas linhas:
YOUR_DOMAIN {
reverse_proxy 127.0.0.1:2283
}
Com o Nginx, lembre-se de aumentar client_max_body_size, caso contrário o envio de vídeos grandes falhará.
Outro ponto importante: o Docker publica as portas ignorando as regras do UFW. Para que a 2283 deixe de ser acessível diretamente depois que o proxy estiver no ar, altere a linha ports do serviço immich-server no docker-compose.yml para escutar em 127.0.0.1:2283 e reinicie com docker compose up -d.
Backups
É preciso fazer backup da biblioteca e do banco juntos: um sem o outro não permite uma restauração correta. O método mais simples é parar os contêineres, copiar as duas pastas para um armazenamento externo e reiniciar.
Bashcd /opt/immich docker compose stop tar -czf /root/immich-backup.tar.gz library postgres .env docker compose start
Para uma biblioteca grande, prefira o rsync para outra máquina e teste uma restauração pelo menos uma vez. Um backup no mesmo disco do servidor não protege contra a falha desse disco.
Atualizações
Os arquivos baixados correspondem à versão publicada no momento da entrega. Para passar a uma versão mais recente, leia antes as notas de versão do projeto, pois o Immich evolui rápido e algumas versões exigem uma ação manual. Depois:
Bashcd /opt/immich docker compose pull docker compose up -d
Faça um backup antes de cada atualização major. Para outros tutoriais sobre administração de VPS, consulte a seção Learn; as ofertas estão detalhadas na página de VPS Linux.
