# NasWarden

NasWarden is a self-hosted infrastructure app. Real-time monitoring dashboard for TrueNAS SCALE with ZFS pool, dataset, disk, VM and alert overviews. It is open source and self-hosted, installable on TrueNAS.

Canonical page: https://ourlocalhost.com/app/7775/naswarden

## Description

Real-time monitoring dashboard for TrueNAS SCALE with ZFS pool, dataset, disk, VM and alert overviews.

## Platform availability

Available on 1 of 10 platforms: TrueNAS.

## Health score

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

## Links

- TrueNAS: https://apps.truenas.com/catalog/naswarden/
- GitHub: https://github.com/ahmd-soliman/naswarden

## Common questions

### What Docker access do I need to configure for NasWarden?

Use a Docker proxy by setting DOCKER_HOST or DOCKER_PROXY_URL to the proxy address on port 2375. Or mount /var/run/docker.sock and run NasWarden with the docker group, usually gid 999. In the TrueNAS catalog app, set that group and add the socket host path as read-only.

### Does NasWarden track ZFS dataset quotas?

Yes, it discovers datasets with quota or refquota configured and displays live consumed space against the limit. It also shows the quota source and space held by snapshots, which helps with dataset-level exhaustion that mountpoint tools miss.

### How do I connect Incus to NasWarden?

Incus is optional and requires a client certificate. You make the certificate on any machine and then configure the Incus client and network listener from a shell on the TrueNAS host, because the TrueNAS web interface lacks those pages.

### Does NasWarden export Prometheus metrics?

It includes Prometheus metrics and supports PromQL Linear Exhaustion Forecasting.

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