TrueNAS SCALETrueNAS Nightly Development Documentation
This content follows experimental nightly development software. Pre-release software is intended for testing purposes only.
Use the Product and Version selectors above to view content specific to a stable software release.

Managing the System Configuration

TrueNAS SCALE allows users to manage the system configuration by uploading or downloading configurations, or by resetting the system to the default configuration.

System Configuration Options

The Manage Configuration option on the System > General Settings screen provides three options:

  • Download File that downloads your system configuration settings to a file on your system.
  • Upload File that allows you to upload a replacement configuration file.
  • Reset to Defaults that resets system configuration settings back to factory settings.

Downloading the File

The Download File option downloads your TrueNAS SCALE current configuration to the local machine.

When you download the configuration (config) file, you have the option to include encrypted passwords in the config file. Select Export Password Secret Seed to download this file. Downloading both the config file and the secret seed file allows you to restore the system to a different operating system device where the decryption seed is not already present.

Physically secure the config file, any encryption key files, and the secret seed file as it contains the seed to prevent unauthorized access or password decryption.

We recommend backing up the system configuration regularly. Doing so preserves settings when migrating, restoring, or fixing the system if it runs into any issues. Save the configuration file each time the system configuration changes.

Go to System > General Settings and click on Manage Configuration. Select Download File.

The Save Configuration dialog opens.

Select Export Password Secret Seed and then click Save. The system downloads the system configuration. Save this file in a safe location on your network where files are regularly backed up.

To maintain a current file, download the config file anytime you change your system configuration. Keep the config file safe.

Uploading the File

The Upload File option gives users the ability to replace the current system configuration with any previously saved TrueNAS SCALE configuration file.

All passwords are reset if the uploaded configuration file was saved without selecting Save Password Secret Seed.

Resetting to Defaults

TrueNAS Enterprise

Enterprise High Availability (HA) systems should never reset their system configuration to defaults. Contact iXsystems Support if a system configuration reset is required.

iXsystems Support

Customers who purchase iXsystems hardware or that want additional support must have a support contract to use iXsystems Support Services. The TrueNAS Community forums provides free support for users without an iXsystems Support contract.

iXsystems Customer Support
Support Portalhttps://support.ixsystems.com
Emailsupport@ixsystems.com
Telephone and Other Resourceshttps://www.ixsystems.com/support/

Save the current system configuration with the Download File option before resetting the configuration to default settings! If you do not save the system configuration before resetting it, you could lose data that was not backed up, and you cannot revert to the previous configuration.

The Reset to Defaults option resets the system configuration to factory settings. After the configuration resets, the system restarts and users must set a new login password.

Backing Up the Config File

SCALE does not automatically back up the system configuration file to the system dataset.

Users who want to schedule an automatic backup of the system configuration file should:

  1. Set up TrueCommand.
  2. Add their SCALE system.
  3. Create and schedule the configuration file backup.

Users can manually back up the SCALE config file by downloading and saving the file to a location that is automatically backed up.