Installation

There is 3 main way to install OpenHEMS server. See chapters below, classed by dificulty. Once the server is installed, please see Configuration page to configure it.

Buy it

You can bye a pre-installed system on [OpenHEMS server on OpenHomeSystem](https://openhomesystem.com/product/openhems-server/). Then plug theelectric power cable and the ethenet one. It should be available from local network on http://192.168.1.202:8123/ and http://192.168.1.202:8000/.

Install on Home-AssistantOS as add-on

This is the easiest way to install it manually. You need a installed Home-AssistantOS. On parameters menu, click on “Add-on store” (bottom right). On top right, click on parameters symbol (3 point button) and select “Store” to open a popup. In the field paste “https://github.com/abriotde/openhems-addon” aand click “Add” button. Close the popup and refresh the store page. You should see “OpenHEMS” in the list. Click on it and then install it.

Then you will need to configure it. See dedicated page Configuration. After configured, restart Home-AssistantOS.

Install from docker

This is a modern, quick and secure way to install it but there is less customizations way (creating your own Dockerfile from it ?).

Prerequisites

Installation

You need 3 parameters :

  • $OPENHEMS_CONFIGPATH : A folder to store openhems.yaml configuration file.

  • $OPENHEMS_LOGPATH : A folder to store logs.

  • $MY_TIME_ZONE : find your time-zone

Replace them in the command lne below and run it.

On a Linux server run :

docker run -d \
       --name openhems \
       --privileged \
       --restart=unless-stopped \
       -v $OPENHEMS_CONFIGPATH:/app/config \
       -v $OPENHEMS_LOGPATH:/log \
       -v /data:/opt \
       -e TZ=$MY_TIME_ZONE \
       -p 8000:8000 \
       ghcr.io/abriotde/openhems-sample:latest

Install from scratch

This way is reserved to aknowledged people. See dedicated page Installation from scratch.