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

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

http://your.server.ip

Після завантаження сервера Metabase може запускатися 30–60 секунд. Якщо бачите помилку підключення або “502 Bad Gateway”, зачекайте трохи й оновіть сторінку. Після завантаження ви побачите майстер налаштування.

Якщо ви розмістили сервер за маршрутизатором VyOS у приватній мережі, налаштуйте переадресацію портів (80 і 443), щоб відкривати Metabase з інтернету, або підключайтеся через VPN за приватною IP сервера.

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

Майстер налаштування проведе вас через початкову конфігурацію:

Language

Оберіть мову й натисніть Next.

Admin Account

Створіть обліковий запис адміністратора — введіть імʼя, прізвище, email, назву компанії (необовʼязково) і пароль. Це ваші дані для входу в Metabase.

Usage Info

Metabase запитує, для чого ви плануєте його використовувати. Оберіть варіант або пропустіть.

Add Your Data

Підключіть наявну базу даних для аналізу (PostgreSQL, MySQL, MongoDB тощо). Якщо її ще немає, пропустіть цей крок — Metabase надасть демонстраційну базу. Власні бази можна додати пізніше.

Usage Data Preferences

Оберіть, чи надсилати анонімну статистику використання в Metabase.

All Set Up

Налаштування завершено. Натисніть Take me to Metabase , щоб відкрити панель.

Увійдіть з email і паролем, створеними на кроці Admin Account.

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

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

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

ssh root@your.server.ip

# Update Nginx server_name with your domain
sed -i 's/server_name _;/server_name your-domain.com;/' /etc/nginx/sites-available/metabase
nginx -t && systemctl reload nginx

# Obtain a free Let's Encrypt SSL certificate
certbot --nginx -d your-domain.com

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

Підключення баз даних

Щоб додати джерело даних після початкового налаштування:

1. Натисніть іконку шестерні (угорі праворуч) → Admin settings → Databases → Add database
2. Оберіть тип бази даних (PostgreSQL, MySQL, MongoDB, SQLite тощо)
3. Введіть параметри підключення (хост, порт, імʼя бази, облікові дані)
4. Натисніть Save — Metabase автоматично синхронізує схему

Для баз на зовнішніх серверах переконайтеся, що файрвол дозволяє підключення з IP вашого сервера Metabase.

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

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

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

# Check banned IPs
fail2ban-client status sshd

# Unban an IP
fail2ban-client set sshd unbanip 1.2.3.4

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

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

Metabase працює як сервіс systemd. Корисні команди:

# Check service status
systemctl status metabase

# Restart Metabase
systemctl restart metabase

# View logs
journalctl -u metabase -f

# Nginx reverse proxy
systemctl status nginx
systemctl reload nginx

Оновлення

Щоб оновити Metabase до останньої версії:

# Stop the service
systemctl stop metabase

# Download the latest JAR (backup the current one first)
cd /opt/metabase
cp metabase.jar metabase.jar.bak
curl -L -o metabase.jar https://downloads.metabase.com/latest/metabase.jar

# Start the service
systemctl start metabase

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

apt update && apt upgrade -y

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

Metabase зберігає всі свої дані (запитання, дашборди, налаштування) у базі H2. Щоб зробити резервну копію:

# Stop Metabase before backing up
systemctl stop metabase

# Copy the database file
cp /opt/metabase/metabase.db.mv.db /root/metabase-backup-$(date +%F).db

# Start Metabase again
systemctl start metabase

Для продуктивного використання з великими наборами даних варто розглянути міграцію з H2 на PostgreSQL.

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

• Документація Metabase: metabase.com/docs
• Створення запитань: metabase.com/docs/latest/questions/start
• Побудова дашбордів: metabase.com/docs/latest/dashboards/start