# NASlab Agent

NASlab Agent is a self-hosted monitoring & logging app. Read-only monitoring agent for the NASlab Android app. It is open source and self-hosted, installable on Unraid.

Canonical page: https://ourlocalhost.com/app/7723/naslab-agent

## Description

Read-only monitoring agent for the NASlab Android app. It measures your server every 30 seconds (temperature sensors, CPU load, GPU usage, RAM, network, disk spin-ups and which programs caused them, top processes, cache usage per share) and keeps a file index for searching all shares. History: 8 days at full resolution, 2 years of hourly values, stored in /config. Beta: tested on Unraid 7 (amd64); arm64 untested. It never changes anything on your server: every host path is mounted read-only, only /config is writable, root is dropped after start (PUID/PGID), and the container runs read-only with almost all capabilities removed. Optional and off by default: SMART values (NZBLAB_SMART), backup discovery for extra paths (NZBLAB_BACKUP_PATHS), redacted log excerpts (NZBLAB_LOGS), home network device list (NZBLAB_LAN), and service discovery for Sonarr, Radarr, Prowlarr, SABnzbd, Tautulli.

## Platform availability

Available on 1 of 10 platforms: Unraid.

## Health score

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

## Links

- Official website: https://tuxxler.github.io/nzblab
- Unraid: https://ca.unraid.net/apps/app_25eb61e9044950bf
- GitHub: https://github.com/Tuxxler/nzblab-agent

## Common questions

### Do I need to run NASlab-Agent for the Android app?

No, the agent is optional. The NASlab app also works without it.

### How do I install it on Unraid?

Add the unraid-templates repository, save it, then add a container using the NASlab-Agent template. If it is approved in Community Apps, you can also install it by searching Apps for NASlab-Agent.

### Which port and token do I use in the app?

Enter your server with port 8099 and the token printed once in the container log. From agent version 1.20.0, the same port speaks HTTPS with a self-generated certificate and, during the transition, plain HTTP.

### Where does the agent store data I should back up?

It writes only to its /config folder. That folder holds the history and the token.

### How do I prevent the agent from reading service API keys automatically?

Set DISCOVER_KEYS=0. By default it reads service API keys for auto-connect, and the discover endpoint that returns keys is served only over HTTPS and only in a 30-minute window after start.

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