P12 - Backup and Restore System Configuration TrueNAS
🚀 TrueNAS P12 – How to Backup and Restore TrueNAS SCALE System Configuration (Full Guide)
Backing up data is important — but backing up your system configuration is critical.
In this complete tutorial, you will learn how to Backup and Restore System Configuration TrueNAS SCALE properly and safely. This ensures that after a crash, hardware failure, or fresh installation, you can restore your entire NAS setup within minutes.
This guide covers:
What is fully restored when restoring config
What is NOT restored and must be redone
Standard recovery procedure after reinstall
Important warnings
Manual backup and restore via GUI
Automated scheduled configuration backup
Whether you run a home lab or enterprise storage, configuration backup is non-negotiable.
🧠 1️⃣ What Is Restored FULL When Restoring Config?
When you restore the configuration file, the following components will be recovered:
| Component | State after restoring config |
|---|---|
| User account (local user) | ✔ Restore |
| Group (local group) | ✔ Restore |
| Dataset permissions (ACL) | ✔ Restore (if dataset still exists!) |
| SMB / NFS / iSCSI config | ✔ Restore |
| Cron jobs / Periodic tasks | ✔ Restore |
| Network config (IP, VLAN, Bridge) | ✔ Restore |
| Alert, email, notification config | ✔ Restore |
| Apps catalog, settings | ✔ Restore (but must match dataset) |
| Directory Services (AD/LDAP) configuration | ✔ Restore (but must rejoin domain) |
| ZFS dataset structure | ✔ (But must import pool before restoring config) |
| Replication tasks | ✔ Restore |
| Certificates, SSH Keys | ✔ Restore |
💡 Important: The configuration file restores settings — not actual data.
⚠ 2️⃣ Things NOT Restored / Must Be Redone
Some components require manual intervention:
| Component | Reason |
|---|---|
| Apps (containers) installed | Apps configuration is restored but the container must be redeployed |
| Docker image / App data | Not in config file → you must keep the apps dataset |
| ZFS pool | Must be imported manually first |
| Files in dataset | Not in config → must keep the old disk/pool |
| Domain join (AD/LDAP) | Config is available, but you must rejoin after restore |
| Network may be in conflict | Restored IP may conflict → manual adjustment may be needed |
Understanding this prevents unexpected issues after recovery.
🔄 3️⃣ STANDARD PROCEDURE TO RESTORE TRUENAS AFTER REINSTALL
This is the most important section.
Step 1 – Reinstall TrueNAS with Same or Higher Version
Install the same version or higher.
Example:
Backup Dragonfish 24.04 → restore to 24.10 is still OK.
Step 2 – Import Storage Pool
Navigate:
Dataset + files must be intact because configuration does NOT contain data.
If the pool is not imported, ACL and dataset references will fail.
Step 3 – Restore Config File
Navigate:
Select the .db file you previously backed up.
The system will reboot automatically.
After reboot, most services and settings will return instantly.
Step 4 – Rejoin AD/LDAP (If Available)
Configuration exists but domain must be rejoined:
This step re-establishes authentication trust.
Step 5 – Check Apps
Navigate:
Containers may need redeployment depending on environment.
⚠ 4️⃣ IMPORTANT Note When Restoring
Restore permissions dataset:
Configuration file only restores ACL when dataset still exists.
If the pool is formatted → restore config cannot help.
This is why importing the correct storage pool is mandatory before restoring config.
💾 5️⃣ Backup and Restore via GUI (Quick Test)
TrueNAS allows manual configuration backup.
You can:
Download configuration file
Delete a user (example: user bao)
Restore configuration file
Verify that user bao returns
Example workflow:
Backup OS → Delete user bao → Restore OS → user bao OK.
This confirms configuration restore works correctly.
📅 6️⃣ Automatic Backup Schedule
TrueNAS SCALE already maintains its main configuration file at:
Important facts:
• This is the main configuration database of SCALE.
• GUI and CLI changes automatically write to this file.
• Configuration is always “live” in this file.
That means backup is as simple as copying this file safely.
Step 1 – Mount External Backup Folder
Mount external storage such as:
SMB
NFS
Google Drive
Other remote storage
Example mount path:
Step 2 – Create Cron Job to Backup Config
Go to:
Add this command:
What this does:
Copies configuration database
Automatically appends date
Example output:
This ensures:
✅ Versioned config backups
✅ Easy rollback
✅ Quick disaster recovery
🎯 Final Result
After completing this guide, you can:
✅ Backup and Restore System Configuration TrueNAS safely
✅ Recover users, network, services, and tasks
✅ Restore after crash or hardware failure
✅ Automate configuration backup
✅ Minimize downtime
With proper configuration backup, you can rebuild your entire TrueNAS environment in minutes instead of hours.
📌 Conclusion
Data backup protects files.
Configuration backup protects your entire system architecture.
Understanding how to Backup and Restore System Configuration TrueNAS is essential for every serious NAS administrator.
Without configuration backup, rebuilding services manually can take hours or days.
With it, recovery takes minutes.
Never deploy TrueNAS in production without automated configuration backups.
See also related articles
P21 – Effortless WordPress TrueNAS Setup Guide
P21 – Effortless WordPress TrueNAS Setup Guide 🚀 TrueNAS P21 – WordPress TrueNAS Apps Demo Deploy WordPress Easily (No Docker Skills Needed) Deploying WordPress on a NAS no longer requires deep Docker knowledge or complex manual configurations. With WordPress TrueNAS Apps, you can launch a fully functional WordPress instance directly...
Read MoreP20 – Essential ZFS Disk Scrubbing Best Practices Guide
P20 – Essential ZFS Disk Scrubbing Best Practices Guide 🚀 TrueNAS – P20: ZFS Disk Scrubbing – Step-by-Step Configuration & Best Practices Maintaining data integrity is one of the most important responsibilities of any storage administrator. Even enterprise-grade disks can develop silent data corruption over time. This is where ZFS...
Read MoreP18 – Ultimate MFA TrueNAS Security Setup Guide
P18 – Ultimate MFA TrueNAS Security Setup Guide 🚀 TrueNAS – P18: Secure TrueNAS with MFA (Google Authenticator) – Full Configuration Tutorial Security is critical for any production storage system. A strong password alone is no longer enough. If credentials are leaked, brute-forced, or reused elsewhere, your entire NAS infrastructure...
Read More