New Forum, Blog and User Guide Website

We have been busy for the past couple of months building some new websites to improve OpenEnergyMonitor.

Introducing a shiny new:

  1. Community Forum
  2. User Guide website
  3. Blog

Later this week on Thursday 5th May 2016 the old forums will be frozen and we will be moving to the new community forums

1. New Community Forum


The current OpenEnergyMonitor Forums have been running (since 2010) on Drupal 6. As of February 2016 Drupal 6 reached EOL. This does not mean that the site will stop working, however, it does mean we have decided the time has come to upgrade the highest traffic and most interacted-with part of the site > The Community Forums.

Later this week on Thursday 5th May 2016 the old forum will be frozen and we will be moving to the new forum powered by Discourse open-source forum platform hosted and managed us (OpenEnergyMonitor) on our servers.

You will need to create an account on the new forum. You should receive an email soon inviting you to the new forum, if you join via the link in the email you will receive elevated privileges on the new forum since you have already proved yourself as a trusted user.

Thanks a lot to the team of community volunteers who have prepare the new forum over the past few weeks.

2. New User Guide

image contains has a wealth of information (specifically the Building Blocks resources section), however a common issue raised by new users is they feel lost swimming in a sea of information. The user guide has been created to provide just the right amount of information to setup and configure and OpenEnergyMonitor system. The guide is focused on the emonPi but will also cover emonBase (Raspberry Pi + RFM69Pi), emonTx and emonTH.

The launch of the Guide site coincides with the launch of the new emonSD Raspberry Pi emonPi / emonBase pre built image which includes the latest version of Emoncms as well as MQTT, nodeRED, openHAB and Raspberry Pi 3 support all setup and pre-configured. See forum post. This new emonSD image will be installed as standard with all emonPi/emonBase’s shipped from our store in the next few weeks. We soon be selling the Raspberry Pi 3 as standard with emonPi / emonBase, another blog post on this coming soon..

The User Guide site will attempt to create a distinction between ‘user’ documentation and ‘developer’ documentation and discussions. The Guide site has been designed to look and work great on mobile devices. We think this is important since stats indicated that users often follow the setup guide on a mobile or tablet while at the install site (think head stuck inside a meter cabinet!). Going forward we would like to standardise on the following locations for documentation:

  • User Guide Site - User documentation
  • Forums - User support / Developer discussion separated with categories.
  • GitHub - Technical documentation

The Hardware Wiki will still exist, however expect hardware documentation to move to GitHub Hardware Repo over time.

3. New Blog


We have wanted to move away from our old Google blogger for a while. During the learning process building the Guide website I realised that using GitHub and Jekyll would also be a good solution for the blog. Thanks to Google export and a nice Jekyll import script we managed to migrate over the blog without too much difficulty. Please update your RSS subscription to the new Atom feed.xml.

Technical info

The new Guide and Blog are built using Jekyll static site generator with Octopress Oscailte theme to convert markdown files to html. The sites are fully open-source on GitHub and are hosted by GitHub pages. Travis CI has been configured to re-build the static html pages each time a change commit is made. Hosting the site on github will make it easy for anyone to propose a change/fix. The site is served and secured via Cloud Flare using CF’s Universal SSL/TLS to origin.

To engage in discussion regarding this post, please post on our Community Forum.