openems/ui-backend repository overview

⁠
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 consider 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

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

⁠Docker Compose with Backend

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⁠
• GitHub repository⁠
• Latest version of documentation⁠