NetAlertX - Network, presence scanner and alert framework

Get visibility of what's going on on your WIFI/LAN network and enable presence detection of important devices. Schedule scans for devices, port changes and get alerts if unknown devices or changes are found. Write your own Plugin with auto-generated UI and in-build notification system. Build out and easily maintain your network source of truth (NSoT) and device inventory.

Scanners

The app scans your network for New devices, New connections (re-connections), Disconnections, "Always Connected" devices down, Devices IP changes and Internet IP address changes. Discovery & scan methods include: arp-scan, Pi-hole - DB import, Pi-hole - DHCP leases import, Generic DHCP leases import, UNIFI controller import, SNMP-enabled router import. Check the Plugins docs for a full list of avaliable plugins.

App Link

GitHub

GitHub - jokob-sk/NetAlertX: Network intruder and presenc...

Network intruder and presence detector. Scans for devices connected to your network and alerts you if new and unknown devices are found. - jokob-sk/NetAlertX

App Docs

https://docs.netalertx.com/

NOTE:

1. First make folders and set permissions:

mkdir -p /mnt/user/appdata/netalertx

chown -R 20211:20211 /mnt/user/appdata/netalertx

chmod -R 755 /mnt/user/appdata/netalertx

2. Enjoy

Warning:

Using tmpfs reduces disk writes and speeds up I/O, but all data stored in memory will be lost on restart.

If you need to keep a persistent, file-based log history, add Log Path to the container:

/mnt/user/appdata/netalertx/log:/tmp/log

In case you see in the logs:

• Error: unable to open database "/data/db/app.db": unable to open database file

• ══════════════════════════════════════════════════════════════════════════════

• ❌ CRITICAL: Database schema creation failed for /data/db/app.db.

Run in host:

mkdir -p /mnt/user/appdata/netalertx/db

chown -R 20211:20211 /mnt/user/appdata/netalertx

Edited February 10Feb 10 by Masterwishx

@Krakout Try: chmod 777 /mnt/user/appdata/netalertx

10 hours ago, Masterwishx said:

@Krakout Try: chmod 777 /mnt/user/appdata/netalertx

Surprisingly, that doesn't work either. Still getting "Error: unable to open database "/data/db/app.db": unable to open database file".

In the log, though, it says that /data/db and /data are indeed writeable buuuut in the /appdata/netalertx dir there's no db subdir? That sounds weird... So I manually created the db subdir and chmodded it, and now it's running.

(for some reason I can't edit my previous post. just wanted to add: now I have to read on this package because it shows no data whatsoever)

Oh, there, it just took a while for the initial scan, never mind.

Edited December 1, 2025Dec 1 by Krakout

9 minutes ago, Krakout said:

Surprisingly, that doesn't work either. Still getting "Error: unable to open database "/data/db/app.db": unable to open database file".

Strange...

Maybe another method was to try to container let make `mnt/user/appdata/netalertx` by himself without created folder before.

I was updated from already old version of container so had already all folders exist.

Just now, Masterwishx said:

Strange...

Maybe another method was to try to container let make `mnt/user/appdata/netalertx` by himself without created folder before.

I was updated from already old version of container so had already all folders exist.

Yeah that makes sense, what doesn't make sense is the log saying that db was writeable while it didn't even exist

5 minutes ago, Krakout said:

what doesn't make sense is the log saying that db was writeable while it didn't even exist

But now it's fine?

Just now, Masterwishx said:

But now it's fine?

Yes, yes, it's fine. Maybe amend the instructions to also create the db directory, or have the container template create it?

1 hour ago, Krakout said:

Yes, yes, it's fine. Maybe amend the instructions to also create the db directory, or have the container template create it?

Checked on the new container , opened issue : https://github.com/jokob-sk/NetAlertX/issues/1327

Edited December 1, 2025Dec 1 by Masterwishx

For anyone not able to start their container after the latest updated. I added

--cap-add="CHOWN" --cap-add="SETGID" --cap-add="SETUID"

to the extra params list. I ended up removing CHOWN as it didn't appear to actually be needed.

15 hours ago, calvolson said:

For anyone not able to start their container after the latest updated. I added

--cap-add="CHOWN" --cap-add="SETGID" --cap-add="SETUID"

Yep, already updated xml template

/mnt/cache/ for /mnt/cache/appdata/netalertx and /mnt/cache/appdata/logs
will have better performance than /mnt/user/

I learned this the hard way couple years ago. ESPhome would take 5 minutes to compile tiny sketches. changing to /mnt/cache, 20 seconds.

Got this error when installing:

docker run
  -d
  --name='NetAlertX'
  --net='host'
  --pids-limit 2048
  -e TZ="Europe/Helsinki"
  -e HOST_OS="Unraid"
  -e HOST_HOSTNAME="ugreen"
  -e HOST_CONTAINERNAME="NetAlertX"
  -e 'TCP_PORT_20211'='20211'
  -l net.unraid.docker.managed=dockerman
  -l net.unraid.docker.webui='http://[IP]:[PORT:20211]'
  -l net.unraid.docker.icon='https://raw.githubusercontent.com/jokob-sk/NetAlertX/main/front/img/NetAlertX_logo_notification.png'
  -v '/mnt/user/containers/netalertx':'/data':'rw'
  -v '/etc/localtime':'/etc/localtime':'ro'
  --read-only
  --cap-drop="ALL"
  --cap-add="NET_ADMIN"
  --cap-add="NET_RAW"
  --cap-add="NET_BIND_SERVICE"
  --cap-add="CHOWN"
  --cap-add="SETUID"
  --cap-add="SETGID"
  --tmpfs "/tmp:uid=20211,gid=20211,mode=1700,rw,noexec,nosuid,nodev,async,noatime,nodiratime" 'jokobsk/netalertx'


5a8084da852ac695cf0b4c308b69544dcccf9e78adf1c261e8698895c0457db2
docker: Error response from daemon: error while creating mount source path '/etc/localtime': mkdir /etc/localtime: file exists.

The command failed.

On 1/24/2026 at 4:54 AM, TRusselo said:

/mnt/cache/ for /mnt/cache/appdata/netalertx and /mnt/cache/appdata/logs
will have better performance than /mnt/user/

If you make appdata exclusive share, I think then no matter what you write...