Emoncms

Emoncms - веб-приложение проекта OpenEnergyMonitor для сбора, логирования и визуализации данных об энергии, температуре и окружающей среде. Задача простая и понятная любому владельцу дома: собрать в одном месте, сколько электричества уходит, сколько дает солнечная панель, как работает тепловой насос, и увидеть это графиком, а не строчкой в квитанции.

Работает по модели входов и feeds. Вход (input) - точка приема данных: у него есть узел (node) и ключ (key), пишется только последнее значение. Чтобы копить историю, из входа создают feed - временной ряд на собственных движках PHPFina и PHPTimeSeries. Поверх feeds строятся графики, дашборды и прикладные приложения: MyElectric, MySolar, DemandShaper. Данные приходят по HTTP-API или по MQTT с любых устройств.

Ядро на PHP 8.1 под Apache, метаданные (пользователи, входы, feeds) в MariaDB. Временные ряды хранятся не в SQL, а в собственных движках PHPFina (фиксированный интервал) и PHPTimeSeries (переменный) - файлами на диске, это быстро и компактно.

Redis работает буфером записи (режим low-write): он копит значения и сбрасывает их на диск пачками, что резко снижает износ диска - критично для SD-карт Raspberry Pi, полезно и на SSD. Часть процессоров входов без Redis молча не работает, поэтому он рекомендован. Прием телеметрии обеспечивает MQTT-брокер Mosquitto, а фоновые воркеры (emoncms_mqtt, service-runner, feedwriter) разбирают входящие данные и пишут feeds.

Мы ставили all-in-one docker-образ, где MariaDB, Redis, Mosquitto, модули (graph, dashboard, app, sync) и воркеры уже собраны в один контейнер - самый короткий путь поднять рабочий экземпляр.

1. Создать VM и поставить Docker

   Тариф CPU2-RAM4-DISK40, Ubuntu 24.04. Установка Docker: curl -fsSL https://get.docker.com | sh.

2. Забрать образ (с ретраями)

   Из РФ-сети pull с Docker Hub иногда обрывается по таймауту на одном слое - не блокировка, сетевой флап. Ставим цикл с повтором:

   IMG=alexjunk/emoncms:alpine3.20_emoncms11.12.3
   for i in $(seq 1 8); do docker pull "$IMG" && break; sleep 8; done

3. Поднять контейнер на localhost

   Публикуем порт только на loopback, наружу его выставит прокси:

   docker run -d --name emoncms --restart unless-stopped \
     -p 127.0.0.1:8080:80 "$IMG"

   Проверка: curl -s -o /dev/null -w '%{http_code}' localhost:8080/emoncms/ должен вернуть 200.

4. Домен и TLS через Caddy

   Caddy сам выпустит Let's Encrypt на ваш домен. /etc/caddy/Caddyfile:

   ваш-домен {
       reverse_proxy 127.0.0.1:8080
   }

   Дальше systemctl restart caddy - и сервис доступен по HTTPS.

5. Создать аккаунт

   Первый вход в веб-интерфейсе создает администратора. После этого можно заводить входы, feeds и графики.

https://ваш-домен/emoncms/feed/list

Проверено на версии 11.12.3, сентябрь 2026. На новых версиях результаты могут отличаться.

Emoncms активно развивается, релизы и security-заметки - на странице релизов GitHub. Обновление образа:

docker pull alexjunk/emoncms:НОВЫЙ_ТЕГ
docker rm -f emoncms && docker run -d --name emoncms --restart unless-stopped \
  -p 127.0.0.1:8080:80 alexjunk/emoncms:НОВЫЙ_ТЕГ

Бэкап - это каталог с данными emoncms (feeds на диске) и дамп MariaDB. У проекта есть штатные модули backup и sync для переноса и восстановления feeds.

• Обратный прокси - Caddy или Nginx Proxy Manager для домена и TLS.
• Умный дом - Home Assistant умеет отдавать данные в Emoncms, а Emoncms - принимать телеметрию по MQTT.
• Мониторинг инфраструктуры - Uptime Kuma или Beszel, если нужно следить за самим сервером, а не за энергией.