NetAlertX Legacy + v26 Split in BigBearUniversal Apps

Big Bear Universal Apps Big Bear Universal Apps - Releases
1

About

NetAlertX is a WIFI / LAN intruder detector that scans for devices connected to your network and alerts you if new and unknown devices are found.

NetAlertX v26 introduced breaking changes that affect existing installations:

  • Volume paths changed from /app/config and /app/db to /data/config and /data/db
  • Privileged mode removed in favor of specific Linux capabilities (NET_RAW, NET_ADMIN, etc.)
  • New environment variables: PUID and PGID for proper user/group mapping
  • tmpfs mount added for /tmp

To avoid breaking existing installs, the original netalertx app has been frozen as a legacy version and a new netalertx-v26 app has been created with the updated configuration.

What Changed

NetAlertX (Legacy)

  • Frozen at version 25.11.29 — the last release before the breaking changes
  • Renovate updates have been disabled for this app
  • Existing users can continue running this version without any changes
  • Name updated to “NetAlertX (Legacy)” for clarity

NetAlertX v26 (New)

  • Uses the latest v26 release with all the new improvements
  • Improved security: Replaces privileged: true with specific capability restrictions:
    cap_drop:
  - ALL
cap_add:
  - NET_RAW
  - NET_ADMIN
  - NET_BIND_SERVICE
  - CHOWN
  - SETUID
  - SETGID
  • Updated volume paths: /data/config and /data/db
  • New env vars: PUID=1000, PGID=1000
  • tmpfs: /tmp mounted as tmpfs

Migration Warning

If you are migrating from the legacy version to v26, your existing data will NOT be migrated automatically. The volume paths have changed, so you will need to manually move your data. See the NetAlertX documentation for migration instructions.

App Stores

The Big Bear Universal Apps repository syncs to:

  • BigBearCasaOS
  • Big Bear Runtipi
  • Big Bear Umbrel
  • Big Bear Cosmos
  • Big Bear Dockge
  • Big Bear Portainer

Default Configuration

NetAlertX v26

  • Port: 8080
  • Config: /data/config volume
  • Database: /data/db volume
  • Network Mode: host
  • PUID: 1000
  • PGID: 1000

Resources

Community Support

1 Like
2

Hi all.

I still see in CasaOS App Store 26.2.6, which is unhealthy container. Refreshing my local App list restarting CasaOS services (follow this advice) does not work.

I see there is 26.3.7 in Big Bear CasaOS repository, but I cannot get it using CasaOS AppStore. Only manually custom install…

I hope upstream developer (IceWhale) fix it soon, it is very annoying and confusing.

3

Hello @j900,

Have you restarted your CasaOS? Sometimes that gets the app store updated. I’ve had other people say it’s working now.