Plausible na VPS: estatísticas do seu site no seu servidor
Aprenda a instalar o Plausible Community Edition na sua VPS com Docker Compose: requisitos, versão segura, BASE_URL, HTTPS, script no site e atualização.
Por Redação Eleven Host · @robson.direitodigital · 4 de novembro de 2026 · 10 min de leitura

Capa da Redação Eleven Host para o guia: Plausible na VPS: estatísticas do seu site no seu servidor Arte: Eleven Host
Plausible na VPS é o Plausible Community Edition, a versão para hospedar por conta própria, instalado no seu servidor com Docker Compose. Veja os requisitos, a instalação, o script no site e como atualizar.
Se você ainda está conhecendo o assunto, o guia O que é servidor VPS explica o básico do servidor onde a ferramenta vai ficar. Aqui o foco é o Plausible, do começo ao primeiro acesso, usando o passo a passo do repositório oficial da edição comunitária.
O que é o Plausible Community Edition
O projeto se descreve como uma ferramenta de análise web de código aberto e com foco em privacidade. O Plausible Community Edition, ou CE, é a versão gratuita para hospedar por conta própria, licenciada sob a GNU Affero General Public License versão 3 (AGPLv3) ou posterior. O mesmo código roda de dois jeitos: na nuvem do próprio projeto ou no seu servidor.
Há uma distinção de licenças que vale conhecer. O software é AGPLv3. Já o repositório community-edition, com os arquivos do Docker Compose usados na instalação, tem licença MIT, e o script de rastreio que fica no seu site também é MIT, para que o site que o incorpora não caia nas obrigações da AGPL.
Para comparar, o guia Umami na VPS: como medir as visitas do seu site e o guia Matomo na VPS: estatísticas do site no seu servidor mostram outros caminhos.
Instale a v3.2.1 ou uma versão mais nova
A versão v3.2.1 do Plausible Community Edition corrige uma falha de segurança. Instale a v3.2.1 ou uma versão mais nova, e não uma anterior.
Segundo as notas da release, a falha está registrada como CVE-2026-8467 e envolve o endereço HTTP "/storybook", que nas versões afetadas, em certas condições, permite execução remota de código com os privilégios do usuário do sistema que roda a aplicação. A v3.2.1 remove esse endereço por completo e, de acordo com as notas, não traz nenhuma outra mudança.
Quem já tem uma instalação anterior deve atualizar para a v3.2.1 o quanto antes, ainda segundo as notas. Como medida provisória, as notas sugerem bloquear o acesso ao endereço "/storybook" na configuração do proxy reverso ou por outro meio disponível.
Hospedar é um compromisso
O projeto não desaconselha instalar o CE num servidor de terceiros. A página oficial diz que você pode hospedá-lo no provedor de nuvem que quiser. Ela também avisa que hospedar por conta própria é um compromisso real, e que uma correção de segurança só protege a sua instalação depois que você aplica a release. A responsabilidade de atualizar é de quem hospeda.
Requisitos para instalar
O README da v3.2.1 lista o que a máquina precisa ter:
- Docker e Docker Compose instalados;
- processador com suporte ao conjunto de instruções SSE 4.2 ou NEON, ou superior, exigência do ClickHouse;
- pelo menos 2 GB de RAM são recomendados para rodar o ClickHouse e o Plausible sem sustos de falta de memória;
- um domínio com entrada DNS apontando para o servidor, para a resolução funcionar direito.
Se você for ativar o banco de cidades do MaxMind (mais adiante), o aviso da wiki é que bancos no nível de cidade, como o GeoLite2-City, pedem cerca de 1 GB a mais de RAM.
Para o domínio, o guia Nginx Proxy Manager: vários sites numa VPS só mostra como colocar um proxy reverso na frente de vários serviços, caso o Plausible divida o servidor com outros sites.
Em que servidor ficam as suas ferramentas hoje? VPS a partir de R$ 17,00/mês no Plano Bronze; confira na loja o que cada plano inclui. Ver as VPS
Instalação com Docker Compose, passo a passo
Os comandos abaixo seguem o README da v3.2.1. Rode-os num terminal do servidor, com Docker já instalado. Primeiro, baixe o repositório na tag v3.2.1 e entre na pasta:
git clone -b v3.2.1 --single-branch https://github.com/plausible/community-edition plausible-ce
cd plausible-ce
A pasta traz a subpasta clickhouse e os arquivos compose.yml, LICENSE e README.md. Em seguida, crie o arquivo .env com as duas variáveis obrigatórias:
touch .env
echo "BASE_URL=https://plausible.example.com" >> .env
echo "SECRET_KEY_BASE=$(openssl rand -base64 48)" >> .env
Troque plausible.example.com pelo domínio onde você pretende hospedar o serviço. A documentação pede que a BASE_URL seja o domínio real. O SECRET_KEY_BASE precisa ter pelo menos 64 bytes, e o comando acima gera um valor único. Confira o resultado com cat .env.
Portas, HTTPS e proxy reverso
Para o Plausible servir o site diretamente, o README manda definir as portas no .env e mapeá-las no Compose:
echo "HTTP_PORT=80" >> .env
echo "HTTPS_PORT=443" >> .env
Depois, crie o arquivo compose.override.yml com um serviço plausible que publica as portas 80:80 e 443:443. Um exemplo de comando que cria o arquivo de uma vez, com a indentação do YAML:
printf 'services:\n plausible:\n ports:\n - 80:80\n - 443:443\n' > compose.override.yml
Com HTTP_PORT=80 e HTTPS_PORT=443, o Plausible emite sozinho o certificado TLS do Let's Encrypt. Por isso o DNS do domínio precisa apontar para o servidor antes de subir. Para ligar tudo:
docker compose up -d
Se houver um proxy reverso na frente, use outras portas para o Plausible; a wiki do projeto tem uma página sobre proxy reverso.
No fim, abra o endereço da BASE_URL no navegador e crie o primeiro usuário.
Registro de usuários e variáveis do .env
As variáveis da wiki de configuração podem ser colocadas no mesmo arquivo .env criado na instalação. As que mais importam no começo:
BASE_URL: endereço usado na geração de links. Não tem padrão e precisa ser informada;SECRET_KEY_BASE: segredo das sessões do painel. Precisa de pelo menos 64 bytes e não tem padrão;DISABLE_REGISTRATION: restringe o cadastro de novos usuários. Aceitatrue(restrição total),false(sem restrição) einvite_only(só convidados), que é o padrão.
Como o padrão é invite_only, pessoas de fora não se cadastram sozinhas na sua instância.
E-mail e SMTP
O Plausible pode enviar e-mails. Na wiki, SMTP_HOST_ADDR define o servidor SMTP (sem ele, o cliente tenta enviar diretamente), SMTP_HOST_PORT a porta (padrão 587), SMTP_USER_NAME e SMTP_USER_PWD o usuário e a senha, e MAILER_EMAIL o remetente.
Geolocalização com MaxMind (opcional)
Sem configurar nada, o Plausible usa o banco de países que já vem na imagem do contêiner. Para ter mais detalhe, a wiki ensina a usar o GeoLite2 da MaxMind: crie uma conta no site da MaxMind, gere uma chave de licença e acrescente duas variáveis ao .env. A edição padrão é a GeoLite2-City. Com a chave definida, o Plausible baixa o banco e o mantém atualizado.
cd plausible-ce
echo "MAXMIND_LICENSE_KEY=SUA_CHAVE" >> .env
echo "MAXMIND_EDITION=GeoLite2-City" >> .env
docker compose up -d
Para conferir se a chave chegou ao contêiner, use docker compose exec plausible env | grep MAXMIND_LICENSE_KEY. Lembre do aviso dos requisitos: o banco de cidades pede cerca de 1 GB a mais de RAM.
Colocar o script de rastreio no site
Com a instância no ar, adicione o seu site no painel. O trecho de código de rastreio, o snippet, aparece ali na hora de adicionar o site, e depois pode ser revisto em General, Tracking, Site installation. Copie o snippet que o seu painel mostra e cole dentro da tag <head> das páginas, como orienta a documentação do Plausible.
Segundo o guia de integrações do projeto, você pode inserir o snippet manualmente no cabeçalho (head) do seu site.
Cookies e privacidade, segundo o Plausible
Segundo o próprio Plausible, a ferramenta não usa cookies nem outros identificadores persistentes, e por isso nenhum banner de consentimento seria necessário. O projeto afirma que isso o deixa em conformidade com leis de cookies e regulamentos de privacidade como GDPR, CCPA e PECR.
São declarações do projeto, e a leitura jurídica do seu caso, inclusive diante da legislação brasileira, é uma decisão sua. A página oficial também diz que você tem controle total e pode escolher o país do servidor.
Como atualizar o Plausible
Cada release traz instruções próprias para subir da versão anterior, e subir de uma versão maior (por exemplo, da v1.x para a v2.x) pode exigir passos extras, como migração de dados. A wiki orienta a ler as instruções da release antes de atualizar. Para uma versão menor, o procedimento da wiki é puxar a nova versão do repositório e reiniciar os contêineres, com este formato (o número da versão é de exemplo):
cd plausible-ce
git pull origin v2.1.4
docker compose up -d
Troque o número pela versão para a qual você vai subir.
Atenção às mudanças de configuração
As notas da v3.2.0 avisam que as configurações do ClickHouse mudaram. Nessa versão, era preciso fazer o checkout da branch v3.2.0 do repositório community-edition, e não apenas trocar a tag da imagem, e reaplicar mudanças locais feitas em arquivos versionados. Leia as notas da versão de destino antes de atualizar.
Plausible CE ou Plausible na nuvem
A tabela de comparação do projeto resume o que muda ao hospedar por conta própria:
- recursos premium, como funis de marketing, metas de receita de e-commerce, SSO e API de sites, não estão disponíveis na CE;
- não há suporte premium: o suporte à CE é feito pela comunidade;
- os custos são seus: servidor, CDN, backups e o que mais surgir.
A página oficial fecha dizendo que a hospedagem própria funciona bem quando você trata a instância como infraestrutura que mantém, e não como software que instala uma vez.
Cuide dos seus backups
A página oficial lembra que, ao hospedar, os backups são seus, junto com a disponibilidade do servidor e a capacidade de atender ao seu tráfego. Isso significa planejar cópias de segurança da sua instalação e testar a restauração.
Resumo da instalação
Clone a tag v3.2.1, crie o .env com BASE_URL e SECRET_KEY_BASE, defina as portas, suba com Docker Compose, crie o primeiro usuário e cole o snippet no head do site.
Como está o servidor que você usa hoje? VPS a partir de R$ 17,00/mês no Plano Bronze; confira na loja o que cada plano inclui. Conhecer as VPS
Perguntas frequentes
O Plausible é gratuito na VPS?
O software da edição comunitária é gratuito e de código aberto, sob a AGPLv3. O custo está no servidor, em eventuais CDN e backups e no seu tempo para manter a instância.
Qual versão devo instalar?
A v3.2.1 ou uma mais nova. A v3.2.1 corrige uma falha de segurança presente nas versões anteriores.
Preciso de um domínio?
Sim, para o fluxo descrito aqui. A BASE_URL precisa do domínio real, e o certificado automático do Let's Encrypt depende de o DNS apontar para o servidor.
Posso usar o Plausible por trás de um proxy reverso?
Pode. Nesse caso, use outras portas no Plausible. A wiki do projeto tem uma página sobre o assunto.
Quem atualiza o Plausible?
Quem hospeda. A página oficial diz que, numa instância própria, a correção só protege você depois que você aplica a release.