# NetSpy

NetSpy is a self-hosted monitoring & logging app. Web dashboard showing real-time network + disk monitoring of Unraid (and other hosts): interface rates, per-process breakdown (incl. It is open source and self-hosted, installable on Docker Hub and Unraid.

Canonical page: https://ourlocalhost.com/app/2574/netspy

## Description

Web dashboard showing real-time network + disk monitoring of Unraid (and other hosts): interface rates, per-process breakdown (incl. SMB sessions per client), per-container traffic, disk I/O per process, CPU/RAM per process, latency/health, storage fill-level history and SSH web terminals. One image, two roles — this template installs the web role; add agents on other hosts (TrueNAS/Debian) via the repo's docker-compose.yml.

## Platform availability

Available on 1 of 10 platforms: Unraid.

## Health score

51/100 (Fair), based on 3 of 4 factors.
- Maintained: 90 (last commit 35 days ago)
- Popular: 0 (0 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)

## Links

- Docker Hub: https://hub.docker.com/r/thefirstmojo/netspy
- Unraid: https://ca.unraid.net/apps/netspy-1sb36ig11j6coc?q=NetSpy

## Common questions

### Does NetSpy require a database or .env file?

No. NetSpy samples at 1 second intervals and runs without a database or a .env file.

### Can I identify which client is transferring over SMB?

Yes. smbd rows are split by client IP, such as smbd[10.0.0.5], so you can see which client is loading a share.

### Is storage fill-level history recorded automatically?

No. Recording is opt-in per drive, and activating a drive creates its chart. The data is kept in storage_history.json under /netspy/data and survives restarts.

### Do web terminal sessions survive reloading the page?

Yes. Terminals survive tab switches and browser reloads, using tmux attach on the target when tmux is installed and a plain login shell in other cases.

---
Source: Our Local Host (https://ourlocalhost.com/app/2574/netspy), the self-hosted and open-source app directory.
