Instalação Matomo · 8 min read · Nov 30, 2025

Como Instalar Matomo Web Analytics no Debian 11

Matomo, anteriormente conhecido como Piwik, é um aplicativo de análise da web gratuito e de código aberto desenvolvido por uma comunidade de desenvolvedores. Ele é usado para rastrear seu site e fornecer informações detalhadas sobre seu site e seus visitantes, incluindo os mecanismos de busca e palavras-chave que usaram, o idioma que falam, quais páginas gostam, os arquivos que baixam e muito mais. Ele oferece muitos recursos, incluindo Google AdWords, Facebook Ads, Yahoo, Marketing de Busca, API de Rastreamento e Relatórios, e Custo Por Clique (CPC).

Neste tutorial, vou mostrar como instalar o Matomo no Debian 11 com um servidor web Apache2 e um certificado SSL gratuito do Let’s Encrypt.

Pré-requisitos

  • Um servidor rodando Debian 11.
  • Um nome de domínio válido apontado para o IP do seu servidor.
  • Uma senha de root configurada no servidor.

Instalar Apache, MariaDB e PHP

Primeiro, você precisará instalar o servidor web Apache, o servidor de banco de dados MariaDB, PHP e outras extensões PHP no seu servidor. Você pode instalar todos eles executando o seguinte comando:

apt-get install apache2 mariadb-server php libapache2-mod-php php-cli php-fpm php-fpm php-json php-json php-common php-mysql php-zip php-gd php-mbstring php-curl php-xml php-pear php-bcmath curl unzip -y

Após instalar todos os pacotes, inicie e habilite os serviços Apache e MariaDB usando o seguinte comando:

systemctl start apache2 mariadb  
systemctl enable apache2 mariadb

Uma vez que você tenha terminado, pode prosseguir para a próxima etapa.

Criar um Banco de Dados MariaDB para Matomo

Matomo usa um MariaDB como backend de banco de dados. Portanto, você precisará criar um banco de dados e um usuário para o Matomo.

Primeiro, faça login no MariaDB com o seguinte comando:

mysql

Uma vez logado, crie um banco de dados e um usuário com o seguinte comando:

MariaDB [(none)]> CREATE DATABASE matomodb;  
MariaDB [(none)]> CREATE USER 'matomo'@'localhost' IDENTIFIED BY 'password';

Em seguida, conceda todas as permissões ao banco de dados Matomo com o seguinte comando:

MariaDB [(none)]> GRANT ALL ON matomodb.* TO 'matomo'@'localhost' WITH GRANT OPTION;

Em seguida, limpe as permissões e saia do shell do MariaDB com o seguinte comando:

MariaDB [(none)]> FLUSH PRIVILEGES;  
MariaDB [(none)]> EXIT;

Após configurar o banco de dados MariaDB, você pode prosseguir para a próxima etapa.

Baixar Matomo

Em seguida, visite o site oficial do Matomo e baixe a versão mais recente do Matomo com o seguinte comando:

wget http://builds.matomo.org/matomo-latest.zip

Uma vez que o download esteja completo, descompacte o arquivo baixado com o seguinte comando:

unzip matomo-latest.zip

Em seguida, mova o diretório extraído para o diretório raiz do Apache:

mv matomo /var/www/html/matomo

Em seguida, altere a propriedade e as permissões do diretório Matomo:

chown -R www-data:www-data /var/www/html/matomo  
chmod -R 755 /var/www/html/matomo

Uma vez que você tenha terminado, pode prosseguir para a próxima etapa.

Configurar Apache para Matomo

Em seguida, você precisará criar um arquivo de configuração de host virtual do Apache para hospedar o Matomo na internet. Você pode criá-lo com o seguinte comando:

nano /etc/apache2/sites-available/matomo.conf

Adicione as seguintes linhas:



ServerAdmin [email protected]
ServerName matomo.example.com
DocumentRoot /var/www/html/matomo/


DirectoryIndex index.php
Options FollowSymLinks
AllowOverride All
Require all granted



Options None
Require all denied



Options None
Require all granted



Options None
Require all denied



Options None
Require all denied


ErrorLog ${APACHE_LOG_DIR}/matomo_error.log
CustomLog ${APACHE_LOG_DIR}/matomo_access.log combined

Salve e feche o arquivo quando terminar, então ative o host virtual do Matomo e o módulo de reescrita do Apache com o seguinte comando:

a2ensite matomo.conf  
a2enmod rewrite

Em seguida, reinicie o serviço Apache para aplicar as alterações:

systemctl restart apache2

Você também pode verificar o status do Apache com o seguinte comando:

systemctl status apache2

Você receberá a seguinte saída:

? apache2.service - The Apache HTTP Server
     Loaded: loaded (/lib/systemd/system/apache2.service; enabled; vendor preset: enabled)
     Active: active (running) since Sun 2022-03-06 06:33:24 UTC; 5s ago
       Docs: https://httpd.apache.org/docs/2.4/
    Process: 55482 ExecStart=/usr/sbin/apachectl start (code=exited, status=0/SUCCESS)
   Main PID: 55486 (apache2)
      Tasks: 6 (limit: 4679)
     Memory: 12.4M
        CPU: 108ms
     CGroup: /system.slice/apache2.service
             ??55486 /usr/sbin/apache2 -k start
             ??55487 /usr/sbin/apache2 -k start
             ??55488 /usr/sbin/apache2 -k start
             ??55489 /usr/sbin/apache2 -k start
             ??55490 /usr/sbin/apache2 -k start
             ??55491 /usr/sbin/apache2 -k start

Mar 06 06:33:24 debian11 systemd[1]: Starting The Apache HTTP Server...
Mar 06 06:33:24 debian11 apachectl[55485]: AH00558: apache2: Could not reliably determine the server's fully qualified domain name, using 209>
Mar 06 06:33:24 debian11 systemd[1]: Started The Apache HTTP Server.

Acessar a Interface Web do Matomo

Agora, abra seu navegador e acesse a interface web do Matomo usando a URL http://matomo.example.com. Você será redirecionado para a seguinte página:

Instalador web do Matomo

Clique no botão Próximo. Você deve ver a página de verificação da configuração do PHP:

Verificação da configuração do PHP

Certifique-se de que todas as configurações estão corretas e clique no botão PRÓXIMO. Você deve ver a página de configuração do banco de dados MariaDB:

Configuração do banco de dados

Forneça seu servidor de banco de dados, nome de usuário, nome do banco de dados, senha e clique no botão PRÓXIMO. Você deve ver a seguinte página:

Criando tabelas do banco de dados

Clique no botão PRÓXIMO. Você deve ver a página de criação do Super Usuário:

Super usuário do Matomo

Forneça seu nome de usuário de administrador, senha, e-mail e clique no botão PRÓXIMO. Você deve ver a página de configuração do site:

Configuração de um site

Forneça o nome do seu site, URL, fuso horário e clique no botão PRÓXIMO. Você deve ver a seguinte página:

Código de rastreamento

Clique no botão PRÓXIMO. Você deve ver a página de verificação da configuração:

Configurações do Matomo

Clique em CONTINUAR PARA MATOMO. Você deve ver a página de login do Matomo:

Login do Matomo

Forneça seu nome de usuário de administrador, senha e clique no botão ENTRAR. Você deve ver o painel do Matomo na seguinte página: Agora você pode copiar o código de rastreamento mostrado na imagem acima e colá-lo em todas as páginas do seu site.

Painel do Matomo

Proteger Matomo com SSL do Let’s Encrypt

Em seguida, você precisará instalar o cliente Certbot para instalar o SSL do Let’s Encrypt para seu site. Você pode instalá-lo com o seguinte comando:

dnf install epel-release -y dnf install certbot python3-certbot-apache

Em seguida, obtenha e instale um certificado SSL para seu domínio com o seguinte comando:

certbot --apache -d matomo.example.com

Você será solicitado a fornecer seu endereço de e-mail e aceitar os termos de serviço:

Saving debug log to /var/log/letsencrypt/letsencrypt.log
Plugins selected: Authenticator apache, Installer apache
Enter email address (used for urgent renewal and security notices)
 (Enter 'c' to cancel): [email protected]

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Please read the Terms of Service at
https://letsencrypt.org/documents/LE-SA-v1.2-November-15-2017.pdf. You must
agree in order to register with the ACME server. Do you agree?
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
(Y)es/(N)o: Y

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Would you be willing, once your first certificate is successfully issued,
to share your email address with the Electronic Frontier Foundation, a founding
partner of the Let's Encrypt project and the non-profit organization that
develops Certbot? We'd like to send you email about our work encrypting the web,
EFF news, campaigns, and ways to support digital freedom.
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
(Y)es/(N)o: Y
Account registered.
Requesting a certificate for matomo.example.com
Performing the following challenges:
http-01 challenge for matomo.example.com
Waiting for verification...
Cleaning up challenges
Deploying Certificate to VirtualHost /etc/httpd/conf.d/matomo.conf
Redirecting all traffic on port 80 to ssl in /etc/httpd/conf.d/matomo.conf

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Congratulations! You have successfully enabled https://matomo.example.com
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Subscribe to the EFF mailing list (email: [email protected]).


IMPORTANT NOTES:
 - Congratulations! Your certificate and chain have been saved at:
   /etc/letsencrypt/live/matomo.example.com/fullchain.pem
   Your key file has been saved at:
   /etc/letsencrypt/live/matomo.example.com/privkey.pem
   Your certificate will expire on 2022-05-09. To obtain a new or
   tweaked version of this certificate in the future, simply run
   certbot again with the "certonly" option. To non-interactively
   renew *all* of your certificates, run "certbot renew"
 - If you like Certbot, please consider supporting our work by:

   Donating to ISRG / Let's Encrypt:   https://letsencrypt.org/donate
   Donating to EFF:                    https://eff.org/donate-le

Conclusão

Parabéns! você instalou com sucesso o Matomo no Debian 11. Agora você pode adicionar o código de rastreamento ao seu site e começar a monitorá-lo a partir do painel do Matomo. Sinta-se à vontade para me perguntar se você tiver alguma dúvida.

Share: X/Twitter LinkedIn
#Instalação Matomo

Receba novas postagens na sua caixa de entrada

Sem spam. Cancele a assinatura a qualquer momento.