Крок 1 — перевірте, що Matomo працює

IP-адресу сервера й пароль root показано на сторінці Server Details у клієнтській панелі. Відкрийте браузер і перейдіть за адресою:

http://your.server.ip

Ви маєте побачити вітальну сторінку майстра налаштування Matomo. Якщо сторінка завантажується, Matomo працює правильно — перейдіть до кроку 2, щоб отримати дані бази даних перед завершенням майстра.

Якщо ви розмістили сервер за маршрутизатором VyOS у приватній мережі, налаштуйте переадресацію портів 22 (SSH), 80 (HTTP) і 443 (HTTPS). Matomo має бути доступним з інтернету, щоб отримувати дані відстеження з ваших сайтів.

Крок 2 — отримайте дані бази даних

Базу даних для Matomo вже створено на сервері. Підключіться через SSH, щоб побачити облікові дані:

ssh root@your.server.ip

Після входу ви побачите вітальне повідомлення з даними бази даних:

=== Matomo Web Analytics ===

Open http://your.server.ip to complete setup wizard

Database credentials for setup wizard:
  Server:   localhost
  Login:    matomo
  Password: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
  Database: matomo
  Prefix:   matomo_

Збережіть ці дані — вони знадобляться на наступному кроці.

Крок 3 — завершіть майстер налаштування

Поверніться до майстра налаштування Matomo в браузері. Майстер проведе вас через початкове налаштування:

System Check

Matomo перевіряє, що всі вимоги виконано. Можливе попередження про SSL — це нормально, SSL можна налаштувати пізніше. Натисніть Next.

Database Setup

Введіть такі параметри підключення:

Creating the Tables

Matomo автоматично створить потрібні таблиці бази даних. Натисніть Next.

Super User

Створіть обліковий запис адміністратора — введіть логін, пароль і email. Це ваші дані для входу в Matomo.

Set Up a Website

Додайте перший сайт для відстеження — введіть назву та URL сайту. Інші сайти можна додати пізніше.

Tracking Code

Matomo покаже фрагмент JavaScript-коду відстеження. Скопіюйте його й вставте перед закривальним тегом </head> на кожній сторінці сайту, який хочете відстежувати. Це також можна зробити пізніше з панелі Matomo.

Congratulations

Налаштування завершено. Натисніть Continue to Matomo і увійдіть з щойно створеними даними суперкористувача.

Крок 4 — налаштуйте домен і SSL (необовʼязково)

Щоб використовувати Matomo з власним доменом і HTTPS:

1. Створіть A-запис у налаштуваннях DNS, що вказує домен на IP сервера
2. Дочекайтеся оновлення DNS (зазвичай від кількох хвилин до кількох годин)
3. Підключіться через SSH і запустіть Certbot, щоб отримати безкоштовний SSL-сертифікат Let’s Encrypt:

certbot --apache -d your-domain.com

Certbot автоматично налаштує Apache для HTTPS і автоматичне поновлення сертифіката.

Після отримання сертифіката додайте домен до списку довірених хостів Matomo: перейдіть у Administration → System → General Settings → Trusted Matomo hostname.

Fail2Ban — захист від підбору паролів

Сервер постачається з Fail2Ban , попередньо налаштованим для захисту SSH від підбору паролів.

Корисні команди:

# Check banned IPs
fail2ban-client status sshd

# Unban an IP
fail2ban-client set sshd unbanip 1.2.3.4

Якщо ви випадково заблокували себе, підключіться через VNC-консоль у клієнтській панелі й розблокуйте свою IP.

Керування сервісами

# Check service status
systemctl status apache2
systemctl status mysql

# Restart services
systemctl restart apache2
systemctl restart mysql

# Apache error log
tail -f /var/log/apache2/error.log

Додавання сайтів

Один екземпляр Matomo може відстежувати кілька сайтів. Перейдіть у Administration → Measurables → Manage → Add a new measurable , щоб додати сайти. Кожен сайт отримує власний код відстеження й окремі аналітичні дані.

Керування користувачами

Щоб додати учасників команди з різними рівнями доступу:

1. Перейдіть у Administration → System → Users
2. Натисніть Add a new user
3. Задайте імʼя користувача, email і пароль
4. Призначте права: View, Write, Admin або Super User для кожного сайту

Оновлення

Matomo показує сповіщення про оновлення на панелі адміністратора. Щоб оновити:

1. Перейдіть у Administration → Platform → Marketplace
2. Якщо доступне оновлення ядра, виконайте інструкції на екрані

Щоб оновити системні пакети через SSH:

apt update && apt upgrade -y

Резервні копії

Щоб вручну створити резервну копію бази даних Matomo:

mysqldump -u root matomo > /root/matomo-backup-$(date +%F).sql

Файл конфігурації Matomo розташовано в /var/www/html/config/config.ini.php. Включайте його в резервні копії.

Встановлене ПЗ

• Документація Matomo: matomo.org/docs
• Matomo FAQ: matomo.org/faq
• Документація для розробників Matomo: developer.matomo.org