Установка

Модели развёртывания

Метрика Про Энерго — единый исполняемый файл (Go, go:embed), включающий серверную часть и встроенное веб-приложение (SPA). Статическая компиляция (CGO_ENABLED=0) обеспечивает отсутствие внешних зависимостей.

Система поддерживает две модели развёртывания:

Системные требования

Аппаратные требования

Программные требования

Сетевые требования

Для активации и проверки лицензии необходимо исходящее подключение к серверу лицензирования (mylicense.app.metrica.pro, порт 443).

Установка из бинарного файла

Рекомендуемый способ установки для большинства сценариев.

Шаг 1. Загрузка и распаковка

Получите ссылку на скачивание от правообладателя (при покупке или по запросу на support@metrica.pro), скачайте архив и распакуйте:

# Create target directory and extract the archive
mkdir -p /opt/metrica-energo
tar -xzf metrica-energo-linux-amd64.tar.gz -C /opt/metrica-energo

Содержимое архива:

Шаг 2. Подготовка базы данных

Убедитесь, что PostgreSQL установлен и запущен:

sudo systemctl status postgresql

Создайте базу данных и пользователя:

sudo -u postgres psql

CREATE USER metrica WITH PASSWORD 'your_password';
CREATE DATABASE metrica_energo OWNER metrica;
\q

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

Скопируйте файл с примером и отредактируйте:

cd /opt/metrica-energo
cp .env.example .env
nano .env

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

Шаг 4. Запуск

Сделайте файл исполняемым и запустите:

chmod +x metrica-energo
./metrica-energo

При первом запуске система автоматически выполнит миграцию базы данных. В консоли появится:

INFO  server started on :8080
INFO  database migrated successfully

Откройте браузер и перейдите по адресу: http://localhost:8080

Шаг 5. Настройка systemd-службы

Для автоматического запуска при загрузке сервера создайте systemd-службу:

sudo nano /etc/systemd/system/metrica-energo.service

Содержимое файла:

[Unit]
Description=Metrica Pro Energo
After=network.target postgresql.service

[Service]
Type=simple
User=metrica
WorkingDirectory=/opt/metrica-energo
EnvironmentFile=/opt/metrica-energo/.env
ExecStart=/opt/metrica-energo/metrica-energo
Restart=always
RestartSec=5

[Install]
WantedBy=multi-user.target

Активируйте службу:

# Reload systemd, enable and start the service
sudo systemctl daemon-reload
sudo systemctl enable metrica-energo
sudo systemctl start metrica-energo

Установка с использованием Docker

Шаг 1. Проверка Docker

Убедитесь, что Docker и Docker Compose установлены:

docker --version
docker compose version

Шаг 2. Создание docker-compose.yaml

Создайте файл docker-compose.yaml:

services:
  app:
    image: registry.metrica.pro/metrica-energo:1.0
    ports:
      - "8080:8080"
    environment:
      - DATABASE_URL=postgres://metrica:password@db:5432/metrica_energo?sslmode=disable
      - HTTP_PORT=8080
      - LICENSE_MASTER_KEY=your_master_key
    depends_on:
      db:
        condition: service_healthy
    restart: always

  db:
    image: postgres:18
    environment:
      - POSTGRES_USER=metrica
      - POSTGRES_PASSWORD=password
      - POSTGRES_DB=metrica_energo
    volumes:
      - pgdata:/var/lib/postgresql/data
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U metrica"]
      interval: 5s
      timeout: 5s
      retries: 5
    restart: always

volumes:
  pgdata:

Шаг 3. Запуск

docker compose up -d

Дождитесь запуска контейнеров и откройте браузер: http://localhost:8080

Первый запуск и настройка

При первом переходе в веб-интерфейс:

1. Откройте браузер и перейдите по адресу http://localhost:8080 (или IP-адрес сервера).
2. На экране появится страница авторизации.
3. Войдите с учётными данными администратора, предоставленными при поставке.
4. После входа система предложит сменить пароль.
5. Перейдите в раздел «Настройки» для первоначальной конфигурации:
   • Настройки организации (наименование, реквизиты)
   • Создание учётных записей пользователей
   • Добавление объектов учёта (регионы, подстанции, фидеры)
   • Настройка подключений к УСПД и приборам учёта

Активация лицензии

При первом запуске система работает в режиме «Только чтение».

В большинстве случаев (~90%) UUID лицензии уже записан в персонализированную сборку — активация выполняется автоматически при наличии подключения к серверу лицензирования.

Если автоматическая активация не произошла, выполните ручную активацию через раздел «Настройки» → «Лицензирование». Введите UUID лицензии (код активации), полученный при покупке, и нажмите «Активировать».

Проверка работоспособности

После установки и активации убедитесь в корректной работе системы:

Удаление

Бинарная установка

# Stop and remove the systemd service
sudo systemctl stop metrica-energo
sudo systemctl disable metrica-energo
sudo rm /etc/systemd/system/metrica-energo.service
sudo systemctl daemon-reload

# Remove application files
sudo rm -rf /opt/metrica-energo

Docker-установка

# Stop containers and remove volumes
docker compose down -v