Home Assistant OS support?

[georgestephanis]

Hiya!

Love the project, I've been using it on my RackPi for a while, but wanted to also set one up for my Pi5 running HomeAssistant with HomeAssistant OS.

I've already got ssh access via the hassio and root users on ports 22 and 22222 respectively, but getting errors on each.

The hassio user is a limited shell, so I'm not surprised it won't install:

$ ssh hassio@homeassistant.local

       ▄██▄           _   _                                    
     ▄██████▄        | | | | ___  _ __ ___   ___               
   ▄████▀▀████▄      | |_| |/ _ \| '_ ` _ \ / _ \              
 ▄█████    █████▄    |  _  | (_) | | | | | |  __/              
▄██████▄  ▄██████▄   |_| |_|\___/|_| |_| |_|\___|          _   
████████  ██▀  ▀██      / \   ___ ___(_)___| |_ __ _ _ __ | |_ 
███▀▀███  ██   ▄██     / _ \ / __/ __| / __| __/ _` | '_ \| __|
██    ██  ▀ ▄█████    / ___ \\__ \__ \ \__ \ || (_| | | | | |_ 
███▄▄ ▀█  ▄███████   /_/   \_\___/___/_|___/\__\__,_|_| |_|\__|
▀█████▄   ███████▀

Welcome to the Home Assistant command line interface.

Home Assistant Supervisor is running!
System information:
  IPv4 addresses for end0:  (No address)
  IPv4 addresses for wlan0: 192.168.0.231/24
  IPv6 addresses for wlan0: fd9e:9a49:a07a:61d5:ec56:b81b:25f0:eb2e/64, fe80::b43f:ae10:b5d5:6aec/64

  OS Version:               Home Assistant OS 16.3
  Home Assistant Core:      2025.12.4

  Home Assistant URL:       http://homeassistant.local:8123
  Observer URL:             http://homeassistant.local:4357

System is ready! Use browser or app to configure.
➜  ~ curl -fsSL https://raw.githubusercontent.com/4ngel2769/rpi_oled_stats/main/autoinstall_oled_stats.sh | bash

╔════════════════════════════════════════════════════════════════╗
║                 🚀 Starting OLED Installation...               ║
╠════════════════════════════════════════════════════════════════╣
║ Script Version: v0.14.3                                          ║
║ Script Author: 4ngel2769 / @angeldev0                          ║
║ Original Code: MKlement (mklements)                            ║
╚════════════════════════════════════════════════════════════════╝

[<< INFO >>] 🚀 Starting OLED Stats Display installation...
[❌ ERROR] 🚫 This script is designed for Raspberry Pi only!

When I connect via root, it also fails, as root can't sudo, it looks like (it also tries to install as the pi user which I don't think is available)

$ ssh root@homeassistant.local -p 22222
Welcome to Home Assistant OS.

Use `ha` to access the Home Assistant CLI.
# pwd
/root
# curl -fsSL https://raw.githubusercontent.com/4ngel2769/rpi_oled_stats/main/autoinstall_oled_stats.sh | bash

╔════════════════════════════════════════════════════════════════╗
║                 🚀 Starting OLED Installation...               ║
╠════════════════════════════════════════════════════════════════╣
║ Script Version: v0.14.3                                          ║
║ Script Author: 4ngel2769 / @angeldev0                          ║
║ Original Code: MKlement (mklements)                            ║
╚════════════════════════════════════════════════════════════════╝

[<< INFO >>] 🚀 Starting OLED Stats Display installation...
[<< SUCCESS] Raspberry Pi detected
[<< SUCCESS] Pi model is compatible with OLED Stats
bash: CURRENT_STEP++: not found
bash: who: not found
[<< INFO >>] 👤 Installing for user: pi
[<< INFO >>] 🏠 Home directory: /home/pi
[<< INFO >>] ⚙️ Updating system packages...
bash: sudo: not found

Any suggestions? Unsure if it's possible/easy to do a modification or variant of the setup script for HomeAssistant?

cc: @4ngel2769 ?

[4ngel2769]

hey @georgestephanis thanks for opening the issue, i'll be looking into this further.

Looking at your errors, it seems you're running into two main problems:

1. The script's Raspberry Pi detection fails on Home Assistant OS because HAOS uses a minimal Buildroot-based system (not Debian-based like RaspberryPi OS), so /proc/device-tree/model and other checks don't behave the same way or work at all.
2. Even if those checks would work, the script relies heavily on apt, sudo, standard user accounts (like pi), and a writable filesystem, none of which HAOS handles well.

That being said, I would highly recommend against running the installation script inside HAOS since it's not built for manually installing packages like the script does. Your best bet is using docker to run it in a container via the official Portainer add-on.
Something like this:

1. Get the Portainer add-on from the store.
2. Inside Portainer create a new Stack.
3. Use this compose config:

version: '3'
services:
  oled_stats:
    image: ghcr.io/4ngel2769/rpi_oled_stats:latest
    container_name: oled_stats
    restart: unless-stopped
    privileged: true  # required for i2c access
    devices:
      - /dev/i2c-1:/dev/i2c-1
    environment:
      - SCRIPT=status.py  # or monitor.py, stats.py, psutilstats.py
      - OLED_ROTATION=1   # 1=normal, 2=upside down

4. Deploy the stack.

Let me know if it works or doesn't!

p.s.: Make sure i2c is enabled in homeassistantOS https://community.home-assistant.io/t/add-on-hassos-i2c-configurator/264167