Como Auto-Hospedar o Immich no Hetzner (Guia 2026)

Introdução

O Immich é uma solução de backup de fotos e vídeos de código aberto, hospedada por você, que permite aos usuários gerenciar suas memórias em um ambiente seguro. Aproveitando a infraestrutura robusta do Hetzner, você pode configurar e gerenciar sua própria instância do Immich rapidamente. Este guia irá guiá-lo por todo o processo, desde a provisão do seu VPS no Hetzner até a instalação e configuração do Immich.

Escolhendo o VPS Certo

Quando se trata de hospedar aplicações como o Immich, a escolha do provedor de VPS é fundamental. O Hetzner oferece preços competitivos e desempenho, tornando-se uma excelente opção para desenvolvedores. Abaixo, uma comparação de alguns provedores populares de VPS com base em seus preços e especificações:

Considere suas necessidades específicas ao selecionar um provedor de VPS. Para este guia, utilizaremos o Hetzner devido ao seu custo-benefício e desempenho mesmo nos planos de entrada.

Passo 1: Provisão de um VPS no Hetzner

1. Acesse o site do Hetzner Cloud.
2. Cadastre-se para uma conta, caso ainda não tenha.
3. Crie um novo projeto e lance um novo servidor.
4. Escolha um tipo de servidor básico (“CX22” é suficiente para o Immich).
5. Selecione a localização do seu data center preferida.
6. Continue com a criação e anote sua chave SSH para acesso.

Passo 2: Conectando ao Seu VPS

Uma vez que seu servidor esteja ativo, conecte-se a ele via SSH. Abra um terminal (ou Prompt de Comando no Windows) e insira:

ssh root@SEU_ENDEREÇO_IP

Substitua SEU_ENDEREÇO_IP pelo IP atribuído ao seu VPS do Hetzner.

Passo 3: Instalando os Softwares Necessários

Antes de instalar o Immich, será necessário configurar o Docker e o Docker Compose. Execute os seguintes comandos:

# Atualizar a lista de pacotes
apt update && apt upgrade -y

# Instalar o Docker
apt install docker.io -y

# Habilitar e iniciar o Docker
systemctl enable docker
systemctl start docker

# Instalar o Docker Compose
apt install docker-compose-v2 -y

Verifique a instalação:

docker --version
docker compose version

Passo 4: Configurando o Immich

Crie um diretório para o Immich:

mkdir ~/immich && cd ~/immich

Crie um arquivo docker-compose.yml usando um editor de texto:

nano docker-compose.yml

Insira a seguinte configuração:

services:
  immich-server:
    image: ghcr.io/immich-app/immich-server:release
    restart: always
    ports:
      - "2283:2283"
    environment:
      DB_HOSTNAME: database
      DB_USERNAME: immich
      DB_PASSWORD: your-secure-password
      DB_DATABASE_NAME: immich
      REDIS_HOSTNAME: redis
      UPLOAD_LOCATION: ./library
    volumes:
      - ./library:/data
    depends_on:
      - database
      - redis

  immich-machine-learning:
    image: ghcr.io/immich-app/immich-machine-learning:release
    restart: always
    volumes:
      - model-cache:/cache

  redis:
    image: docker.io/valkey/valkey:9
    restart: always

  database:
    image: ghcr.io/immich-app/postgres:14-vectorchord0.4.3-pgvectors0.2.0
    restart: always
    environment:
      POSTGRES_USER: immich
      POSTGRES_PASSWORD: your-secure-password
      POSTGRES_DB: immich
    volumes:
      - db-data:/var/lib/postgresql/data

volumes:
  db-data:
  model-cache:

Certifique-se de substituir sua-senha-mais-segura por uma senha mais forte de sua preferência.

Passo 5: Executando o Immich

Agora, você pode iniciar o Immich usando o Docker Compose:

docker compose up -d

Para verificar se o Immich está funcionando corretamente, acesse-o pelo seu navegador na URL http://SEU_ENDEREÇO_IP:2283. Você deverá ver a interface de configuração do Immich.

Passo 6: Configurando seu Domínio (Opcional)

Se desejar usar um domínio personalizado para sua instalação do Immich, assegure-se de que seus registros DNS apontam para o IP do seu VPS no Hetzner. Você também pode configurar um proxy reverso com Nginx ou Traefik para suporte a SSL.

Perguntas Frequentes

1. Quais são os principais recursos do Immich?

O Immich oferece um conjunto de recursos projetados para a gestão de mídia pessoal. Os usuários podem fazer upload, armazenar e recuperar imagens e vídeos facilmente. Ele suporta múltiplos níveis de acesso de usuários e pode organizar fotos através de álbuns e tags pesquisáveis. Além disso, sua capacidade de backup permite armazenar suas mídias de forma segura na sua própria infraestrutura.

2. É seguro hospedar o Immich por conta própria?

Hospedar aplicações como o Immich pode ser seguro se as medidas de segurança corretas forem implementadas. Isso inclui usar senhas fortes, atualizar seu software regularmente, configurar firewalls e possivelmente usar criptografia SSL. É importante proteger seu servidor mantendo apenas as portas necessárias abertas e considerar usar ferramentas como UFW (Firewall Simples) para monitorar o acesso.

3. Posso escalar meu VPS do Hetzner, se necessário?

Sim, o Hetzner permite escalar seu VPS conforme sua demanda aumenta. Você pode facilmente fazer upgrade na CPU, memória e armazenamento através do painel de controle do Hetzner Cloud. Essa flexibilidade torna-o adequado para projetos que podem crescer ao longo do tempo, permitindo lidar com mais usuários e maior armazenamento sem grandes reconfigurações.

Para uma análise mais completa de várias opções de VPS, confira nossa comparação completa de VPS. Boas hospedagens!