Como Autohostear Umami em um VPS (Guia Completo)

Umami é uma solução de análise web autohospedada que prioriza privacidade e simplicidade. Este guia irá orientá-lo pelo processo de autohospedagem do Umami em um Virtual Private Server (VPS) usando Docker, fornecendo um passo a passo completo para desenvolvedores e entusiastas de homelab.

Pré-requisitos

Antes de começar, garanta que você tenha os seguintes requisitos:

1. Um VPS ativo de um provedor confiável. Aqui está uma comparação de opções populares:

Para comparações detalhadas, visite nossa comparação completa de VPS.

2. Conhecimento básico de linha de comando.
3. Um nome de domínio apontando para seu VPS.
4. Docker e Docker Compose instalados.

Passo 1: Configurando seu VPS

Primeiro, acesse seu VPS via SSH. Substitua username e vps_ip pelo seu usuário e endereço IP do VPS:

ssh username@vps_ip

Atualize o índice de pacotes:

sudo apt update && sudo apt upgrade -y

Passo 2: Instalar Docker

Se o Docker não estiver instalado, siga estes passos:

sudo apt install apt-transport-https ca-certificates curl software-properties-common -y
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -
sudo add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable"
sudo apt update
sudo apt install docker-ce -y

Verifique a instalação do Docker:

sudo systemctl status docker

Passo 3: Instalar Docker Compose

O Docker Compose facilita a gestão de aplicações com múltiplos containers. Instale-o com:

sudo curl -L "https://github.com/docker/compose/releases/latest/download/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
sudo chmod +x /usr/local/bin/docker-compose

Verifique a instalação:

docker-compose --version

Passo 4: Executando o Umami

Crie um diretório para o Umami:

mkdir umami && cd umami

Crie um arquivo docker-compose.yml:

version: '3'

services:
  umami:
    image: umami/umami
    restart: always
    environment:
      DATABASE_URL: postgres://umami:umami_password@db:5432/umami
      NEXT_PUBLIC_USERNAME: admin
      NEXT_PUBLIC_PASSWORD: admin_password
    ports:
      - "3000:3000"

  db:
    image: postgres
    restart: always
    environment:
      POSTGRES_USER: umami
      POSTGRES_DB: umami
      POSTGRES_PASSWORD: umami_password
    volumes:
      - db_data:/var/lib/postgresql/data
    networks:
      - umami-network

volumes:
  db_data:

networks:
  umami-network:

Substitua umami_password e admin_password por senhas fortes e únicas.

Passo 5: Lançar o Umami

Execute o comando abaixo para iniciar o Umami:

docker-compose up -d

Confirme que todos os containers estão ativos:

docker-compose ps

Passo 6: Configurar o Umami

Acesse o Umami navegando até http://seu_dominio_ou_ip_do_vps:3000 no navegador. Complete a configuração adicionando sites para monitorar.

Perguntas Frequentes

Como garantir que o Umami esteja protegido com HTTPS?

Para proteger sua instalação do Umami, você deve configurar um proxy reverso usando Nginx ou Traefik para gerenciar o HTTPS via Let’s Encrypt. Garanta que seu domínio aponte para seu servidor, depois instale e configure o proxy reverso seguindo a documentação para Nginx ou Traefik.

Posso monitorar múltiplos sites com o Umami?

Sim, o Umami permite rastrear múltiplos sites a partir do mesmo painel. Basta fazer o login, clicar em “Add a new site” (Adicionar um novo site) e seguir as instruções para inserir a URL do seu site e outros detalhes relevantes. Uma vez adicionados, você poderá visualizar as análises de cada site separadamente no seu painel do Umami.

Quais são os requisitos de sistema para rodar o Umami?

O Umami não possui requisitos estritos, mas para uma experiência suave, recomenda-se um VPS com pelo menos 1 GB de RAM e 1 núcleo de CPU. Trafego mais intenso pode requerer recursos adicionais, e o uso de SSD pode melhorar substancialmente o desempenho.

Conclusão

Autohospedar o Umami em um VPS é um processo simples que permite manter o controle sobre seus dados de análise, aproveitando uma plataforma poderosa e de código aberto. Com Docker, a configuração fica ainda mais acessível e gerenciável. Agora, você está pronto para analisar o desempenho do seu site sem comprometer sua privacidade. Boa autohospedagem!