openems/ui-backend

Open Source Energy Management System

OpenEMS - the Open Source Energy Management System - is a modular platform for energy management applications. It was developed around the requirements of monitoring, controlling, and integrating energy storage together with renewable energy sources and complementary devices and services like electric vehicle charging stations, heat-pumps, electrolysers, time-of-use electricity tariffs and more.

If you plan to use OpenEMS for your own projects, please *** joining the OpenEMS Association e.V., a network of universities, hardware manufacturers, software companies as well as commercial and private owners, and get in touch in the OpenEMS Community forum.

OpenEMS UI for Backend Docker Image

Quick reference

• Supported architectures:

  amd64, arm64

• Supported tags:

  latest, develop or release in semantic version form (e.g. 2026.2.0).

  (!) for current releases checkout https://github.com/OpenEMS/openems/releases

How to use this image

Quickstart

bash
docker run --name openems_ui -p 80:80 -p 443:443 -e WEBSOCKET_HOST=<hostname> -d openems/ui-backend

Docker Compose with Backend

yaml
services:
  openems_backend:
    image: openems/backend:latest
    container_name: openems_backend
    hostname: openems-backend
    restart: unless-stopped
    volumes:
      - openems-backend-conf:/var/opt/openems/config:rw
      - openems-backend-data:/var/opt/openems/data:rw
    ports:
      - 8079:8079 # Apache-Felix
      - 8081:8081 # Edge-Websocket
      - 8082:8082 # UI-Websocket

  openems-ui:
    image: openems/ui-backend:latest
    container_name: openems_ui
    hostname: openems-ui
    restart: unless-stopped
    volumes:
      - openems-ui-conf:/etc/nginx:rw
      - openems-ui-log:/var/log/nginx:rw
    environment:
      - WEBSOCKET_HOST=openems-backend
      - WEBSOCKET_PORT=8082
    ports:
      - 80:80
      - 443:443

volumes:
  openems-backend-conf:
  openems-backend-data:
  openems-ui-conf:
  openems-ui-log:

See https://github.com/OpenEMS/openems/blob/develop/tools/docker/backend/README.md for a manual on how to use a InfluxDB to store timedata

Learn more

• Follow the Getting Started guide to setup OpenEMS on your own computer
• Join the OpenEMS Community
• https://github.com/OpenEMS/openems/
• Latest version of documentation