Skip to content
Web-app for processing, logging and visualising energy, temperature and other environmental data
PHP JavaScript CSS HTML Shell Python
Branch: master
Clone or download


Type Name Latest commit message Commit time
Failed to load latest commit information.
Lib Merge branch 'emoncms/master' into sql-table-names May 9, 2020
Modules option to select serial port and upload firmware to a connected EmonTx Jun 5, 2020
Theme add emoncms vector logo for use by integrations May 15, 2020
docs text correction Apr 27, 2020
scripts Improved MQTT topic filter Mar 5, 2020
tests updated the js travis test to work with new logout link Apr 30, 2019
.gitignore hierarchial php settings Jul 3, 2019
.htaccess automatic redirect of subdir emoncms path Oct 14, 2019
.jshintrc Fixed .jshintrc Jul 3, 2014
.travis.yml Test PHP 7.4 on travis Apr 25, 2020
COPYRIGHT.txt Update COPYRIGHT.txt Feb 27, 2019
LICENSE.txt First commit of modular refactoring of emoncms, for history up and to… Oct 15, 2012
composer.json Make composer.json valid json again Apr 29, 2020
core.php fix code style to PSR-2 in emoncms root dir Apr 29, 2020
default-settings.ini note about swiftmailer requirement Mar 17, 2020
default-settings.php fix code style to PSR-2 in emoncms root dir Apr 29, 2020
default.emonpi.settings.php change around settings to work with existing emonpi settings update p… Sep 23, 2019
example.settings.ini note about swiftmailer requirement Mar 17, 2020
example.settings.php fix code style to PSR-2 in emoncms root dir Apr 29, 2020
index.php fix code style to PSR-2 in emoncms root dir Apr 29, 2020
locale.php fix code style to PSR-2 in emoncms root dir Apr 29, 2020
param.php fix code style to PSR-2 in emoncms root dir Apr 29, 2020
php-info.php Remove ?> at the end of the files Apr 25, 2020
process_settings.php fix code style to PSR-2 in emoncms root dir Apr 29, 2020 fixed some typos and improved document uniformity May 14, 2020
route.php fix code style to PSR-2 in emoncms root dir Apr 29, 2020
settings.env.ini Update settings.env.ini Nov 26, 2019
version.txt update version May 12, 2020


Build Status Codacy Badge

Emoncms is an open-source web application for processing, logging and visualising energy, temperature and other environmental data and is part of the OpenEnergyMonitor project.



  • PHP (tested with 7.0.30)
  • MYSQL or MariaDB (tested with 15.1)
  • Apache (tested with 2.4.25)
  • Redis* (tested with 3.2.6)

*Redis is recommended because it reduces the number of disk writes and therefore prolongs disk life (noticeably on SD cards e.g. RaspberryPi). Some input-processors also require redis and fail silently if redis is not installed. Some environments such as shared hosting or as far as we have tried windows servers don't support redis hence why emoncms has a fall back mode that allows core operation without redis.

Using Emoncms

Important: Standard Emoncms and

There are differences between the standard version of emoncms and the version of emoncms running on This repository contains the code for the standard version of emoncms. This is the version installed on the OpenEnergyMonitor SD Card that comes with the EmonPi and EmonBase and is recommended for all self-install versions of emoncms.

The version Github: emoncms/emoncmsorg is a fork that is specific for multi-server installations. While both versions share the same roots, the code for differs significantly from the standard version of emoncms, the user experience is intended to be similar but there are currently a number of differences in the API and look of the inputs and feeds interfaces as well as a reduced feature set in general on in order to ensure stability. In general development on moves slower than the standard emoncms for this reason.

1. From the Guide

2. Emoncms Terminology

  • Input: An incoming datasource. Each input has an associated "node" identifier and a "key" sub-identifier. Inputs are entry points, only the last value and time of the input is recorded. To record historic data a feed needs to be created from an input.
  • Input: Node: A grouping identifier for an input or feed.
  • Input: Key: A sub-identifier for items within each Node.
  • Input process list (or input processing): A list of processes* performed sequentially on each input value as it is received on that input.
  • Process: A function that can be attached to the process list of an input to change the value or to save the value to a feed*.
  • Feed: A place where data is recorded, a time-series of datapoints. The standard time-series databases used by emoncms are PHPFina and PHPTimeSeries and were written as part of the emoncms project.
  • For a description of what each input process does in emoncms, see the helper note within the emoncms input processing configuration interface.

3. API Reference

The following API references apply to They differ slightly to the API available on EmonPI/EmonBase installs, the API refrence for which can be found from the inputs and feed pages when logged in locally.



Experimental (not currently up to date):

Other (less supported, not tested on latest versions of emoncms)

  • Shared Linux Hosting
  • Windows Emoncms is developed and tested on Linux only and so additional research, steps may be required that are not covered in this guide.


Modules can be installed by downloading or git cloning into the emoncms/Modules folder. Be sure to check for database updates in Administration menu after installing new modules:

There are many other available modules such as the event module and openbem (open source building energy modelling module): check out the Emoncms repo list.

3rd party modules


  • master - The latest and greatest developments. Potential bugs, use at your own risk! All pull-requests should be made to the master branch.

  • stable - emonPi/emonBase release branch, regularly merged from master. Slightly more tried and tested. See release change log.

  • ARCHIVE low-write (v8.5) - Old emonpi/emonbase emoncms version (July 15 emonSD ready-to-go SD card image). Low-write mode is now available in v9.0. The low write version of emoncms is designed for running on SD cards. This is a cut down version of emoncms supporting only the phpfina and phptimeseries feed engines (no in built feed averaging or histograms) and a reduced input processor set. Archived branch


Data Backup


Documentation development

For developers: The following lists the locations of the files that define emoncms's inbuilt documentation for the input and feed API's and input process descriptions:


  • PHPFina data file viewer - Easily explore phpfina timeseries feed engine data files directly without a full emoncms installation. Useful for checking backups and archived data.


Note: due to ongoing development some docs may now be outdated

Emoncms timeseries database design (feed storage)

Android App

Google Play

GitHub Repo

Development Forum

More information

You can’t perform that action at this time.