Установка и развёртывание

Metriqa поставляется в виде Docker-стека. Развёртывание выполняется на серверe под Linux. Рекомендуем использовать российские дистрибутивы (Astra Linux, Alt Linux, РЕД ОС).

Перед началом: убедитесь что установлены Docker (версия 24+) и Docker Compose v2. Документация Docker для российских ОС — на сайтах Astra Linux и Alt Linux.

Шаг 1. Системные требования

Минимальная конфигурация сервера:

Параметр	Значение
Процессор	4 vCPU x86_64
Оперативная память	8 ГБ
Дисковое пространство	100 ГБ SSD (свободное)
Сетевой канал	от 100 Мбит/с
Открытые порты	80, 443 (входящие)

Шаг 2. Получение дистрибутива

Скачайте архив с дистрибутивом:

wget https://metriqa.kayaniq.ru/dist/metriqa-latest.tar.gz
tar xzf metriqa-latest.tar.gz
cd metriqa

Шаг 3. Настройка переменных окружения

Скопируйте файл-шаблон и заполните параметры:

cp .env.example .env
nano .env

Обязательные параметры:

Переменная	Описание
`POSTGRES_PASSWORD`	Пароль для базы PostgreSQL (произвольный, минимум 16 символов)
`CLICKHOUSE_PASSWORD`	Пароль для базы ClickHouse
`JWT_SECRET`	Секрет для JWT токенов (произвольная строка от 32 символов)
`ADMIN_LOGIN`	Логин администратора панели (по умолчанию `admin`)
`ADMIN_PASSWORD`	Пароль администратора
`PUBLIC_BASE_URL`	Публичный URL вашего сервера (например `https://metriqa.example.ru`)

Шаг 4. Запуск стека

# Запуск всех сервисов
docker compose -f docker-compose.yml -f docker-compose.prod.yml up -d

# Проверка статуса контейнеров
docker compose ps

# Просмотр логов
docker compose logs -f

После запуска система будет доступна по адресу http://<ваш-сервер>.

Шаг 5. Настройка HTTPS

Для production-окружения с доменом, на который настроены DNS-записи:

make ssl-init email защищён

Сервис certbot получит сертификат от Let's Encrypt и автоматически активирует HTTPS. Сертификат обновляется автоматически каждые 60 дней.

Для локального тестирования без DNS используйте самоподписанный сертификат:

make ssl-local

Шаг 6. Первый вход

Откройте в браузере https://<ваш-домен>/login.html и зарегистрируйте учётную запись администратора. Первый зарегистрировавшийся пользователь автоматически получает права владельца организации.

Админ-панель доступна по адресу /admin.html с использованием логина/пароля из переменных ADMIN_LOGIN и ADMIN_PASSWORD.

Обновление

# Остановка
docker compose down

# Обновление образов
docker compose pull

# Запуск
docker compose -f docker-compose.yml -f docker-compose.prod.yml up -d

Бэкап перед обновлением: перед обновлением мажорной версии создайте резервную копию базы данных. См. раздел Резервное копирование в руководстве администратора.

Удаление

Полное удаление со всеми данными:

docker compose down -v
rm -rf docker/clickhouse/data docker/postgres/data