Matomo na VPS: estatísticas do site no seu servidor
Veja como instalar o Matomo numa VPS com Docker Compose: requisitos, exemplo de compose, HTTPS com proxy, código de rastreamento, WordPress, cron e privacidade.
Por Redação Eleven Host · @robson.direitodigital · 2 de novembro de 2026 · 10 min de leitura

Capa da Redação Eleven Host para o guia: Matomo na VPS: estatísticas do site no seu servidor Arte: Eleven Host
Matomo na VPS é a opção de quem quer as estatísticas do site no próprio servidor, em vez de ferramentas de estatística de terceiros. O guia mostra um exemplo com Docker, o HTTPS, o código de rastreamento e os cuidados com privacidade.
Você vê a licença, as versões, os requisitos, como subir o sistema e como agendar os relatórios. Se você ainda não conhece o servidor VPS, comece por O que é servidor VPS: guia simples para iniciantes. Os exemplos usam estatisticas.exemplo.com como endereço fictício.
O que é o Matomo e qual é a licença
A página de requisitos do projeto o descreve com a frase "Matomo is a Web Analytics platform designed for speed".
Na página sobre software livre, o projeto diz que escolheu de propósito a GNU General Public License v3 (ou posterior) para o núcleo. O arquivo LICENSE do repositório traz o texto da GNU GPL, versão 3, de 29 de junho de 2007. Em caso de dúvida sobre uso comercial, consulte um profissional.
Versão e requisitos
Na versão 5.14.2, de 22 de outubro, segundo a página de releases do projeto no GitHub, o Matomo aparece marcado como "Latest". A mesma página lista pré-lançamentos da linha 6, como o release candidate 6.0.0-rc1, de 30 de outubro, e versões beta e alpha. Não há versão 6 estável nessa página, e o exemplo abaixo usa a 5.14.2.
A página de requisitos pede, para o Matomo 4.16 e o 5, PHP 8 e MySQL 5.5 ou superior, ou MariaDB. Para o Matomo 6, pede PHP 8.1 ou superior e MySQL 8.0 ou superior, ou MariaDB 10.6 ou superior. A imagem do banco no exemplo abaixo é mariadb:lts, a mesma do compose oficial; confira a versão que ela traz antes de instalar.
O PHP precisa das extensões pdo e pdo_mysql, ou da mysqli, e a página recomenda também curl, gd, cli, mysql, xml e mbstring. O servidor web pode ser Apache, Nginx, IIS, LiteSpeed ou similar.
Para até 100 mil pageviews por mês, a página indica como configuração mínima recomendada do servidor da aplicação 2 CPU, 2 GB de RAM e 50 GB de disco SSD. Esse é o dimensionamento da documentação do Matomo, não uma indicação de plano da Eleven Host.
Quer ter um servidor só seu para rodar o Matomo? VPS a partir de R$ 17,00/mês no Plano Bronze; confira na loja o que cada plano inclui. Ver os planos de VPS
Um exemplo de docker-compose.yml para o Matomo
O Docker Hub oficial da imagem matomo usa um volume para guardar os dados, com o exemplo -v matomo:/var/www/html, e aceita as variáveis MATOMO_DATABASE_* para ligar o banco. O repositório oficial traz um compose de exemplo na pasta .examples, com Nginx e FPM, que exige um arquivo matomo.conf para o Nginx. Por isso, o exemplo abaixo, adaptado do oficial, usa a imagem com Apache e dispensa o serviço web. O serviço db é igual ao do arquivo oficial.
Crie uma pasta, salve o conteúdo abaixo como docker-compose.yml e mantenha a indentação:
services:
db:
image: mariadb:lts
command: --max-allowed-packet=64MB
restart: always
volumes:
- db:/var/lib/mysql:Z
environment:
- MARIADB_AUTO_UPGRADE=1
- MARIADB_DATABASE=matomo
- MARIADB_DISABLE_UPGRADE_BACKUP=1
- MARIADB_INITDB_SKIP_TZINFO=1
- MARIADB_PASSWORD=${MARIADB_PASSWORD}
- MARIADB_ROOT_PASSWORD=${MARIADB_ROOT_PASSWORD}
- MARIADB_USER=matomo
app:
image: matomo:5.14.2-apache
restart: always
depends_on:
- db
volumes:
- matomo:/var/www/html
environment:
- MATOMO_DATABASE_ADAPTER=mysql
- MATOMO_DATABASE_DBNAME=matomo
- MATOMO_DATABASE_HOST=db
- MATOMO_DATABASE_PASSWORD=${MARIADB_PASSWORD}
- MATOMO_DATABASE_TABLES_PREFIX=matomo_
- MATOMO_DATABASE_USERNAME=matomo
ports:
- 127.0.0.1:8080:80
volumes:
db:
matomo:
A tag 5.14.2-apache está entre as tags oficiais da imagem no Docker Hub. A porta 80 do contêiner fica publicada na 8080, mas só no endereço local do servidor (127.0.0.1). O repositório oficial também traz a variante com Nginx e FPM, para quem prefere esse caminho.
Não abra a porta 8080 para a internet. O compose oficial publica essa porta sem HTTPS, e por isso o exemplo a prende ao endereço local, deixando o acesso externo para um proxy reverso com certificado.
Senhas no arquivo .env
O compose lê as senhas das variáveis ${MARIADB_PASSWORD} e ${MARIADB_ROOT_PASSWORD}. Crie um arquivo .env na mesma pasta, com uma linha no formato NOME=valor para cada uma, e troque o valor por uma senha forte:
MARIADB_PASSWORD=valor
MARIADB_ROOT_PASSWORD=valor
Não coloque esse arquivo em repositório de código. Depois, suba os serviços:
docker compose up -d
Como a porta está presa ao endereço local, o instalador só abre pelo próprio servidor até o proxy estar pronto.
Colocar o HTTPS na frente
Para acessar o Matomo de fora com HTTPS, coloque na frente um proxy reverso com certificado e encaminhe o seu domínio para a porta 8080 do servidor. O guia Nginx Proxy Manager: vários sites numa VPS só pode ajudar nessa parte.
O próprio matomo.org exibe um aviso sobre duas vulnerabilidades de alta gravidade que afetam o PHP e recomenda que quem hospeda o Matomo reveja as atualizações de segurança do PHP. Mantenha o PHP atualizado.
O instalador do Matomo, passo a passo
Com o endereço aberto, o instalador web segue estas etapas, segundo a página de instalação do Matomo:
- Checagem do sistema contra os requisitos, com orientação se algo falhar.
- Dados do banco MySQL. O banco já deve existir, a porta padrão é a 3306, e a página recomenda um banco e um usuário dedicados só ao Matomo. No exemplo, o compose cria o banco
matomoe o usuáriomatomo, e o host do banco édb. - Criação das tabelas.
- Superusuário, com usuário e senha. A página avisa que essa é a única forma de entrar na primeira vez e pede para não perder a informação.
- Primeiro site, com nome e URL. Dá para adicionar outros depois.
- Código de rastreamento em JavaScript, para colar em todas as páginas.
- Acesso ao painel.
Copie o código pronto que o instalador gera, em vez de digitar. Ele traz o endereço do seu Matomo e o id do site. O guia de rastreamento do projeto aceita o código logo depois da abertura da tag <body> ou dentro da seção <head>.
Matomo e WordPress
O Matomo tem dois plugins oficiais para o WordPress, e a escolha depende de onde o Matomo roda. O Matomo for WordPress, listado no wordpress.org como Matomo Analytics, instala uma versão completa do Matomo no mesmo servidor do WordPress. É a versão do núcleo, sem os recursos premium. Ele pede WordPress 4.8 ou superior.
O Connect Matomo, antigo WP-Matomo, serve para conectar um Matomo que já existe, no seu servidor ou na nuvem do projeto. Esse é o caso de quem tem o Matomo na VPS, separado do site. O Matomo for WordPress só passa para o Matomo 6 quando o servidor atende aos requisitos da linha 6.
Se quiser conhecer outra ferramenta, o guia Umami na VPS: como medir as visitas do seu site apresenta outra opção para medir as visitas.
Arquivamento dos relatórios por cron
A documentação diz que, se o site tem mais de algumas centenas de visitas por dia, o processamento dos relatórios pelo navegador pode levar minutos. Para tráfego médio ou alto, ela recomenda que as requisições da interface não disparem o arquivamento, e que ele rode por um agendamento (cron) com este comando:
/usr/bin/php /path/to/matomo/console core:archive --url=http://example.org/matomo/
Os caminhos e o endereço são os do exemplo da documentação, e você ajusta ao seu caso. O exemplo de crontab da página roda o comando no minuto 5 de cada hora. A opção --url está marcada como obsoleta desde o Matomo 5, e a opção --matomo-domain a substitui.
Para desligar o arquivamento pelo navegador, vá em Administração, Sistema, Configurações gerais. Em "Archive reports when viewed from the browser", marque "No", e em "Archive reports at most every X seconds", use 3600. Para bloquear de vez, inclusive nos segmentos personalizados, adicione esta linha ao config.ini.php, na seção [General]:
browser_archiving_disabled_enforce = 1
Privacidade e consentimento
A documentação do Matomo traz recursos de privacidade que você configura no painel:
- Anonimizar o IP: em Administração, Privacidade, "Anonymize data". O padrão mascara 2 bytes, e é possível mascarar 3 bytes para mais privacidade, ou mascarar o IP por completo e guardá-lo como 0.0.0.0.
- Opt-out: em Administração, Privacidade, "Users opt-out", você copia o código do formulário para o site. Quem opta por sair recebe o cookie
mtm_consent_removede deixa de ser rastreado. - Dados brutos antigos: a seção "Regularly delete old raw data" sugere manter os logs detalhados por só 3 a 6 meses.
- Consentimento: o rastreamento tem funções como
requireConsent,requireCookieConsent,setConsentGivenerememberConsentGiven. ComrequireCookieConsent, o rastreamento acontece sem cookie até a pessoa aceitar.
A opção Do Not Track está marcada como obsoleta, e o projeto deixou de recomendar a sua ativação. A necessidade de consentimento depende do seu caso. Para adequação à LGPD, consulte um profissional.
Backup do Matomo
A documentação de backup lista o que guardar: o banco de dados MySQL com as tabelas do Matomo, o arquivo config/config.ini.php e os plugins instalados pelo Marketplace, que ficam na pasta plugins. O config.ini.php contém a senha do banco, então ele merece o mesmo cuidado do banco. Para restaurar, importe a cópia do banco num banco novo e copie o config.ini.php para a instalação nova, ajustando a conexão se ela mudou.
Checklist do Matomo na VPS
.envcom senhas fortes, fora de repositório.- Porta 8080 presa ao endereço local (
127.0.0.1), sem abrir para a internet. - Proxy reverso com certificado na frente, e o domínio apontado para o IP da VPS.
- Instalador concluído, com o superusuário e a senha guardados.
- Código de rastreamento copiado do instalador, colado em todas as páginas.
- Arquivamento por cron configurado, se o tráfego pedir.
- Privacidade e consentimento revisados.
- Cópia do banco, do
config.ini.phpe dos plugins guardada.
Já escolheu onde o seu projeto vai ficar? VPS a partir de R$ 17,00/mês no Plano Bronze; confira na loja o que cada plano inclui. Conhecer os planos
Perguntas frequentes
O que é o Matomo?
É uma plataforma de Web Analytics, como o próprio projeto a descreve. Instalada na VPS, ela roda no seu servidor.
O Matomo é software livre?
O núcleo usa a licença GNU GPL v3 ou posterior, segundo a página de software livre do projeto. Em caso de dúvida sobre uso comercial, consulte um profissional.
Qual versão do Matomo usar?
Segundo a página de releases, a 5.14.2, de 22 de outubro, é a versão estável marcada como "Latest". A linha 6 tem apenas pré-lançamentos nessa página.
Posso usar o Matomo com WordPress?
Sim. Com o Matomo na VPS, o plugin Connect Matomo conecta o WordPress a ele. O plugin Matomo for WordPress instala o Matomo no mesmo servidor do site.
O Matomo deixa o site em conformidade com a LGPD?
O Matomo oferece recursos como máscara de IP, opt-out, consentimento e exclusão de dados antigos, mas a decisão depende do seu caso. Para adequação à LGPD, consulte um profissional.