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

PostHog é uma plataforma de análises poderosa, projetada para desenvolvedores que desejam auto-hospedar suas aplicações enquanto mantêm controle sobre seus dados. Este guia irá te conduzir pelos passos necessários para instalar o PostHog em um Virtual Private Server (VPS). Vamos cobrir tudo, desde a escolha do provedor até a execução do aplicativo PostHog usando Docker.

Escolhendo seu Provedor de VPS

Antes de começarmos a instalação, você precisa escolher um provedor de VPS. Abaixo estão algumas opções populares que atendem tanto a desenvolvedores quanto a entusiastas de homelab:

Para uma comparação completa de VPS, visite nossa comparação completa de VPS.

Pré-requisitos

1. Configuração do VPS: Certifique-se de que seu VPS está rodando Ubuntu 20.04 ou superior.
2. Domínio: Recomenda-se ter um nome de domínio para facilitar o acesso à sua instância do PostHog.
3. Docker e Docker Compose: Garanta que Docker e Docker Compose estejam instalados em seu VPS.

Para instalar Docker e Docker Compose, utilize os seguintes comandos:

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

Instalando o PostHog

Agora que seu ambiente está configurado, você está pronto para instalar o PostHog:

1. Clonar o Repositório

Abra seu terminal e execute o seguinte comando para clonar o repositório do PostHog:

git clone https://github.com/PostHog/posthog.git
cd posthog

2. Criar um arquivo .env

Crie um arquivo .env na raiz do diretório clonado para configurar seu ambiente do PostHog. Aqui está um exemplo básico:

# Configuração do PostHog
POSTHOG_INSTANCE_ID=seu_id_de_instancia
POSTHOG_SECRET_KEY=sua_chave_secreta
# Ajuste as configurações do Redis e PostgreSQL conforme necessário

3. Configurar Docker Compose

Em seguida, crie um arquivo docker-compose.yml. Abaixo está uma configuração de exemplo:

version: '3.8'
services:
  web:
    image: posthog/posthog
    env_file: .env
    ports:
      - "8000:8000"
    depends_on:
      - redis
      - postgres
      
  redis:
    image: redis:6.0
    ports:
      - "6379:6379"

  postgres:
    image: postgres:13
    environment:
      POSTGRES_DB: posthog
      POSTGRES_USER: posthog
      POSTGRES_PASSWORD: sua_senha_postgres
    ports:
      - "5432:5432"

networks:
  default:
    driver: bridge

4. Iniciar os Serviços

Agora, inicie sua instância do PostHog usando Docker Compose:

docker-compose up -d

Este comando fará o download das imagens necessárias e iniciará os serviços em modo destacado (detached).

5. Acessar o PostHog

Abra seu navegador e acesse http://seu-domínio-ou-ip:8000. Você deverá ver a interface do PostHog, onde poderá começar a rastrear seus dados.

Configurando o PostHog

Depois que o PostHog estiver em execução, você pode desejar realizar configurações iniciais:

1. Autenticação de Usuário: Crie uma conta de usuário e gerencie as permissões de acesso.
2. Integração com seus Apps: Use a biblioteca JavaScript do PostHog para adicionar tracking às suas aplicações.
3. Gestão de Dados: Familiarize-se com o painel para gerenciar eventos e propriedades.

FAQ

Posso rodar o PostHog em um VPS de baixa performance?

Com certeza, o PostHog pode rodar em um VPS de baixa potência, mas o desempenho pode variar dependendo do número de eventos rastreados e do número de usuários simultâneos. Se estiver começando, considere usar provedores como Hetzner Cloud ou Contabo, que oferecem planos acessíveis com recursos suficientes para instalações pequenas a médias.

Como migrar o PostHog para outro VPS?

Para migrar o PostHog para outro VPS, você precisa fazer backup do seu banco de dados e arquivos de configuração. Exporte seu banco de dados PostgreSQL usando pg_dump, transfira para o novo servidor e restaure usando psql. Não se esqueça de também mover seu arquivo .env e docker-compose.yml para o novo ambiente.

É seguro hospedar o PostHog por conta própria?

Hospedar o PostHog por conta própria pode ser seguro se você seguir boas práticas, como usar HTTPS, configurar firewalls e manter seu software atualizado. Certifique-se de proteger adequadamente seu banco de dados PostgreSQL e sua instância do Redis, além de considerar o uso de serviços como Let’s Encrypt para certificados SSL, garantindo conexões criptografadas.

Conclusão

Auto-hospedar o PostHog em um VPS oferece controle total sobre seus dados de análise e pode economizar custos a longo prazo. Seguindo este guia, você pode configurar rapidamente e começar a usar o PostHog para suas aplicações. Se encontrar problemas, a comunidade r/selfhosted e o repositório awesome-selfhosted são ótimos recursos para solução de problemas e para encontrar ferramentas adicionais. Boa auto-hospedagem!