[Help wanted] HomeAssisstant addon

[jokob-sk]

Is there an existing issue for this?

• I have searched the existing open and closed issues

Is your feature request related to a problem? Please describe

I'm getting requests to support an official HomeAssistant addon, however my bandwidth is limited and I'm pretty much fully focused on back end, plugins and front end work, so maintaining another installation method is currently for me not possible. However, if someone from the community would like to take this on, that would be awesome.

https://developers.home-assistant.io/docs/add-ons
https://github.com/home-assistant/addons-example

Describe the solution you'd like

Have official HomeAssistant addon support

Describe alternatives you've considered

Separate NAX instance

Anything else?

N/A

Am I willing to test this? 🧪

• I will do my best to test this feature on the netlertx-dev image when requested within 48h and report bugs to help deliver a great user experience for everyone and not to break existing installations.

Can I help implement this? 👩‍💻👨‍💻

• Yes
• No

[glancep]

+++++++1

I've wanted this for quite some time. I'm no docker expert, but I don't think this should be particularly difficult. I actually have it working as a "local" addon ... had to work out some issues to ensure data was persisted, and I just now updated to the latest version (from 24.10.31) and it is stuck with the loading spinner -- I'm guessing something related to the new GraphQL port??

I'm happy to share the config file I used for the initial local addon if that would be helpful.

name: "NetAlertX"
description: "Run the latest stable version of NetAlertX"
url: "https://netalertx.com"
slug: "netalertx"
init: false
arch:
  - aarch64
  - amd64
  - armhf
  - armv7
startup: application
webui: "[PROTO:option_name]://[HOST]:[PORT:20211]"
boot: auto
ingress: true
ingress_port: 20211
panel_icon: mdi:lan
host_network: true
ports:
  20211/tcp: 20211
map:
  - type: addon_config
    read_only: false
    path: /app/config
  - type: data
    read_only: false
    path: /app/db
image: jokobsk/netalertx
version: 24.12

[jokob-sk]

Thanks @glancep !

It's possible it's the new port - maybe try adding it to the ports section?

ports:
  20211/tcp: 20211
  20212/tcp: 20212

I'm just guessing however... you can also check the browser debug console, it should say something like this after a while:

graphQLServerStarted: 0
graphQLServerStarted: 0
graphQLServerStarted: 1 

[glancep]

Thanks, @jokob-sk. I'll give that a try. I'm a little worried if that's the issue, though -- would that mean I have to have that port open all the way to the browser/client? I'm using Cloudflare Tunnel and NGINX Proxy Manager, so I don't think the browser would be able to hit that port even with it exposed from the container.

[jokob-sk]

hummm, not sure ... I have not yet experimented with tunnels but it is possible that it would have to be added. 🤔

[jokob-sk]

@glancep just FYI, I created a PR here in one of the well-maintained addon repositories: alexbelgium/hassio-addons#1695