Skip to content

Update & Upgrade

Changelog

v1.21

What's New? Icon Picker, Auto-Save & Quick Add 🎉

  • Icon picker in the server dashboard: Next to every icon field (program card and "+ New" dialog) a button opens an overview of all icons from web/static/img/
  • Search (e.g. router, camera, grafana) and preview on the dashboard background
  • ✓ marks icons that are already used in the dashboard – new API /api/icons
  • Changes are saved automatically: The save button is gone
  • Status indicator "Saving…" / "✓ Saved" / "⚠ Not saved" with Retry
  • Saving happens for fields, active toggles, sorting, adding, deleting and icon selection
  • Warns before leaving the page while changes are still pending
  • Quick Add for Docker containers: Every container card has a "+ Dashboard" button
  • adds the service with an icon suggestion, host port and active state, then jumps to the new entry
  • services that are already present show "✓ Dashboard" and jump to the existing entry
  • Icons for all Docker templates: Every template now has a matching 128x128 icon – including Home Assistant, ESPHome, Music Assistant, Zigbee2MQTT, Ollama, Open WebUI, n8n, Mealie, FreshRSS, Ghostfolio, go2rtc, LiteLLM, Matchering – plus generic icons for routers, cameras, NAS, printers, sensors, power plugs, lights, WLAN access points and more
  • New Docker templates: searxng (meta search engine) and rsshub (RSS feeds for almost every website)
  • Documentation: The dashboard page (DE + EN) now covers icon picker, auto-save and quick add

Update

After a manual update, restart the supervisor once so the new icon API is active: sudo systemctl restart ei23.service

v1.20

What's New? Documentation Update 🎉

  • Completely revised documentation (DE + EN) - All pages up to date
  • New software documentation:
  • ArchiveBox, Firefly III, Frigate NVR, FreshRSS, Ghostfolio, go2rtc
  • Jellyfin, llama-swap, Mealie, n8n, NocoDB
  • Ollama & Open WebUI (separated), Portainer, Syncthing
  • Hardware documentation created:
  • Server recommendations: Mini-PCs/ThinClients vs. Raspberry Pi (performance/watt comparison)
  • Hardware structure with architecture diagrams
  • Edge devices overview (Zigbee, WLAN, ESPHome, 433MHz)
  • Dashboard documentation updated:
  • Live resources (CPU/RAM/Disk) with real-time bars
  • Server actions with SSE terminal output
  • Template manager for Docker programs
  • Program editor with drag & drop
  • Session badges and reconnect functionality
  • Security & Monitoring completely revised:
  • Firewall (UFW) configuration
  • Secure SSH (key auth, Fail2Ban)
  • Monitoring with Uptime Kuma
  • Security checklist
  • Translation update: All new pages also available in English

v1.12

What's New?

  • Bugfixes: Improved installation and fixed issues with icons/links on the ei23 Dashboard
  • Extended OS support: Ubuntu, Pop!_OS, Fedora, CentOS, Rocky, Arch/Manjaro
  • New Docker Templates: fooocus, archivebox, llama-swap, openedai-speech, pairdrop, perplexica, watchyourlan, whisper-webui
  • More new templates: ai-toolkit, blocky, duplicati, fireflyiii, freepbx-asterisk, freshrss, frigate, ghostfolio, gitlab, go2rtc, grocy, heimdall, homeassistant-matterserver, homebridge, homegear, jellyfin, litellm, ollama, lyrionmusicserver, matchering, mealie, music-assistant-server, n8n, nextcloudpi, nginxssl, nocodb, open-webui, plex, portainer, rhasspy, stirling-pdf, syncthing, teddycloud, teslamate, theengs-gateway, uptime-kuma, wyoming-openwakeword, wyoming-piper, wyoming-whisper

v1.11

What's New? Here's a video

  • Improved dashboard with automatic showing/hiding of disabled Docker programs
  • Improved server overview
  • Resource display (RAM / DISK)
  • Storage usage by folder
  • Port of the ei23-supervisor can be changed see ei23-supervisor.py

v1.1 - Version 1.1 of the script is available! Hooray!

What's New? Here's a video

  • The Dashboard has been redesigned and now offers:
  • An IP scanner for the local network (similar to routers, only more practical and faster)
  • An overview of configured programs in docker-compose and programs.json
  • Home Assistant receives an Addon function. This allows community integrations to be automatically updated — similar to HACS, but simpler and without linking a GitHub account.
  • The script is now available on GitHub — contributions are welcome.
  • You are reading the new documentation right now.
  • The script has now been fully adapted for 64-bit systems and AMD64 architectures with Debian 12 as the operating system.

Breaking Changes

As explained in the video: The dashboard no longer runs as a Docker container, but now as a Python server at the system level.

  1. Delete and stop the ei23 Docker container from the Docker-Compose. 

    docker stop ei23

  2. Perform the update 

    ei23 ei23update
ei23 ei23upgrade

  3. Restart the new ei23 Supervisor. 

    sudo systemctl restart ei23.service

Troubleshooting

If the dashboard is not accessible, stop the server with 

sudo systemctl stop ei23.service

The server can be started manually with this command 

cd ei23-docker/volumes/ei23/; sudo .venv/bin/python3 ei23-supervisor.py
If there are error messages such as "Flask" not working properly or missing, then the Python Virtual Environment was not installed correctly. Python has required a Virtual Environment (.venv) for extensions for some time now. externally-managed-environments

This is also the reason why the MKDocs installation hasn't been working correctly for some time. I was able to fix this.

On older or 32-bit systems, installing python3-venv may cause problems and thus prevent the new dashboard from starting. It is necessary to install the python3-venv package correctly: 

sudo apt-get install python3-venv -y # (1)
ei23 ei23update 
ei23 ei23upgrade
sudo systemctl restart ei23.service # (2)

  1. Only after this command executes without errors can the following commands be run
  2. This command restarts the server. The server should now be accessible.

If that doesn't work either, you can try it manually again:

sudo apt-get update
sudo python3 -m venv .venv
sudo su
cd ei23-docker/volumes/ei23/
python3 -m venv .venv
source .venv/bin/activate
pip3 install --upgrade pip
pip3 install flask waitress mkdocs-material ruamel.yaml
exit
sudo systemctl enable ei23.service
sudo systemctl start ei23.service

This will show you all error messages that could occur during installation. If that still doesn't help, a fresh installation is probably the easier way.

If the original programs are not visible: 

sudo cp ei23-docker/volumes/ei23/web/programs.json ei23-docker/volumes/ei23/web/static/programs.json

If hostnames are not visible in the IP scan list, an update of arp-scan can be performed: 

sudo apt-get update
sudo apt-get install -y build-essential autoconf automake libtool pkg-config libpcap-dev
git clone https://github.com/royhills/arp-scan.git
cd arp-scan
autoreconf --install
./configure
make
sudo make install
cd ~
rm -r arp-scan/