Container reports "unhealthy" when specifying "LISTEN_ADDR"

[evnet]

What installation are you running?

Production (netalertx) 📦

Is there an existing issue for this?

• I have searched the existing open and closed issues and I checked the docs https://docs.netalertx.com/

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

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

Current Behavior

Docker container reports "unhealthy" when specifying "LISTEN_ADDR"

This is caused by this using "localhost", which fails when not listening on "0.0.0.0".

Patching the above line as follows appears to resolve the issue, with the status reporting "healthy".

[ "${LISTEN_ADDR}" == "0.0.0.0" ] && LISTEN_ADDR="localhost"
if curl -sf --max-time 10 "http://${LISTEN_ADDR}:${PORT:-20211}" | grep -i "netalertx" > /dev/null; then

Expected Behavior

The status should report as "healthy"

Steps To Reproduce

1. Add the "LISTEN_ADDR" environment to the "docker-compose.yml" file, specifying the host IP address (not 0.0.0.0).
2. Start the container
3. Monitor the status (run docker ps)

Relevant app.conf settings

docker-compose.yml

Debug or Trace 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.

Relevant app.log section

N/A

Docker Logs

$ docker inspect --format "{{json .State.Health }}" NetAlertX
{"Status":"starting","FailingStreak":0,"Log":[{"Start":"2026-02-23T00:16:16.239541438Z","End":"2026-02-23T00:16:16.297530086Z","ExitCode":1,"Output":"[HEALTHCHECK] Starting comprehensive health check...\n[HEALTHCHECK] ✓ supercronic is running\n[HEALTHCHECK] ✓ php-fpm is running\n[HEALTHCHECK] ✓ nginx is running\n[HEALTHCHECK] ✓ python /app/server is running\n[HEALTHCHECK] ERROR: Port 20211 is not responding or doesn't contain 'netalertx'\n[HEALTHCHECK] ❌ One or more health checks failed\n"}]}

[jokob-sk]

Thanks forteh report.

@adamoutler can you have a look when you have some downtime? Thanks!

[jokob-sk]

Should be available in the next release. #1544

It would be great if you could test the ghcr.io/netalertx/netalertx-dev Docker image in ~15 minutes (or once the latest GitHub Action finishes).

⚠️ Please back up everything first, or ideally spin up a separate container with its own DB and config (a copy of your current setup), as database changes may occur.

After updating:

• Click the 🔄 refresh button in the blue header at the top
• Hard refresh your browser cache (shift + reload) to force js and css files reload

Disclaimer: Running the dev container long-term may lead to data loss, as upgrade paths are not guaranteed.

Thanks in advance,
j

[evnet]

Tested using docker container image ghcr.io/netalertx/netalertx-dev (5d0c3d9243b1).
The container has continued to report "healthy" for 15 minutes.
Note: Testing has been limited to monitoring the docker status.

[jokob-sk]

Thanks for testing @evnet !

[jokob-sk]

Releasing in 1h -> Closing