Docs

Troubleshooting TrueNAS

Work from runtime and connectivity checks toward the specific failed operation.

Common Symptoms

SymptomCheck
Encoded PHP fails to loadWeb/CLI PHP target, compatible ionCube Loader, package integrity and PHP read permissions.
Test Connection failsAssigned NAS hostname, port, parent dataset, API permissions, routing and trusted certificates.
Web works but cron failsCLI PHP/Loader, CA trust, permissions and consistent server identity.
Connection fails after IP additionActual source address after NAT, selected account, firewall and global protocol daemon.
Password change refusedSupported NAS version, closed protocols, no active sessions and owned resource state.
Snapshot restore refusedOwnership, bundle completeness and session/protocol requirements.

Preserve Recovery Evidence

For an uncertain operation, record the timestamp, exact message and service identity. Keep recovery journals and avoid repeated destructive requests. Do not change NAS ownership metadata or remove journals to force a success.

TLS And Licensing

Correct CA trust or certificate configuration rather than disabling verification. An issuer outage is subject to the existing signed cache and expiry limits; it does not authorize bypassing licensing or resetting installation identity.

Escalate

Stop on unexpected cross-account effects, ownership mismatches or inconsistent file/block restore results. Use the support checklist and sanitize all screenshots.

Need help with this guide? Contact HERZA →

Search Documentation

Search across all products · Esc to close