TSF – Giải pháp IT toàn diện cho doanh nghiệp SMB | HCM

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:

ComponentState 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:

ComponentReason
Apps (containers) installedApps configuration is restored but the container must be redeployed
Docker image / App dataNot in config file → you must keep the apps dataset
ZFS poolMust be imported manually first
Files in datasetNot 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 conflictRestored 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:

 
 
System → Storage → Import Pool
 

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:

 
 
System → General → Upload Config
 

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:

 
 
Directory Services → Active Directory → Join
 

This step re-establishes authentication trust.


Step 5 – Check Apps

Navigate:

 
 
Apps → Manage → Re-deploy (if needed)
 

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:

 
 
/data/freenas-v1.db
 

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:

 
 
/mnt/smbbackup
 

Step 2 – Create Cron Job to Backup Config

Go to:

 
 
GUI → System → Advanced → Cron Job
 

Add this command:

 
 
cp /data/freenas-v1.db /mnt/smbbackup/truenas_config_$(date +%F).db
 

What this does:

  • Copies configuration database

  • Automatically appends date

  • Example output:

 
 
truenas_config_2026-02-19.db
 

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 More

P20 – 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 More

P18 – 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