A dead-easy, clean and slim installation and maintenance tool for a huge amount of Docker-based home automation and media software, easily accessible on a clean, slim and customizable web dashboard.

Supports: Debian, Raspberry Pi OS, Ubuntu, Pop!_OS, Fedora, CentOS, Rocky, Arch/Manjaro | Architectures: armv7, arm64, amd64

Maybe it's not as easy to configure as the Home Assistant OS, but you get a lot more customization options and get in touch with the docker-compose.yml notation, which is also a great tool. And you don't even have to use Home Assistant if you prefer OpenHAB or IObroker for example. All on one system.

This script was developed for trusted environments where the user fully understands the security implications. It is NOT suitable for use in production or publicly accessible environments without additional security measures.

Critical by design: SSH root login enabled, sudo without password. These are intentional decisions for ease of use in isolated lab networks. You must harden the system if exposed to untrusted networks.

📄 See Security Audit for details and hardening instructions.

What's actually possible with a smart home? Here are some examples:

• 🚗 Garage door opens when your car approaches
• 🔔 Doorbell rings your phones and optionally unlocks the front door
• 📬 Notification with image to your phone when mail arrives
• 👕 Notification when the washing machine is done (via power consumption monitoring)
• 🕐 Lights synced with your phone alarm
• ☀️ Brightness adjusted to your solar panel output
• 👤 Lights controlled by presence detection
• 📹 Cameras used as motion detectors
• ⚡ Warning light when power consumption is too high (using even more power 😄)

Yes, even the most ridiculous idea is possible. Or as I like to joke: the modern model railroad in the basement.

Absolutely not. Only if it actually saves energy or time – and therefore money.

Don't become a feature-creep. Keeping things simple is an art. If something constantly causes problems, you'll lose the fun. But if you're willing to invest a bit of time and learn a few new things, endlessly much is possible.

And you become smart and independent. That is very valuable.

This isn't just about cool gadgets. It's about preventing a scenario.

Look at what's happening right now: Smart speakers, smart thermostats, smart cameras – everything runs through the cloud, controlled by a few big corporations. Amazon, Google, Apple. They have the control, they get the data, they have the power. We're becoming more and more dependent on them.

This is the path to a cyberpunk scenario. Megacorps determining the infrastructure of your daily life. Features that simply disappear. Prices that go up. Data you don't control. Services that get shut down overnight.

We can only prevent this if as many people as possible become smart and independent. With your own hardware. With open source software. Without monthly fees. Without cloud dependency. Without big tech.

Your home belongs to you. Your data belongs to you. Your automations belong to you.

That's what ei23 stands for.

Have fun, get smart and independent! 🏠🔓

• 🚀 One-Command Installation - Script handles everything
• 🐳 Docker-Based - 90+ pre-configured templates
• 📊 Web Dashboard - Live monitoring, container management, template installer
• 🔄 Easy Updates - ei23 update for full system update
• 💾 Backup System - Integrated backup for all services
• 🌐 Multi-OS - Debian, Ubuntu, Fedora, Arch, and more
• 🏠 Multi-Arch - ARM (32/64-bit) and x86-64 support

Home Assistant · Node-RED · ESPHome · Mosquitto · Zigbee2MQTT

Jellyfin · Immich · Lyrion Music Server · Music Assistant

llama-swap · Open WebUI · LiteLLM · Frigate

Nextcloud · Paperless-ngx · Mealie · FreshRSS · ArchiveBox · NocoDB · Stirling-PDF · Syncthing · PairDrop

Vaultwarden · Traefik · WireGuard · AdGuard Home · Duplicati

FreePBX / Asterisk

Grafana · InfluxDB · Uptime Kuma · Portainer

And many more... Have a look in the compose_templates folder!

💡 Mini-PCs recommended: For best performance per watt, we recommend used ThinClients or Mini-PCs with x86 architecture. They support all Docker images and offer significantly more power than Raspberry Pis.

• 🇩🇪 German Docs - Complete documentation in German
• 🇬🇧 English Docs - Complete documentation in English

After registering for the newsletter, you'll receive two commands to execute via SSH:

1. English Newsletter / German Newsletter
2. Execute the received commands on your server
3. Follow the interactive menu

Why newsletter?

• Security updates and important announcements
• Community building
• Support the project
• Your email stays private (trash mail is fine!)

The script downloads a USERID for updates and sets the correct language file based on your newsletter choice.

1. Clone the files to a folder.
2. Insert the language file of your choice (de-file.txt / en-file.txt) into ei23.sh and replace "LANGFILE_PLACEHOLDER"
3. Install a fresh Debian / Rasbian system, login via ssh or terminal and create a user like this "useradd -m ei23" (or another name)
4. Copy the entire "ei23-docker" folder into your users home directory (with root privileges)
5. Copy the ei23.sh into your user home directory
6. run "bash ei23.sh part1"
7. follow instructions
8. after you done the reboot, run "ei23", the script then will finish the installation

• ei23 updates won't work with manual installation (USERID from newsletter is needed)
• you won't see a version number and will not get info about new versions (USERID from newsletter is needed)
• everything else works like normal

Note: Manual installation doesn't support auto-updates (USERID required).

The ei23 Dashboard is a full server supervisor with:

• 📊 Live Monitoring - CPU, RAM, Disk usage in real-time
• 🐳 Container Management - View status, access web interfaces
• 📋 Template Manager - Install new programs with one click
• ✏️ Program Editor - Drag & drop dashboard customization
• 🖥️ Server Actions - Updates, backups, reboots with live terminal
• 🌐 Network Scanner - Discover devices on your network

Access: http://[your-server-ip]

ei23                  # Open menu
ei23 update           # Full system update
ei23 dc               # Docker Compose (restart containers)
ei23 du               # Docker Update (pull new images)
ei23 backup           # Create backup
ei23 dstats           # Show Docker container status
ei23 docs             # Build documentation
ei23 -h               # Show all shortcuts

Pull requests are welcome! You can:

• Edit or add documentation files
• Add new compose templates
• Add dashboard icons (128x128 PNG with transparent background)

I love open source projects - here is my best of list

Consider supporting them!

You can expect special perks there. Thanks!

This project is licensed - see LICENSE for details.