Emoncms Docker...run Emoncms on your machine in 4 commands!

With the help of @davehun and @spikeheap from @northwalestech I have been working on an Emoncms Docker setup. Using Docker it’s possible to fire up Emoncms on a bare system (assuming Docker is installed) in a couple of minutes with all the LAMP config faff taken care of. This is great for development since you can play about with Emoncms running in a Docker container without fear of messing up your main Emoncms install.

In the future, Docker can even be used as a deployment tool for Emoncms. In theory, it should be possible to deploy the Docker container on any server within minutes :slight_smile:

Read Blog Post

Quick start

$ docker pull openenergymonitor/emoncms
$ git clone https://github.com/emoncms/emoncms-docker
$ cd emoncms-docker
$ docker-compose up

That’s it! Emoncms should now be runnning, browse to http://localhost:8080

The Docker files and build instructions are in the emoncms-docker repo:

GitHub - emoncms/emoncms-docker: Emoncms docker container(s)

Please give it a try and let me know how you get on.

The next step will be to push an Emoncms Docker container to docker-hub to allow anyone interested in Emoncms to pull down the container and be up and running with Emoncms almost immediately.
Done: Docker Hub

To do:

  • Allow docker container to startup with a large amount of test data & demo dashboards etc.
  • Create ability to simulate a large number of inputs
  • Simulate emoncms.org multi-server
  • Add MQTT
  • Backup module
  • Add Redis
  • EmonHub
  • Investigate running Docker on RaspberryPi

See To Do list on emoncms-docker repo issues


You may find this helpful:


Yup, looks like it’s possible. It could be amazing in the future to be able to build Raspberry Pi / emonPi images from a docker container. :slight_smile:

Out of interest, does anyone have experience with Docker?

1 Like

My test emoncms install is running in a docker on an unraid system.
Has been working flawlessly for a while now.

It’s definately a great way to run it independent from the server.
With a supported official docker i might switch my vm install over…

Hi Bart,

Great to hear, how did you setup your Docker enviroment? I have gone for using two containers; one for php-apache and the other for mysql and linking them via docker-compose. I am keen to try and standardise on a docker setup which is best practice for emoncms in both development and production.

Just updated my first post with quick start guide and blog post link:

It’s awesome how 4 commands gets Emoncms up and running from scratch!

$ docker pull openenergymonitor/emoncms
$ git clone https://github.com/emoncms/emoncms-docker
$ cd emoncms-docker
$ docker-compose up

That’s it! Emoncms should now be runnning, browse to http://localhost:8080


Pretty slick!

There’s only three commands in your list. Your blog post shows another command:
$ docker pull openenergymonitor/emoncms

Should that one be in the list too?
Or should the text read 3 commands, vice 4 commands?

Well spotted, blog post is correct. 4 commands are needed, the docker pull command is important. I’ve amended my post above.

Very nice idea, because now I can let it run direct on my NAS :slight_smile:
What do you think, is it possible to integrate an energy monitor via modbus also on docker?

Modbus integration is a separate topic to docker. Please start a new topic discussion. I have no experience of Modbus, there might be some Modbus discussion on the old forums. Maybe try and search Forums | Archived Forum

1 Like

The more I learn about docker the more I’m blown away by its potential. I hope this is something y’all are still working on!

1 Like
[email protected]:/# docker ps | grep emon
438c4a303cb2        emoncms/apr                             "apache2-foreground"     4 months ago        Up 3 weeks>80/tcp                                                           emoncms
82544e7154f8        redis:alpine                            "docker-entrypoint..."   4 months ago        Up 3 weeks          6379/tcp                                                                     emoncms_redis
ff511ce35222        mysql:5.6                               "docker-entrypoint..."   4 months ago        Up 3 weeks          3306/tcp                                                                     emoncms_sql
[email protected]:/#

I’ve been a very happy docker user for about a year. I managed to migrate from a basic emoncms install inside a VM to containers without losing anything.

I’ve learned a lot with @glyn.hudson post and as usual forgot to drop a simple thank you.

so… THANK YOU! :blush:


I’m glad to hear your finding the docker installation useful. Docker is fantastic.

Let me know if you have any suggestions on how to improve the emoncms docker setup. Git PR’s are best

2 posts were split to a new topic: Emoncms docker on DSM 6

The default web port port 8080 which clashes with OpenHAB can be changed by editing docker-compose.override.yml
(Answered my own question)

1 Like

That’s it! Emoncms should now be runnning, browse to http://localhost:8080

Very easy indeed! I get a login page of emoncms, but what is the default username and password? I found raspi-raspberry as combination on the web, but that doesn’t work on my system (Lubuntu).

I found it myself blush. I thought I couldn’t use register, because it would send an e-mail and that probably wouldn’t work. But it’s just used as an login name. But now I would like to use emonHUB and that doesn’t seem to be included in de docker image. I think I will go for a regular Ubuntu install, as docker is too new for me :-). And - as far as I understand - the docker image is (at the moment) only for development, not for real use.

For Ubuntu EmonScripts/readme.md at master · openenergymonitor/EmonScripts · GitHub

What are you going to use emonhub for? The 2 do not need to be on the same physical machine.

stupid Q… but does this mean that i can host emoncms on an open media vault machine?

I just tried to spin up a docker container using openenergymonitor/emoncms:latest but I am getting v10.1.13 when I login. From what I can tell, this image hasn’t been updated on Dockerhub for 2 years.

Is there a process to update this image after an EmonCMS release? Or do I just need to build it locally and use my own version of the image - i.e. is the version on Dockerhub obsolete and unused?