Plausible self-hosted: guia completo de instalação em 2026

Cada vez mais organizações europeias preocupadas com a privacidade procuram alternativas às plataformas de análise tradicionais que lhes deem controlo total sobre os dados. O Plausible self-hosted é uma solução convincente para empresas que precisam de plena soberania sobre os dados sem abdicar de uma análise leve e respeitadora da privacidade. Ao instalar a infraestrutura de análise nos seus próprios servidores, elimina a partilha de dados com terceiros, garante o cumprimento das normas europeias de privacidade e sabe exatamente onde ficam as informações dos visitantes. Esta abordagem faz especial sentido para as empresas europeias que dão prioridade à soberania digital e querem deixar de depender de infraestruturas sediadas nos EUA.

Como funciona a arquitetura do Plausible self-hosted

O Plausible self-hosted é uma aplicação em contentores que corre inteiramente na sua infraestrutura. Ao contrário das soluções na nuvem, em que os dados passam por servidores externos, a versão self-hosted mantém toda a informação dentro do seu próprio ambiente.

A arquitetura tem três componentes principais: a interface da aplicação web, uma base de dados PostgreSQL para guardar os dados de análise e uma base de dados ClickHouse para processar grandes volumes de eventos. Esta separação permite tratar os dados com eficiência mesmo quando o tráfego cresce.

Principais vantagens da arquitetura:

• Propriedade total dos dados, sem dependências externas
• Acesso direto à base de dados para consultas e relatórios personalizados
• Integração com a infraestrutura que já tem
• Controlo total sobre as políticas de retenção de dados
• Eliminação de subcontratantes terceiros

Quando instala o Plausible self-hosted, está a instalar o mesmo código usado na oferta em nuvem do Plausible, mas configurado para correr no seu hardware. A documentação oficial inclui guias detalhados para vários cenários de instalação.

Requisitos de sistema e planeamento da infraestrutura

Antes de instalar o Plausible self-hosted, tem de avaliar a capacidade da sua infraestrutura. Os requisitos mínimos são 2 GB de RAM e 20 GB de armazenamento, mas um ambiente de produção costuma exigir bastante mais recursos.

O volume de tráfego determina diretamente os recursos necessários. Um site com 10 000 visitantes por mês pode funcionar sem problemas com uma configuração básica, enquanto propriedades com muito tráfego precisam de servidores dedicados com mais capacidade de processamento.

As necessidades de armazenamento crescem com o período de retenção dos dados. Se pretende manter histórico de vários anos, planeie em conformidade. O ClickHouse trata séries temporais com eficiência, mas continua a precisar de espaço em disco suficiente.

A rede merece a mesma atenção. A sua instância tem de estar acessível aos browsers dos visitantes, mesmo que fique atrás de firewalls empresariais. Uma configuração de DNS correta e a boa gestão dos certificados SSL garantem um funcionamento sem falhas.

Métodos de instalação e opções de implementação

Há várias formas de instalar o Plausible self-hosted, cada uma adequada a ambientes técnicos e níveis de experiência diferentes. O Docker Compose é o método mais simples: fornece contentores pré-configurados que tratam das dependências automaticamente.

Instalação com Docker Compose

A instalação com Docker cria contentores isolados para cada componente, o que simplifica atualizações e manutenção. Antes de começar, precisa de ter o Docker e o Docker Compose instalados no servidor.

1. Clone o repositório de alojamento para o seu servidor
2. Configure as variáveis de ambiente, incluindo as credenciais da base de dados
3. Configure um proxy inverso para a terminação SSL
4. Inicie os contentores com docker-compose up
5. Conclua a configuração inicial na interface web
6. Adicione o script de rastreio aos seus sites

Este método oferece um excelente isolamento e torna as atualizações simples: basta descarregar novas imagens dos contentores. O artigo sobre configurar o Plausible Analytics num blogue mostra o processo com capturas de ecrã detalhadas e dicas para resolver problemas.

Instalação manual em Ubuntu

Para organizações que preferem uma instalação tradicional em servidor, a instalação manual dá um controlo mais fino. Neste caso, o PostgreSQL e o ClickHouse são instalados diretamente no sistema operativo, sem contentores.

O processo tem mais passos, mas resulta numa instalação nativa que se integra bem com as ferramentas de gestão de sistema que já usa. Terá de compilar a aplicação Elixir, configurar serviços systemd e gerir manualmente as ligações às bases de dados.

Vantagens da instalação manual:

• Menor consumo de recursos, sem a camada de contentores
• Integração direta com as ferramentas de monitorização do sistema
• Cópias de segurança mais simples com as ferramentas nativas das bases de dados
• Mais flexibilidade para personalizar

Em contrapartida, as atualizações exigem mais intervenção manual do que descarregar novas imagens de contentores. Terá de gerir as dependências Elixir e garantir a compatibilidade entre componentes em cada atualização.

Opções de configuração e personalização

Com a instância do Plausible self-hosted a funcionar, é a configuração que define o seu comportamento e as funcionalidades disponíveis. O ficheiro de configuração controla tudo, desde as definições de SMTP até aos limites de pedidos e à retenção de dados.

Parâmetros de configuração essenciais

O parâmetro BASE_URL define como os utilizadores acedem ao painel de análise. Indique aqui o seu domínio com o protocolo HTTPS. Sem esta configuração, os relatórios por email e os links partilhados não funcionam corretamente.

O SECRET_KEY_BASE garante a segurança criptográfica da gestão de sessões. Gere um valor aleatório forte durante a configuração inicial e nunca o divulgue. Se alterar este valor, as sessões existentes deixam de ser válidas e todos os utilizadores têm de voltar a autenticar-se.

As strings de ligação à base de dados indicam à aplicação onde estão o PostgreSQL e o ClickHouse. Normalmente apontam para localhost quando as bases de dados correm no mesmo servidor, mas podem apontar para clusters remotos em instalações distribuídas.

DATABASE_URL=postgres://user:password@localhost:5432/plausible_db
CLICKHOUSE_DATABASE_URL=http://localhost:8123/plausible_events_db

A configuração de SMTP ativa os relatórios por email e as notificações aos utilizadores. Indique os dados do seu servidor de correio, incluindo as credenciais de autenticação. Muitos administradores usam serviços dedicados de email transacional para maior fiabilidade.

Configuração de funcionalidades avançadas

A definição DISABLE_REGISTRATION é útil depois de criar as contas iniciais. Defina-a como true para impedir registos não autorizados, mantendo o acesso dos utilizadores existentes.

A configuração de domínio personalizado permite usar a instalação em regime de marca branca. Em vez de analytics.suaempresa.com, pode configurar stats.dominiodocliente.com para instalações destinadas a clientes.

A geolocalização requer a base de dados MaxMind GeoLite2. Descarregue-a e configure o caminho para obter a localização dos visitantes ao nível do país e da cidade. O guia de configuração e implementação aborda as questões de privacidade ligadas aos dados de geolocalização.

Para empresas europeias preocupadas com a soberania dos dados, estas opções garantem que todo o processamento acontece numa infraestrutura controlada. Ao contrário das plataformas de análise geridas, com opções de configuração limitadas, o Plausible self-hosted oferece total flexibilidade.

Ao configurar uma análise sem cookies, veja como a sua implementação de rastreio atual identifica os visitantes sem identificadores persistentes. A abordagem sem cookies encaixa perfeitamente nas expectativas europeias de privacidade.

Integrar o Plausible self-hosted nos seus sites

Depois de configurar a instância, a integração consiste em adicionar um pequeno snippet JavaScript aos seus sites. Este script recolhe os eventos e envia-os para o seu servidor de análise.

A integração padrão passa por colocar uma tag script na secção <head> do site. Ao contrário das plataformas de análise tradicionais, que exigem uma gestão de tags extensa, o Plausible self-hosted usa uma única referência de script.

Instalação e verificação do script

Copie o snippet do script nas definições do painel. Ele aponta para o seu BASE_URL e inclui um atributo data-domain com o domínio do site. Este atributo evita a mistura de dados entre domínios quando uma instância acompanha várias propriedades.

Onde colocar o script:

• Diretamente nos ficheiros de template HTML
• Através de sistemas de gestão de tags
• Através de plugins do sistema de gestão de conteúdos
• Injetado dinamicamente por renderização do lado do servidor

A verificação confirma que os dados chegam corretamente. Visite o site com as ferramentas de programador do browser abertas e acompanhe os pedidos de rede. Deverá ver pedidos para o domínio do seu Plausible self-hosted com o código de estado 202.

O script do Plausible self-hosted pesa menos de 1 KB, muito menos do que as plataformas de análise mais antigas. Este tamanho mínimo melhora os tempos de carregamento das páginas, o que beneficia a experiência do utilizador e o posicionamento nas pesquisas. Pode confirmar o impacto no desempenho com ferramentas de teste de velocidade que medem o peso de scripts de terceiros.

Configuração de eventos personalizados

Além das visualizações de página, o Plausible self-hosted suporta eventos personalizados para medir conversões e interações dos utilizadores. Estes eventos registam ações concretas, como o envio de formulários, transferências ou reprodução de vídeos.

Os eventos personalizados são implementados com chamadas à API JavaScript. A função plausible fica disponível globalmente depois de o script carregar, pelo que pode disparar eventos por código:

plausible('Download', {props: {filename: 'whitepaper.pdf'}})

Os objetivos configuram-se no painel, onde define que eventos contam como conversões relevantes. Podem ser subscrições da newsletter, compras de produtos ou marcos de envolvimento com o conteúdo.

O artigo sobre ligar o seu site a uma instância self-hosted explica todo o processo de integração, incluindo a resolução de problemas comuns no carregamento do script e no registo de eventos.

Manutenção e atualizações

Manter o Plausible self-hosted exige manutenção contínua para garantir segurança, desempenho e acesso às novas funcionalidades. Ao contrário dos serviços geridos, em que o fornecedor trata das atualizações, uma instalação própria precisa de administração proativa.

Processo de atualização regular

Acompanhe o repositório do Plausible no GitHub para saber de novas versões. O projeto tem um ciclo de desenvolvimento ativo, com correções de segurança e novas funcionalidades. Subscreva as notificações de lançamento para estar a par das atualizações.

Em instalações Docker, atualizar consiste em descarregar as novas imagens e reiniciar os serviços. O processo demora normalmente poucos minutos, com uma interrupção mínima:

1. Leia as notas de versão à procura de alterações incompatíveis
2. Faça uma cópia de segurança das bases de dados antes de avançar
3. Descarregue as imagens mais recentes dos contentores
4. Pare os contentores em execução
5. Inicie os contentores com as novas imagens
6. Confirme que tudo funciona acedendo ao painel

As migrações da base de dados correm automaticamente no arranque dos contentores quando há alterações ao esquema. A aplicação deteta diferenças de versão e aplica as migrações necessárias antes de voltar a receber tráfego.

Gestão e otimização das bases de dados

O PostgreSQL e o ClickHouse precisam de manutenção periódica para terem o melhor desempenho. O ClickHouse beneficia sobretudo de otimizações regulares, já que lida com grandes volumes de eventos.

Acompanhe o tamanho das bases de dados e aplique políticas de retenção de acordo com os seus requisitos de conformidade. Muitas organizações guardam dados detalhados durante 12-24 meses e mantêm os dados agregados durante mais tempo. Alojar a sua própria análise melhora a precisão dos dados, porque controla totalmente as políticas de retenção e agregação.

As cópias de segurança devem abranger as duas bases de dados em simultâneo para manter a consistência. Cópias diárias automáticas evitam perdas de dados por falhas de hardware ou de software. Teste regularmente a reposição para confirmar que as cópias estão íntegras.

A manutenção dos índices mantém o desempenho das consultas estável à medida que os dados crescem. O ClickHouse trata disso quase sempre de forma automática, mas o PostgreSQL pode precisar de operações VACUUM periódicas nas tabelas com muitas atualizações.

Segurança e controlo de acessos

Uma infraestrutura própria exige boas práticas de segurança. A sua instância do Plausible self-hosted trata dados de visitantes, o que faz dela um alvo apetecível que tem de ser protegido.

Segurança de rede e configuração de SSL

Os certificados SSL cifram a transmissão de dados entre os browsers e o servidor de análise. O Let's Encrypt fornece certificados gratuitos com renovação automática, adequados à maioria das instalações. Configure o proxy inverso (Nginx ou Traefik) para tratar da terminação SSL.

As regras de firewall devem limitar o acesso às bases de dados ao servidor da aplicação. O ClickHouse e o PostgreSQL não precisam de estar expostos à Internet, por isso restrinja as ligações a localhost ou a redes privadas.

Limitar o número de pedidos evita abusos e garante a disponibilidade em picos de tráfego. Defina limites razoáveis nos endpoints da API para travar scraping automático ou tentativas de negação de serviço.

Medidas de segurança essenciais:

• Forçar HTTPS em todas as ligações
• Aplicar políticas de palavras-passe fortes
• Ativar a autenticação de dois fatores onde for possível
• Atualizações de segurança regulares em todos os componentes
• Segmentação de rede para os servidores de bases de dados
• Monitorização de padrões de acesso invulgares

Gestão de utilizadores e permissões

O Plausible self-hosted suporta várias contas de utilizador com diferentes níveis de permissão. Crie contas individuais para cada membro da equipa em vez de partilhar credenciais, para ter um registo de auditoria fiável.

As permissões por site permitem dar acesso a propriedades específicas sem expor todo o seu portefólio de análise. Isto é útil quando trabalha com consultores externos ou clientes que só precisam de ver determinados sites.

Revisões periódicas dos acessos garantem que quem sai da equipa perde o acesso rapidamente. Com requisitos de autenticação fortes, a segurança mantém-se mesmo quando a equipa muda.

O princípio do privilégio mínimo aplica-se também às bases de dados. Os utilizadores de base de dados da aplicação só precisam das permissões necessárias às suas funções, e não de direitos de administração sobre todas as bases de dados.

Self-hosted ou serviço gerido?

Escolher entre o Plausible self-hosted e um serviço de análise gerido implica pesar vantagens e desvantagens em várias dimensões. As duas abordagens respeitam a privacidade, mas funcionam de forma diferente no dia a dia.

Alojar a solução por conta própria dá o máximo de controlo, mas exige conhecimentos técnicos e atenção constante. Fica a seu cargo o aprovisionamento de servidores, as cópias de segurança, as correções de segurança e o planeamento da capacidade. Para organizações que já têm equipas de infraestrutura, isto encaixa naturalmente nas operações do dia a dia.

Os serviços geridos eliminam o esforço operacional em troca de uma mensalidade e de menos controlo. As atualizações são automáticas, a escala ajusta-se de forma transparente e as equipas de suporte resolvem os problemas. No entanto, os dados ficam na infraestrutura do fornecedor, possivelmente com subcontratantes terceiros envolvidos.

Para empresas europeias que dão prioridade à total soberania dos dados, a análise web para empresas europeias oferece uma alternativa. Criada especificamente para organizações europeias, junta a simplicidade de um serviço gerido à garantia de armazenamento e processamento de dados exclusivamente na UE.

Análise de custos ao longo do tempo

Os custos iniciais de alojar por conta própria incluem o aprovisionamento do servidor, os certificados SSL e o tempo de configuração. As despesas mensais incluem alojamento, armazenamento das cópias de segurança e tempo de administração. Para uma comparação rigorosa, calcule o custo total, incluindo o tempo da equipa.

Uma instalação pequena típica pode exigir 10-15 horas por ano de manutenção, atualizações e resolução de problemas. Aos custos de mão de obra europeus, isto representa um investimento contínuo significativo para além da infraestrutura. Instalações maiores exigem proporcionalmente mais tempo de administração.

Os serviços geridos têm custos mensais previsíveis que acompanham o volume de tráfego. Não há despesas inesperadas com infraestrutura e o orçamento é simples de fazer. Contudo, os custos acumulam-se à medida que o tráfego cresce e podem ultrapassar os de uma solução própria em propriedades com muito tráfego.

O ponto de equilíbrio depende da sua situação concreta. Organizações que já operam servidores com capacidade disponível podem achar o Plausible self-hosted mais económico. Quem não tem infraestrutura própria enfrenta uma barreira de entrada mais alta.

Resolução de problemas comuns

Mesmo instalações do Plausible self-hosted bem configuradas encontram problemas de vez em quando. Conhecer os mais comuns e as respetivas soluções ajuda a resolvê-los mais depressa.

Problemas de carregamento do script e de rastreio

Quando os dados deixam de aparecer, verifique primeiro se o script está a carregar. A consola de programador do browser mostra erros de JavaScript ou falhas de rede que impedem o rastreio. Confirme que o BASE_URL corresponde ao domínio que serve a análise.

Os cabeçalhos Content Security Policy por vezes bloqueiam scripts de análise. Se o seu site aplica uma CSP restrita, adicione o domínio do seu Plausible self-hosted às origens de scripts permitidas. Assim o script de rastreio pode carregar e executar normalmente.

Os bloqueadores de anúncios visam cada vez mais as ferramentas de análise, independentemente de respeitarem a privacidade. Alguns utilizadores bloqueiam todo o rastreio, o que resulta em dados incompletos. As plataformas de análise que respeitam a privacidade são menos bloqueadas do que as ferramentas tradicionais, mas nenhuma solução consegue uma cobertura perfeita.

Surgem problemas de cross-origin quando o domínio do script não coincide com o endpoint de recolha de dados. Se servir os scripts a partir de um domínio diferente do da recolha, confirme que o proxy inverso trata corretamente os cabeçalhos CORS.

Perda de desempenho da base de dados

À medida que os dados se acumulam, o desempenho das consultas pode cair se não houver manutenção. O ClickHouse beneficia sobretudo de operações de otimização periódicas que reorganizam os dados para um acesso eficiente.

Acompanhe os tempos de execução das consultas nos registos da base de dados. Aumentos súbitos indicam problemas que merecem investigação. As causas mais comuns são índices em falta, consultas ineficientes ou recursos de hardware insuficientes.

Se o disco encher, a base de dados deixa de conseguir escrever e o rastreio falha. Configure alertas de utilização do sistema de ficheiros para detetar problemas de capacidade antes que afetem o serviço. A limpeza automática de dados antigos mantém o armazenamento em níveis sustentáveis.

O esgotamento do pool de ligações acontece sob carga elevada, quando a aplicação não consegue abrir novas ligações à base de dados. Se vir erros de tempo limite de ligação em picos de tráfego, aumente o tamanho do pool na configuração.

Falhas de email e notificações

Os relatórios por email exigem uma configuração SMTP correta. Teste o envio de email após a configuração inicial e sempre que alterar as definições de SMTP. Muitos servidores de correio verificam rigorosamente o remetente e rejeitam mensagens de origens mal configuradas.

Os registos SPF e DKIM ajudam a garantir a entrega dos emails. Configure estes registos DNS para o domínio de envio, reduzindo a probabilidade de os relatórios serem marcados como spam.

Algumas organizações bloqueiam o tráfego SMTP de saída dos servidores de aplicações por motivos de segurança. Confirme que a sua rede permite ligações a servidores de correio externos nas portas necessárias (normalmente a 587 para envio autenticado).

Os limites de envio dos fornecedores de email podem atrasar ou impedir a entrega de relatórios em envios em massa. Agende os relatórios de forma a distribuir o envio ao longo do tempo, em vez de enviar milhares de uma só vez.

Perguntas frequentes

É difícil instalar o Plausible self-hosted?

A dificuldade depende da sua experiência técnica e do método escolhido. Uma instalação com Docker Compose demora 30-60 minutos para quem já trabalha com contentores. A instalação manual exige mais conhecimentos de Linux e leva normalmente várias horas. Os scripts de instalação simplificados reduzem a complexidade em ambientes Ubuntu ao automatizar os passos de configuração. Precisa de à-vontade com a linha de comandos, conhecimentos básicos de redes e de saber configurar um proxy inverso.

O Plausible self-hosted aguenta milhões de visualizações de página?

Sim, com a infraestrutura adequada o Plausible self-hosted processa milhões de visualizações de página por mês. O ClickHouse destaca-se com grandes volumes de séries temporais e processa milhões de eventos com eficiência. Pode escalar verticalmente, aumentando os recursos do servidor (mais RAM, CPUs mais rápidos), ou horizontalmente, com clusters ClickHouse distribuídos. Organizações com mais de 10 milhões de visualizações de página por mês devem prever servidores de base de dados dedicados e, possivelmente, separar os servidores da aplicação da infraestrutura de bases de dados.

Que vantagens de soberania dos dados traz o alojamento próprio?

Com alojamento próprio, todos os dados dos visitantes ficam na sua infraestrutura, sem qualquer partilha com terceiros. Controla a localização física dos servidores e garante o cumprimento dos requisitos de residência dos dados. Nenhum subcontratante tem acesso aos seus dados de análise, o que reduz as obrigações do artigo 28.º do RGPD. Isto é especialmente relevante para organizações europeias, em que a regulamentação exige saber exatamente onde estão os dados pessoais e quem os trata. Uma instalação própria dá total transparência sobre os fluxos de dados.

Como se compara o Plausible self-hosted com as plataformas de análise tradicionais?

O Plausible self-hosted funciona sem cookies, pelo que não precisa de banners de consentimento para a análise básica. O script leve (menos de 1 KB) carrega mais depressa do que o das plataformas mais antigas e melhora o desempenho das páginas. Por ser pensado para a privacidade, recolhe apenas as métricas essenciais, sem traçar perfis detalhados dos utilizadores. O painel simplificado foca-se em informação útil, em vez de sobrecarregar o utilizador com centenas de relatórios. No entanto, funcionalidades avançadas como a visualização de fluxos de utilizadores e a análise de coortes são mais limitadas do que nas suites de análise empresariais.

Que manutenção contínua exige o Plausible self-hosted?

A manutenção regular inclui atualizações de segurança mensais, atualizações de funcionalidades trimestrais e cópias de segurança automáticas diárias. A otimização das bases de dados deve ser feita mensalmente. A renovação dos certificados SSL é automática com o Let's Encrypt, mas convém monitorizá-la. As revisões de acessos garantem que quem sai da equipa perde o acesso ao painel. Conte com cerca de 1-2 horas por mês de manutenção de rotina, mais algum tempo pontual para resolver problemas. Instalações com muito tráfego podem exigir atenção semanal ao desempenho e à capacidade.

Posso migrar mais tarde de um serviço gerido para self-hosted?

A migração de uma solução gerida para o Plausible self-hosted é tecnicamente possível, mas tem alguma complexidade. Terá de exportar os dados históricos da plataforma atual e importá-los para a sua instância. A maioria das plataformas permite exportar, embora os formatos variem. Conte com possíveis lacunas na transição quando trocar os scripts de rastreio. Considere manter os dois sistemas em paralelo durante algum tempo para confirmar que os dados batem certo antes da mudança definitiva. A complexidade depende do volume de dados e do histórico que pretende manter.

Instalar o Plausible self-hosted dá às organizações europeias controlo total sobre a infraestrutura de análise, com um rastreio que respeita a privacidade. Quer a sua preocupação seja a soberania dos dados, eliminar dependências de terceiros ou precisar de personalizações que os serviços geridos não oferecem, o alojamento próprio é um caminho viável. Para empresas que querem os mesmos benefícios de privacidade sem o esforço operacional, a EuroMetrics oferece análise sem cookies pensada para os requisitos europeus, aliando simplicidade ao processamento de dados garantidamente na UE, em centros de dados em Paris, Frankfurt e Amesterdão.