Independent testing Updated July 2026 387 self-hosting guides 5 VPS providers tested

guide

Como Auto-Hospedar o Immich em um VPS (Guia Completo)

Aprenda a alojar Immich por conta própria num VPS, com um guia detalhado passo a passo sobre instalação, configuração e proteção de Immich. Guia completo.

Como Auto-Hospedar o Immich em um VPS (Guia Completo)

Auto-hospedar uma aplicação pode proporcionar maior controle sobre seus dados e melhorar a sua privacidade. O Immich, uma solução de backup de fotos e vídeos hospedada por você, pode ser facilmente configurado em um Virtual Private Server (VPS). Neste guia, vamos orientá-lo passo a passo para instalar o Immich em um VPS, usando Docker para containerização.

O que Você Precisa

  1. Provedor de VPS: Escolha um provedor de VPS que atenda às suas necessidades. Aqui estão algumas opções:

    ProvedorPreço (EUR/USD)RecursosLink
    Contabo VPS5,99 EUR/mêsArmazenamento SSD, Opções de BackupContabo
    Hetzner Cloud5,49 EUR/mêsAlta Performance, EscalabilidadeHetzner
    DigitalOcean6 USD/mêsFácil de Usar, Ecossistema para DesenvolvedoresDigitalOcean
    Vultr6 USD/mêsData Centers Globais, Configuração RápidaVultr
    Linode5 USD/mêsSuporte Confiável, Rede AvançadaLinode

    Para uma comparação completa de VPS, visite esta página.

  2. Nome de Domínio: Recomenda-se um nome de domínio para acessar sua instalação do Immich.

  3. Conhecimento Básico: Familiaridade com comandos Linux e Docker.

Guia de Instalação Passo a Passo

Passo 1: Configure Seu VPS

  1. Escolha seu SO: Para esta instalação, usaremos Ubuntu 22.04. Outras distribuições podem ser utilizadas, mas podem exigir ajustes nos comandos.

  2. Acesse seu VPS: Conecte-se ao seu VPS usando SSH. Substitua user e ip_address pelos seus dados:

    ssh user@endereço_ip
  3. Atualize o Repositório de Pacotes:

    sudo apt update
    sudo apt upgrade -y

Passo 2: Instale o Docker

  1. Instale os Pacotes Necessários:

    sudo apt install apt-transport-https ca-certificates curl software-properties-common -y
  2. Adicione a Chave GPG Oficial do Docker:

    sudo install -m 0755 -d /etc/apt/keyrings
    sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
    sudo chmod a+r /etc/apt/keyrings/docker.asc
  3. Configure o Repositório Estável:

    echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
  4. Instale o Docker:

    sudo apt update
    sudo apt install docker-ce -y
  5. Habilite o Docker para Iniciar ao Reiniciar:

    sudo systemctl enable docker
    sudo systemctl start docker

Passo 3: Instale o Docker Compose

  1. Baixe o Docker Compose:

    sudo curl -L "https://github.com/docker/compose/releases/latest/download/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
  2. Configure as Permissões:

    sudo chmod +x /usr/local/bin/docker-compose
  3. Verifique a Instalação:

    docker-compose --version

Passo 4: Implante o Immich

  1. Crie um Diretório para o Immich:

    mkdir ~/immich
    cd ~/immich
  2. Crie um Arquivo docker-compose.yml:

    nano docker-compose.yml

    Adicione 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:
  3. Inicie o Serviço do Immich:

    docker-compose up -d
  4. Acesse o Immich: Abra seu navegador e navegue até http://seu-dominio-ou-ip:2283.

Passo 5: Configure Domínios e SSL (Opcional)

Para uma aplicação em produção, é aconselhável proteger sua instalação com SSL usando ferramentas como Certbot.

  1. Instale o Certbot e o serviço Nginx:

    sudo apt install certbot python3-certbot-nginx -y
  2. Depois, siga as instruções do Certbot para seu servidor para obter um certificado SSL.

Perguntas Frequentes

1. Como o Immich se compara a outras soluções de hospedagem própria?

O Immich é projetado especificamente para armazenamento de fotos e vídeos, tornando-se ideal para usuários que precisam de um espaço dedicado para seu conteúdo multimídia. Ao contrário do Nextcloud ou OwnCloud, que oferecem funcionalidades mais amplas, o Immich foca em fornecer uma plataforma simples, rápida e eficiente para seus arquivos de mídia. Ele também possui uma interface elegante e configuração fácil via Docker, atraindo usuários que desejam uma implantação rápida sem abrir mão do desempenho.

2. Por que devo usar um VPS em vez de hospedagem compartilhada para o Immich?

Usar um VPS oferece várias vantagens para hospedar o Immich, incluindo melhor desempenho, recursos dedicados e controle total sobre o ambiente. Diferentemente da hospedagem compartilhada, um VPS permite instalar o software necessário e configurar o servidor conforme suas necessidades. Isso é especialmente benéfico para aplicações que consomem muitos recursos, como o Immich, que requer capacidades ótimas de armazenamento e processamento.

3. Quais problemas comuns posso enfrentar ao hospedar o Immich por conta própria?

Problemas comuns podem incluir configurações de rede, erros na conexão com o banco de dados ou problemas com permissões de arquivo. Ao implantar o Immich, assegure-se de que seu VPS possui regras de firewall adequadas para permitir tráfego nas portas necessárias. Além disso, verificar se todas as dependências estão atendidas e que o Docker está configurado corretamente ajudará a minimizar possíveis problemas. Para solucionar dificuldades, a documentação do Immich e a comunidade r/selfhosted são ótimos recursos.

Seguindo este guia, você pode hospedar o Immich com confiança em um VPS, tendo controle total sobre seus arquivos de mídia enquanto aprofunda seu entendimento sobre containerização com Docker. --- FIM ---