NetAlertX (Docker latest) - MQTT plugin missing / not exposed (GraphQL build) - Unable to integrate with Home Assistant via MQTT

[Rishabh11200]

What installation are you running?

Production (netalertx) 📦

Did I research?

• I have searched the docs https://docs.netalertx.com/
• I have searched the existing open and closed issues
• I confirm my SCAN_SUBNETS is configured and tested as per https://docs.netalertx.com/SUBNETS

The issue occurs in the following browsers. Select at least 2.

• Firefox
• Chrome
• Other (unsupported) - PRs welcome
• N/A - This is an issue with the backend

What I want to do

I am trying to integrate NetAlertX running on a Raspberry Pi (local network) with Home Assistant running on a VPS.

My architecture:

• NetAlertX running locally on Raspberry Pi (Docker)
• Home Assistant + Mosquitto running on VPS
• VPN (WireGuard) connects Pi ↔ VPS

Goal:

• Use NetAlertX to detect devices on LAN
• Send device presence to Home Assistant via MQTT (as documented)

What I tried:

1. Installed latest official Docker image:
   ghcr.io/netalertx/netalertx:latest

2. Successfully:

   • Enabled scanning (ARP works)
   • Enabled GraphQL API
   • Verified devices query via GraphQL works

3. Attempted to enable MQTT:

   • Checked UI → no MQTT option
   • Checked Publishers → only Email available
   • Tried ENV variables (MQTT_ENABLE, MQTT_SERVER, etc.) → no effect
   • Queried GraphQL → plugins field not available
   • Checked container filesystem → no MQTT plugin present

Conclusion:
MQTT plugin appears to be missing or not included in this image.

---

Expected behavior:

• MQTT plugin should be available (as per docs)
• Ability to enable MQTT and connect to Home Assistant

Actual behavior:

• No MQTT plugin in UI
• No MQTT via GraphQL
• No MQTT functionality available at all

---

Question:
Is MQTT plugin intentionally removed/disabled in the current ghcr.io/netalertx/netalertx:latest image?

If yes:

• What is the recommended way to integrate with Home Assistant?
• Should we use GraphQL instead?

If not:

• How can MQTT be enabled in this image?

Relevant settings you changed

Docker run command:

docker run -d
--name netalertx
--network=host
--restart unless-stopped
--cap-add NET_ADMIN
--cap-add NET_RAW
--cap-add NET_BIND_SERVICE
-v netalertx_data:/data
-v /etc/localtime:/etc/localtime:ro
--tmpfs /tmp
-e PORT=20211
-e APP_CONF_OVERRIDE='{"GRAPHQL_PORT":"20214"}'
ghcr.io/netalertx/netalertx:latest

GraphQL enabled and working:
http://PI_IP:20214/graphql

Working queries:

• devices
• settings
• appEvents

Missing:

• plugins query
• MQTT functionality

docker-compose.yml

Not using docker-compose. Running container via docker run.

app.log

Key observations from logs:

• GraphQL initialized successfully
• Device scanning working
• No references to MQTT in logs
• No MQTT connection attempts
• No plugin loading logs related to MQTT

Additionally:

• No errors related to MQTT → suggests plugin not loaded at all

Debug enabled

• I have read and followed the steps in the wiki link above and provided the required debug logs and the log section covers the time when the issue occurs.

[jokob-sk]

Hi,

Did you follow the docs and/or the plugin description: https://docs.netalertx.com/PLUGINS/?h=enabl#enabling-plugins

[Rishabh11200]

Hi,

Thanks for the clarification — I missed the LOADED_PLUGINS configuration.

I was under the impression that MQTT would be available by default in the latest image, but I now understand it needs to be explicitly enabled.

I will update my setup to include the MQTT plugin via LOADED_PLUGINS and test again.

Appreciate the quick help!

Closing this issue.