# Emoncms

Emoncms is a powerful open-source web-app for processing, logging and visualising energy, temperature and other environmental data. It is open source and self-hosted, installable on Docker Hub and Unraid.

Canonical page: https://ourlocalhost.com/app/2788/emoncms

## Description

Emoncms is a powerful open-source web-app for processing, logging and visualising energy, temperature and other environmental data.

## Platform availability

Available on 2 of 10 platforms: Unraid, Any server.

## Health score

76/100 (Good), based on 3 of 4 factors.
- Maintained: 100 (last commit 30 days ago)
- Popular: 62 (1,324 GitHub stars)
- Easy to install: 45 (2 install platforms, install notes, Docker image)

## Links

- Docker Hub: https://hub.docker.com/r/alexjunk/emoncms
- Official website: https://emoncms.org/
- Unraid: https://ca.unraid.net/apps/emoncms-02hix9w0k8u0ls?q=Emoncms
- Documentation: https://docs.openenergymonitor.org/emoncms
- GitHub: https://github.com/emoncms/emoncms

## Common questions

### What does the all-in-one Emoncms Docker container include?

It includes MariaDB, Redis, Mosquitto, the graph, sync, backup, dashboard and app modules, plus the emoncms_mqtt, service-runner and feedwriter services.

### What must I do after installing an Emoncms module?

Clone the module into the Modules folder, or into /opt/emoncms/modules for modules with background scripts using a symlink. Then run Update Database on the Admin page.

### Can Emoncms run without Redis?

Yes, Emoncms can run where Redis is not available. Input processes marked as needing Redis do not work, and Redis reduces disk writes to extend SD card life.

### Why might Emoncms stop receiving MQTT messages after a reboot?

Enable and start emoncms_mqtt.service, then check its status with systemctl. If it is not enabled as a systemd service, MQTT messages may not be received after a reboot.

### Why might the Emoncms logger fail to keep logs or start reliably?

Run the logger installer first with sudo ./install.sh, then reboot if /var/log is set up as tmpfs. Without this, the logger may not keep logs or start reliably.

## Alternatives

- openHAB: openHAB is a vendor- and technology-agnostic open-source home automation platform.

---
Source: Our Local Host (https://ourlocalhost.com/app/2788/emoncms), the self-hosted and open-source app directory.
