TrueNAS Integration
If a TrueNAS box holds your storage, you shouldn't need a second dashboard to keep an eye on it. WolfStack connects to TrueNAS over its API and shows ZFS pool health, datasets, disks, NFS exports and snapshots right next to your servers — and lets you create and delete snapshots without leaving WolfStack.
Each cluster in the sidebar gets a Storage entry where TrueNAS servers live. Register as many as you like — each belongs to the cluster you add it from.
What You Need
- TrueNAS SCALE (or CORE) with the REST API enabled — it is by default.
- An API key — created in the TrueNAS UI under Credentials → Local Users → API Keys. A read-scoped key covers everything except snapshot create/delete, which needs write scope.
- The server's LAN address, e.g.
https://10.2.0.153/api/v2.0.
Connecting a Server
- In the sidebar, open your cluster, click Storage — the TrueNAS tab is the default.
- Click + Add server.
- Enter a label, the API URL, and paste the API key. Optionally name the primary pool to feature on the Overview tab.
- Leave Accept self-signed TLS ticked unless you've installed a real certificate (TrueNAS ships self-signed).
- Click Add & test — WolfStack verifies the connection before saving, so bad credentials never persist.
The API key is encrypted at rest on the WolfStack node (AES-256-GCM) and is never sent to your browser.
What You See
| Tab | Contents |
|---|---|
| Overview | Pool health and capacity (with last scrub state), every dataset with usage, and every physical disk with model and serial. |
| Snapshots | All ZFS snapshots, with one-click create (optionally recursive) and delete. |
| NFS Exports | Each export's path, allowed networks, and read-only/read-write state — handy when pointing WolfStack backups or storage mounts at the NAS. |
| Settings | Add, edit, test and remove servers. Editing never requires re-entering the API key unless you're changing it. |
Good to Know
- Works across every TrueNAS version. WolfStack talks to TrueNAS over its REST API on SCALE 25.04 and earlier (and CORE), and automatically switches to the newer JSON-RPC WebSocket API on releases that have retired REST — SCALE 25.10 (where the ZFS snapshot endpoints were removed) and TrueNAS 26 (which removes the REST API entirely). The fallback is automatic and needs no configuration, so pool/dataset/snapshot management keeps working straight through a TrueNAS upgrade.
- Multiple servers, multiple clusters. A TrueNAS instance tagged to a cluster appears only under that cluster's Storage view — useful when different teams own different NAS boxes.
- Got an Unraid box instead (or as well)? See the Unraid integration — same idea, same one-dashboard view.
Try this on your own servers
WolfStack is free for personal use and installs in about two minutes — one command, no agents, works on any Linux server or Raspberry Pi.
Running it at work? Commercial licences start small and fund development.