Base de Conhecimento

Matomo na VPS: estatísticas do site no seu servidor

  • matomo, analytics, docker, vps, privacidade
  • Usuários acharam útil: 0

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

Arte da Eleven Host: janela de terminal com o título: Matomo na VPS: estatísticas do site no seu servidor

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:

  1. Checagem do sistema contra os requisitos, com orientação se algo falhar.
  2. 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 matomo e o usuário matomo, e o host do banco é db.
  3. Criação das tabelas.
  4. 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.
  5. Primeiro site, com nome e URL. Dá para adicionar outros depois.
  6. Código de rastreamento em JavaScript, para colar em todas as páginas.
  7. 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_removed e 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, setConsentGiven e rememberConsentGiven. Com requireCookieConsent, 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

  • .env com 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.php e 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.

Esta resposta lhe foi útil?

Artigos Relacionados