NAS Guard Help

FAQ
EN DE
FAQ
Frequently asked questions

How do I install the Agent?

The easiest way is directly from the NAS Guard iOS app: go to your server's settings, scroll to Server Monitoring, select a pool and tap Install Agent. You can also install manually if you need to customize the configuration.

Does the Agent need a persistent data directory?

Yes. The Agent stores state (including the certificate pin) so it survives restarts and updates.

Why does the Agent talk about a certificate pin?

If your TrueNAS uses a self-signed certificate, the Agent can pin the certificate fingerprint (TOFU). This avoids insecure “accept any certificate” behavior.

When should I reset the pin?

Only if the TrueNAS certificate was changed intentionally or you switched the TrueNAS system/host.

Can I use multiple TrueNAS systems?

Yes. NAS Guard supports multiple server profiles. Without any purchase, you can configure one server. With the Unlimited Servers In-App Purchase, you can add as many servers as you like. Each server has its own profile, API key, and Agent pairing.

What is the Control Pack?

Control Pack is an In-App Purchase that unlocks remote actions on your TrueNAS: start/stop services, apps, and VMs; create and delete snapshots; run replication, Cloud Sync, Rsync, and TrueCloud Backup tasks; manage scrubs, shares, and datasets; install system updates; and use the On-Device Assistant. See Control Pack for the full list.

Can I browse files on my NAS?

Yes. NAS Guard has a built-in file browser that navigates your TrueNAS filesystem via the API. You can preview documents and images with QuickLook, play audio with the built-in player, and stream videos with the built-in video player. See File Browser for details.

Can I stream videos from my NAS?

Yes. The built-in video player supports direct streaming and HLS streaming via the NAS Guard Agent. The Agent remuxes video formats that AVPlayer cannot play natively (such as MKV, AVI, WMV) into HLS. See File Browser for supported formats.

What are widgets?

NAS Guard provides Home Screen widgets (Small, Medium, Large) and Lock Screen widgets (Circular, Rectangular, Inline) that show live server status at a glance. Widgets are updated automatically via push notifications from the Agent. See Widgets for details.

What is the On-Device Assistant?

The On-Device Assistant lets you ask questions about your server in plain language. It is processed privately on-device using Apple Intelligence — nothing leaves your iPhone. It requires the Control Pack and an Apple Intelligence-enabled device. It is an early beta and may occasionally state values incorrectly.

Does NAS Guard work with TrueNAS CORE?

NAS Guard is designed for TrueNAS SCALE and uses the WebSocket JSON-RPC 2.0 API. Compatibility with TrueNAS CORE has not been verified.