npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

iobroker.eos

v0.1.14

Published

ioBroker adapter for Akkudoktor EOS energy manager with managed installation

Vulnerabilities

Powered byPowered by Snyk
  • 0High
  • 0Medium
  • 0Low

Links

Git

Maintainers

bluefoxbluefoxthebam1990thebam1990

Keywords

ioBrokeriobrokereosakkudoktorenergypvbatteryoptimization

Readme

ioBroker Akkudoktor EOS Adapter

This adapter installs and connects the Akkudoktor EOS energy manager from ioBroker. EOS can be installed automatically by the adapter or connected as an already running external service.

The default mode is Managed source/Python installation. This mode was chosen because it works on hosts without Docker. The adapter downloads the EOS source code, installs the required Python runtime packages into a private adapter directory and starts EOS from ioBroker.

Features

  • Automatic EOS installation from the official Akkudoktor EOS Git repository.
  • Automatic pip bootstrap if the host has Python but no pip module.
  • PEP 668 handling for Debian/Ubuntu Python installations.
  • Private Python dependency directory .iobroker-deps; no EOS Python packages are installed into the ioBroker Node.js directory.
  • Optional Docker mode using akkudoktor/eos:latest.
  • Optional external mode for an already running EOS server.
  • EOS dashboard instance link in ioBroker Admin.
  • Health polling with info.connection.
  • Raw JSON states for health, energy plan, optimization solution, predictions, measurements and resource statuses.
  • Optional mapping from ioBroker states into EOS measurements.
  • Manual command states for install, start, stop, restart, refresh and prediction update.

Requirements

Managed source mode

The ioBroker host needs:

  • git
  • python3
  • network access to GitHub and PyPI
  • enough disk space for EOS and Python dependencies

The adapter can bootstrap pip when python3 -m pip is missing. It cannot install missing system packages such as git or python3 because that would require distribution-specific root package management.

The adapter stores EOS data here by default:

/opt/iobroker/iobroker-data/eos-managed

Inside that directory the adapter creates:

.iobroker-deps/
.iobroker-requirements.txt
.iobroker-eos-installed
iobroker-eos.stdout.log
iobroker-eos.stderr.log

Managed Docker mode

Docker mode needs a working docker command on the ioBroker host. The adapter pulls and runs akkudoktor/eos:latest.

External mode

External mode needs an EOS API server that is already reachable from ioBroker, for example:

http://192.168.2.50:8503

Default Ports

| Service | Default URL | | --- | --- | | EOS API | http://127.0.0.1:8503 | | EOS dashboard | http://<ioBroker-IP>:8504 |

The Admin instance link opens the dashboard port.

Quick Start

  1. Install the adapter in ioBroker.
  2. Create or start instance eos.0.
  3. Keep EOS mode set to Managed source/Python installation.
  4. Keep Install EOS automatically and Start EOS automatically enabled.
  5. Wait for the first installation. It can take several minutes because EOS has many Python dependencies.
  6. Check eos.0.info.connection.
  7. Open the instance link in ioBroker Admin or browse to http://<ioBroker-IP>:8504.

During first installation, watch:

eos.0.managed.lastAction
eos.0.managed.lastProcessOutput
eos.0.info.lastError

When installation is complete and EOS is running, the following states should be true:

eos.0.managed.installed = true
eos.0.managed.running = true
eos.0.info.connection = true

Configuration

Installation

| Setting | Description | | --- | --- | | Enable adapter | Enables the adapter logic. | | EOS mode | Select Managed source/Python installation, Managed Docker installation or External EOS server. | | Install EOS automatically | Installs EOS when the managed installation is missing. | | Start EOS automatically | Starts EOS when the adapter starts. | | EOS Git repository | Git repository used by managed source mode. Default: https://github.com/Akkudoktor-EOS/EOS.git. | | EOS source directory | Directory for the managed EOS checkout and private dependency directory. | | Python command | Python executable used to install and run EOS. Default: python3. | | Docker image | Docker image used in managed Docker mode. Default: akkudoktor/eos:latest. | | Container name | Docker container name. Default: iobroker-eos. | | Local API port | Local API port. Default: 8503. | | Local dashboard port | Local dashboard port. Default: 8504. | | External EOS API URL | API URL used in external mode. |

Polling

| Setting | Description | | --- | --- | | Polling interval seconds | Interval for API polling. Minimum is 10 seconds. | | Request timeout ms | Timeout per HTTP request. | | Poll health | Reads /v1/health. This determines info.connection. | | Poll energy plan | Reads /v1/energy-management/plan. | | Poll optimization solution | Reads /v1/energy-management/optimization/solution. | | Poll prediction keys | Reads /v1/prediction/keys. | | Poll measurement keys | Reads /v1/measurement/keys. | | Trigger prediction update before polling | Calls /v1/prediction/update before polling. | | Prediction keys | Comma or newline separated keys for /v1/prediction/list. | | Measurement keys | Comma or newline separated keys for /v1/measurement/series. |

Plan and optimization endpoints can return 404 while EOS is not configured yet. The adapter treats these as optional warnings and keeps info.connection = true as long as /v1/health is alive.

Resource Statuses

Add resource rows when EOS resources should be polled via:

/v1/resource/status?resource_id=<resourceId>&actuator_id=<actuatorId>

The adapter writes the raw response and flattened primitive values below:

eos.0.resources.*

Measurements

Measurement mappings subscribe to ioBroker states and send numeric values to EOS. Each row needs:

| Field | Description | | --- | --- | | ioBroker state | Source state to subscribe to. | | EOS measurement key | EOS measurement key to update. |

The adapter writes changes via:

PUT /v1/measurement/value

Non-numeric values are ignored and logged.

States

Information

| State | Meaning | | --- | --- | | info.connection | True when EOS health endpoint is reachable. | | info.lastError | Last connection error or optional polling warnings. | | info.lastUpdate | Timestamp of the last successful health-based polling cycle. | | info.installMode | Active installation mode. |

Managed Installation

| State | Meaning | | --- | --- | | managed.enabled | True in managed source or Docker mode. | | managed.installed | True when the managed installation marker/container exists. | | managed.running | True when the adapter-started EOS process/container is running. | | managed.image | Docker image. | | managed.containerName | Docker container name. | | managed.sourceDirectory | Source installation directory. | | managed.dashboardUrl | Dashboard URL from the adapter perspective. | | managed.lastAction | Current or last installer/start action. | | managed.lastProcessOutput | Last pip/EOS process output for troubleshooting. |

Commands

| State | Action | | --- | --- | | commands.install | Install or update managed EOS. | | commands.start | Start managed EOS. | | commands.stop | Stop managed EOS. | | commands.restart | Restart managed EOS. | | commands.refresh | Poll EOS immediately. | | commands.updatePredictions | Trigger EOS prediction update and then poll. |

Troubleshooting

python3: No module named pip

The adapter tries to install pip automatically. Progress appears in:

eos.0.managed.lastAction
eos.0.managed.lastProcessOutput

externally-managed-environment

Some Debian/Ubuntu Python installations use PEP 668. The adapter passes --break-system-packages only for its user/bootstrap and target-directory installation flow. EOS dependencies are installed into .iobroker-deps, not into the system Python package directory.

git or python3 missing

Install the missing system package on the ioBroker host. The adapter cannot safely install operating system packages by itself.

Energy plan returns HTTP 404

This is normal until EOS is configured for automatic optimization. The adapter keeps the connection alive when /v1/health is reachable.

Dashboard link does not open

Check:

eos.0.managed.running
eos.0.managed.dashboardUrl

Also verify that the dashboard port is reachable from your browser. The default dashboard port is 8504.

Reinstall managed source mode

Stop the adapter and remove the managed source directory if a clean reinstall is required:

/opt/iobroker/iobroker-data/eos-managed

Then start the adapter again.

Changelog

0.1.13

  • Mark EOS as connected when health is alive and treat unconfigured plan endpoints as optional warnings.

0.1.12

  • Bootstrap pip automatically on hosts where Python is installed without pip.

0.1.10

  • Stream managed source installation output to managed.lastProcessOutput.

0.1.8

  • Add dashboard instance link and update the adapter icon.

0.1.2

  • Add managed source/Python installation for systems without Docker.

0.1.0

  • Initial adapter with managed Docker installation and EOS API integration.

Older entries are stored in CHANGELOG_OLD.md.

License

MIT

Copyright (c) 2026 TheBam1990