Base de Conhecimento

Immich na VPS: suas fotos e vídeos no seu servidor

  • immich, vps, docker, docker compose, fotos, backup
  • Usuários acharam útil: 0

Instale o Immich v3.3.5 numa VPS com Docker Compose, configure o .env, ligue o app do celular, publique com HTTPS e saiba como fazer o backup e atualizar.

Por Redação Eleven Host · @robson.direitodigital · 3 de novembro de 2026 · 10 min de leitura

Arte da Eleven Host: janela de terminal com o título: Immich na VPS: suas fotos e vídeos no seu servidor

Capa da Redação Eleven Host para o guia: Immich na VPS: suas fotos e vídeos no seu servidor Arte: Eleven Host

O Immich na VPS é uma forma de ter a sua própria solução de fotos e vídeos, rodando em Docker no seu servidor. Vamos instalar o Immich v3.3.5, a release marcada como "Latest" no GitHub em outubro de 2026, com o Docker Compose.

Se você ainda está conhecendo o assunto de servidores, comece pelo guia de servidor VPS para iniciantes. Os comandos abaixo seguem a documentação oficial do Immich e os arquivos da v3.3.5 no GitHub, com a versão fixada.

O que é o Immich e qual é a licença

A descrição oficial do projeto é "High performance self-hosted photo and video management solution", ou seja, uma solução de gerenciamento de fotos e vídeos de alto desempenho para hospedar por conta própria.

A licença é a GNU AGPL v3. Segundo a nota da release, a versão 2.0.0 marcou a primeira versão estável do Immich.

Segundo a documentação, o Immich está disponível como código aberto sob os termos da licença GNU AGPL v3.

Requisitos oficiais do Immich

Segundo a documentação do Immich, estes são os pontos principais:

  • Sistema: Linux de 64 bits, como Ubuntu ou Debian. Máquinas virtuais completas funcionam bem. Sobre Docker dentro de contêineres LXC, a documentação diz que o uso "is not recommended";
  • Docker: Docker Engine com o plugin Compose. O antigo docker-compose está descontinuado e não é mais suportado pelo Immich;
  • Memória: mínimo de 6GB, com 8GB como valor recomendado. Com 4GB, dá para rodar com o machine learning desligado;
  • Processador: mínimo de 2 núcleos, com 4 como valor recomendado, nas arquiteturas amd64 e arm64. Desde a v3, o contêiner de machine learning em amd64 exige a microarquitetura x86-64-v2 ou superior;
  • Disco: sistema de arquivos compatível com Unix. A geração de miniaturas e de vídeos transcodificados pode aumentar o tamanho da biblioteca em 10 a 20% em média.

O banco Postgres do Immich tem a pasta definida por DB_DATA_LOCATION. A documentação pede de preferência um SSD local e diz "never a network share of any kind": o banco não deve ficar em compartilhamento de rede.

Seu servidor virtual já está escolhido? VPS a partir de R$ 17,00/mês no Plano Bronze; confira na loja o que cada plano inclui. Ver as VPS

Passo 1: baixar o docker-compose.yml e o .env

Com o Docker Engine e o plugin Compose instalados (siga a documentação do Docker para o seu sistema), crie uma pasta para o Immich:

mkdir ./immich-app

cd ./immich-app

Depois, baixe os dois arquivos da release. A documentação usa o endereço latest; para fixar a versão, um exemplo é trocar latest por v3.3.5:

wget -O docker-compose.yml https://github.com/immich-app/immich/releases/download/v3.3.5/docker-compose.yml

wget -O .env https://github.com/immich-app/immich/releases/download/v3.3.5/example.env

O próprio arquivo avisa, em comentário, para usar o docker-compose.yml da release atual: o arquivo da branch principal pode não ser compatível com a última release. Existe também a v3.4.0-rc.1, que o GitHub marca como pré-lançamento, e por isso ela não é usada aqui.

Passo 2: editar o arquivo .env

O example.env da v3.3.5 traz estas linhas:

UPLOAD_LOCATION=./library

DB_DATA_LOCATION=./postgres

# TZ=Etc/UTC

IMMICH_VERSION=v3

DB_PASSWORD=postgres

DB_USERNAME=postgres

DB_DATABASE_NAME=immich

  • UPLOAD_LOCATION é onde ficam os arquivos enviados. A documentação sugere uma pasta nova, com espaço livre suficiente;
  • DB_DATA_LOCATION é onde ficam os arquivos do banco, e o arquivo avisa que compartilhamentos de rede não são suportados para o banco;
  • TZ define o fuso. Descomente a linha e troque Etc/UTC por um identificador da lista tz. Um exemplo para o Brasil é TZ=America/Sao_Paulo;
  • IMMICH_VERSION aceita uma versão fixa. O padrão v3 acompanha a linha 3. Para fixar, um exemplo é IMMICH_VERSION=v3.3.5; confira a versão atual na página de releases;
  • DB_PASSWORD é a senha do Postgres. Troque por uma senha aleatória, usando só os caracteres A-Za-z0-9, sem caracteres especiais nem espaços. A documentação cita o pwgen para gerar uma.

As linhas abaixo da senha, DB_USERNAME e DB_DATABASE_NAME, não precisam ser mudadas. O Postgres não é exposto publicamente, e a senha serve só para a autenticação local.

Passo 3: subir o Immich

Na pasta do Immich, rode:

docker compose up -d

Use docker compose, com espaço, e não o docker-compose antigo. Se aparecer o erro unknown shorthand flag: 'd' in -d, ou uma permissão negada no .env, a documentação aponta uma versão errada do Docker. Para gerenciar os contêineres pelo navegador depois, veja o guia Portainer na VPS: como gerenciar o Docker pelo navegador.

O compose da v3.3.5 cria quatro serviços, todos com restart: always:

  • immich-server, o servidor, que publica a porta 2283;
  • immich-machine-learning, o contêiner de machine learning;
  • redis, com uma imagem do Valkey;
  • database, o Postgres do Immich.

Mudou o .env? Recrie os contêineres

Segundo a documentação, para mudar variáveis de ambiente é preciso recriar os contêineres do Immich. O comando é o mesmo docker compose up -d. Se não funcionar, tente docker compose up -d --force-recreate.

Primeiro acesso e usuário administrador

Abra o endereço da sua máquina na porta 2283 no navegador e clique em Getting Started. Um exemplo, com um IP de documentação no lugar do da sua VPS:

http://203.0.113.10:2283

Segundo a documentação, o primeiro usuário a se registrar é o administrador, e ele pode adicionar os outros usuários em Administration, Users.

App do celular e backup das fotos

Os aplicativos do Immich estão na App Store, no Google Play, nas releases do GitHub (APK) e no F-Droid. Para entrar, informe o endereço do servidor, como o do exemplo acima. Depois, a documentação manda:

  1. abrir a tela de backup pelo ícone de nuvem, no canto superior direito;
  2. escolher os álbuns, pois todos os arquivos dos álbuns selecionados serão enviados;
  3. rolar até o fim e tocar em "Enable Backup".

O Immich envia as fotos e os vídeos novos dos álbuns escolhidos quando você abre ou retoma o app, e também periodicamente em segundo plano. No Android, alguns modelos são muito rígidos com a otimização de bateria, o que pode atrapalhar o envio em segundo plano. No iOS, é preciso ativar o Background App Refresh para o app funcionar em segundo plano, e é o iOS que decide quando ele roda.

HTTPS com proxy reverso

Para acessar por um domínio, com HTTPS, coloque um proxy reverso na frente do Immich. A documentação diz que o proxy pode cuidar do TLS e que precisa permitir uploads grandes. O Immich não oferece suporte a subcaminho, como location /immich: use um subdomínio, como fotos.exemplo.com.br.

No exemplo de NGINX da documentação, as diretivas relevantes são client_max_body_size 50000M;, proxy_read_timeout 600s; e proxy_send_timeout 600s;, além do suporte a websockets. O Caddy, segundo a documentação, tem HTTPS automático. Um exemplo de Caddyfile, adaptado do da documentação:

fotos.exemplo.com.br {

reverse_proxy http://127.0.0.1:2283

}

Com o domínio no ar, o endereço no app passa a ser https://fotos.exemplo.com.br. O FAQ aconselha usar um certificado SSL confiável para o domínio, em vez de um autoassinado.

Backup do banco e da pasta de uploads

A documentação diz: "Database backups do not contain photos or videos", ou seja, os backups do banco não contêm fotos nem vídeos. O banco guarda só metadados e informações de usuários, e as imagens e vídeos de UPLOAD_LOCATION exigem backup manual. A documentação recomenda a estratégia 3-2-1 e avisa que você ainda precisa usar uma ferramenta de backup de verdade.

  • Banco: o Immich cria backups automáticos em UPLOAD_LOCATION/backups. O padrão é manter os últimos 14, criados diariamente às 2h, ajustável em Administration, Settings, Database Dump Settings. Eles ficam na mesma pasta dos uploads, e por isso também precisam de cópia;
  • Arquivos: só o conteúdo original é crítico, em library, upload e profile. A documentação aconselha copiar o UPLOAD_LOCATION inteiro; se copiar só essas três pastas, será preciso refazer os jobs de transcodificação e de miniaturas depois de restaurar.

O comando da documentação para um backup manual do banco no Linux é:

docker exec -t immich_postgres pg_dump --clean --if-exists --dbname=<DB_DATABASE_NAME> --username=<DB_USERNAME> | gzip > "/path/to/backup/dump.sql.gz"

Troque <DB_DATABASE_NAME> e <DB_USERNAME> pelos valores do seu .env e o caminho de saída por uma pasta sua. Para manter o backup consistente, a documentação diz que a melhor forma é parar o contêiner immich-server enquanto você faz o backup. Para ver como uma cópia pode ir para a nuvem pelo SFTP, veja o guia Backup do computador na nuvem: como fazer pelo SFTP.

Restaurar apaga o banco atual

Segundo a documentação, restaurar um backup apaga o banco atual e o substitui pelo backup. Restaurar de outra versão do Immich pode exigir migrações do banco, e a restauração pede uma instalação completamente nova.

Como atualizar o Immich

Antes de atualizar, faça o backup do banco e leia as notas da release, pois a documentação manda considerar as mudanças incompatíveis que elas listam. A equipe pretende limitar essas mudanças às versões major. Se o seu .env fixa a versão, atualize o IMMICH_VERSION para a desejada. A documentação recomenda atualizar os apps do celular antes do servidor. Em seguida, rode:

docker compose pull && docker compose up -d

docker image prune

O segundo comando limpa as imagens antigas. Duas regras do projeto: não há patches para versões anteriores, e voltar para uma versão anterior não é suportado, nem dentro da mesma versão menor. A v3.3.5 traz uma correção de segurança, e o projeto recomenda atualizar. Se você também quer uma nuvem própria para arquivos em geral, veja o guia Nextcloud na VPS: como instalar sua nuvem própria.

Resumo do caminho

A ordem é conferir os requisitos, baixar o compose e o .env da v3.3.5, trocar a senha do banco, subir com docker compose up -d, criar o administrador, configurar o app e deixar o backup do banco e dos uploads pronto desde o primeiro dia.

Quer guardar uma cópia dos arquivos fora do servidor? 11Cloud, armazenamento em nuvem com app e acesso por SFTP/WebDAV, a partir de R$ 7,90/mês no plano de 100GB; confira na loja o que cada plano inclui. Ver o 11Cloud

Perguntas frequentes

Qual versão do Immich é instalada aqui?

A v3.3.5, a release "Latest" em outubro de 2026. A v3.4.0-rc.1 é um pré-lançamento, e por isso não é usada.

O backup do banco inclui minhas fotos?

Não. Segundo a documentação, os backups do banco contêm só metadados. As fotos e os vídeos ficam em UPLOAD_LOCATION, e você precisa copiá-los com uma ferramenta de backup.

Posso guardar o banco em um compartilhamento de rede?

Não. A documentação diz que o DB_DATA_LOCATION não deve ficar em compartilhamento de rede de nenhum tipo, e prefere um SSD local.

Que caracteres posso usar na senha do banco?

Só A-Za-z0-9, sem caracteres especiais nem espaços.

Dá para voltar para uma versão anterior do Immich?

Não. Segundo a documentação, voltar para uma versão anterior não é suportado, nem dentro da mesma versão menor.

Esta resposta lhe foi útil?

Artigos Relacionados