🧪 Ongoing DEV branch testing

[corasaniti]

🧪 Help test the dev build (ongoing)

Want to help catch bugs before they reach production?

You can test the latest development changes anytime using the dev image:
ghcr.io/netalertx/netalertx-dev
(usually updated after each GitHub Action run)

---

⚠️ Before you start

Please back up your setup, or ideally:

• Run a separate container
• Use a copy of your database and config

Dev builds may include breaking or experimental changes, including database updates.

---

🔄 After updating

• Click the 🔄 refresh button in the header
• Hard refresh your browser (Shift + Reload) to ensure JS/CSS are fully updated

---

🙏 Why this matters

Early testing helps catch issues before release.
If features aren’t validated, they may need to be delayed or temporarily removed to keep things stable.

---

⭐ Support the project

If you find NetAlertX useful, consider:

• Sharing it at work or with your network
• Posting on forums or socials
• Leaving a quick review

👉 #971

---

Disclaimer: Running the dev container long-term is not recommended. Upgrade paths are not guaranteed and data loss may occur.

---

Thanks to everyone helping test — it genuinely makes releases smoother 🙌

---

Original message

Is there an existing issue for this?

• I have searched the existing open and closed issues and I checked the docs https://jokob-sk.github.io/NetAlertX/

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

Hi attached log
Thanks

_netalertx-dev_logs.txt

Expected Behavior

attached log

Steps To Reproduce

attached log

app.conf

docker-compose.yml

What installation are you running?

Production (netalertx)

app.log

attached log

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 @corasaniti ,

We are doing some significant rework so the next release will need docker-compose.yml changes. Here is an example:

services:
  netalertx:
    container_name: netalertx
#    image: "jokobsk/netalertx-dev"
    image: "ghcr.io/jokob-sk/netalertx-dev:latest"
    network_mode: "host"
    cap_add:                          # 🆕 New line
      - NET_RAW                       # 🆕 New line 
      - NET_ADMIN                     # 🆕 New line
      - NET_BIND_SERVICE              # 🆕 New line
    volumes:
      - ${APP_DATA_LOCATION}/netalertx_fresh/config:/app/config
      - ${APP_DATA_LOCATION}/netalertx_fresh/db:/app/db
    environment:
      - TZ=Europe/Berlin
      - PORT=20211
    # 🆕 New "tmpfs" section START 🔽
    tmpfs: 
      # Speed up logging.
      - "/app/log:uid=20211,gid=20211,mode=1700,rw,noexec,nosuid,nodev,async,noatime,nodiratime"
      # Speed up API access
      - "/app/api:uid=20211,gid=20211,mode=1700,rw,noexec,nosuid,nodev,sync,noatime,nodiratime"  
      # Required for customization of the nginx 
      - "/services/config/nginx/conf.active:uid=20211,gid=20211,mode=1700,rw,noexec,nosuid,nodev,async,noatime,nodiratime"
      # /services/config/nginx/conf.d 
      - "/services/run:uid=20211,gid=20211,mode=1700,rw,noexec,nosuid,nodev,async,noatime,nodiratime"
      # /tmp is required by php
      - "/tmp:uid=20211,gid=20211,mode=1700,rw,noexec,nosuid,nodev,async,noatime,nodiratime"
    # 🆕 New "tmpfs" section END  🔼

you might also need to run this command before applying the new compose file:

Note

Note netalertx is the container name and you need to replace /volume2/docker_appdata/netalertx with your folder where your /db and /config folders are stored.

sudo docker run -it --rm --name netalertx --user "0" \
  -v /volume2/docker_appdata/netalertx /config:/app/config \
  -v /volume2/docker_appdata/netalertx /db:/app/db \
  jokobsk/netalertx-dev:latest

[corasaniti]

@jokob-sk
Will it be possible to install it on an existing database, or do I need to start from scratch?
I am currently using version: v25.10.1
Thanks

[jokob-sk]

You will be able to use the existing DB and config files. You can try to migrate a copy of your setup based on my above comment. Just did a migration myself yesterday. https://jokob-sk.github.io/NetAlertX/MIGRATION/#13-migration-from-netalertx-v25101

[adamoutler]

There are some changes coming very soon to make it more apparent what's going on eg. I'd assume it would look something like this on your system.

+---------------+-----------+-------+---------+-------------+----------+
| Path          | Writeable | Mount | RAMDisk | Performance | DataLoss |
+---------------+-----------+-------+---------+-------------+----------+
| /app/db       | ✅        | ✅    | ➖      | ➖          | ✅       |
| /app/config   | ✅        | ✅    | ➖      | ➖          | ✅       |
| /app/api      | ✅        | ❌    | ❌      | ❌          | ✅       |
| /app/log      | ✅        | ❌    | ❌      | ❌          | ✅       |
| /services/run | ✅        | ❌    | ❌      | ❌          | ✅       |

You can read here about the full recommended config. https://github.com/jokob-sk/NetAlertX/blob/next_release/docs/DOCKER_COMPOSE.md

[corasaniti]

@jokob-sk

The migration has been in progress for several minutes. Does the log output look correct? (see attached screen)
How long does the migration process take?
Thanks in advance.

[adamoutler]

You're up and running. Any errors in docker logs? What about the webui PHP/nginx? Anything you can tell? That output looks good.

[corasaniti]

@adamoutler
What port is the PHP/nginx web UI listening on? It's been migrating for several hours (about 5) and still hasn't finished.
Thanks

[adamoutler]

20211. What's migrating? I don't see that in logs.

[corasaniti]

@adamoutler
Unfortunately, I didn't expose the port with the docker run command, and I can't reach the web interface. I'm migrating an older installation to a pi5.

It's been running for about 6 hours now, and I think I wanted to stop it. Something went wrong :-(

The command I ran for the one-off migration is the following

docker run -it --rm --name netalertx-dev --user "0" \
	-v /home/pi/docker/netalertx-dev/config:/app/config \
	-v /home/pi/docker/netalertx-dev/db:/app/db \
	jokobsk/netalertx:latest

[corasaniti]

@jokob-sk
@adamoutler
Nothing, I stopped debugging, it didn't work. The dev branch still doesn't work.
The documentation isn't clear :-(

I'd like a clear guide for starting from a fresh installation, keeping only the device list and the configuration file, but with a new DB.

/config/app.conf
/config/devices.csv
/config/workflows.json

[corasaniti]

@adamoutler @jokob-sk

I started from a scratch installation, backing up only the /config folder but with a new DB. I used the following docker compose on the dev branch, but it didn't work. Here is the attached log
I will no longer test the DEV branch
See attached error log

services:
  netalertx:                                  
    container_name: netalertx-dev               
    image: "jokobsk/netalertx-dev"     # 🆕 This is important
    ports:
      - 20211:20211
    dns:
      - 192.168.2.1
    network_mode: "host"       
    cap_add:                          # 🆕 New line
      - NET_RAW                       # 🆕 New line 
      - NET_ADMIN                     # 🆕 New line
      - NET_BIND_SERVICE              # 🆕 New line 
    restart: unless-stopped
    volumes:
      - /home/pi/docker/netalertx-dev/config:/app/config
      - /home/pi/docker/netalertx-dev/db/:/app/db
    environment:
      - TZ=Europe/Rome      
      - PORT=20211
    # 🆕 New "tmpfs" section START 🔽
    tmpfs: 
      # Speed up logging. This can be commented out to retain logs between container restarts
      - "/app/log:uid=20211,gid=20211,mode=1700,rw,noexec,nosuid,nodev,async,noatime,nodiratime"
      # Speed up API access as frontend/backend API is very chatty
      - "/app/api:uid=20211,gid=20211,mode=1700,rw,noexec,nosuid,nodev,sync,noatime,nodiratime"  
      # Required for customization of the nginx listen addr/port without rebuilding the container
      - "/services/config/nginx/conf.active:uid=20211,gid=20211,mode=1700,rw,noexec,nosuid,nodev,async,noatime,nodiratime"
      # /services/config/nginx/conf.d is required for nginx and php to start
      - "/services/run:uid=20211,gid=20211,mode=1700,rw,noexec,nosuid,nodev,async,noatime,nodiratime"
      # /tmp is required by php for session save this should be reworked to /services/run/tmp
      - "/tmp:uid=20211,gid=20211,mode=1700,rw,noexec,nosuid,nodev,async,noatime,nodiratime"
    # 🆕 New "tmpfs" section END  🔼

_netalertx-dev_logs.txt