Unlocking a Replication Encrypted Dataset or Zvol

Unlocking a Replicated Encrypted Dataset or Zvol Without a Passphrase

TrueNAS users should either replicate the dataset/Zvol without properties to disable encryption at the remote end or construct a special JSON manifest to unlock each child dataset/zvol with a unique key.

Read full post gdoc_arrow_right_alt

Adding a Google Photos Cloud Sync Task

On March 31, 2025, Google changed the Google Photos API to allow external applications to access and manage only the media and albums they create. Cloud sync tasks continue to upload photos to albums created by the TrueNAS sync client, but reading from your full photo library or from shared albums does not work as expected. Some operations return permission errors.

Read full post gdoc_arrow_right_alt

Backup Credentials

TrueNAS stores cloud backup services credentials, SSH connections, and SSH key pairs configured using the widgets on the Backup Credentials screen. Users can set up backup credentials with cloud and SSH clients to back up data in case of drive failure.

The Backup Credentials screen displays the Cloud Credentials, SSH Connections, and SSH Keypairs widgets.

Click Add on the widget for the type of credential to add to open that configuration screen.

Read full post gdoc_arrow_right_alt

Creating Snapshots

Snapshots are one of the most powerful features of ZFS. A snapshot provides a read only point-in-time copy of a file system or volume. This copy does not consume extra space in the ZFS pool. The snapshot only records the differences between storage block references whenever the data is modified.

Why do I want to keep snapshots? Snapshots keep a history of files and provide a way to recover an older or even deleted files. For this reason, many administrators take regular snapshots, store them for some time, and copy them to a different system. This strategy allows an administrator to roll the system data back to a specific point in time. In the event of catastrophic system or disk failure, off-site snapshots can restore data up to the most recent snapshot.

Taking snapshots requires the system have all pools, datasets, and zvols already configured.

Read full post gdoc_arrow_right_alt

Managing Snapshots

Viewing the List of Snapshots

File Explorer limits the number of snapshots Windows presents to users. If TrueNAS responds with more than the File Explorer limit, File Explorer shows no available snapshots. TrueNAS displays a dialog stating the dataset snapshot count has more snapshots than recommended and states performance or functionality might degrade.

There are two ways to view the list of snapshots:

Read full post gdoc_arrow_right_alt

Backing Up TrueNAS

After configuring your TrueNAS storage and data sharing or any other function, service, or application, it is time to ensure an effective data backup.

You should also:

TrueNAS provides several options to set up a data storage backup method, including using a cloud sync provider and a scheduled task or configuring a replication task.

Read full post gdoc_arrow_right_alt

SSH

The SSH service lets users connect to TrueNAS with the Secure SHell Transport Layer Protocol. When using TrueNAS as an SSH server, the users in the network must use SSH client software to transfer files with SSH.

Allowing external connections to TrueNAS is a security vulnerability! Do not enable SSH unless you require external connections. See Security Recommendations for more security considerations when using SSH.

Configuring SSH Service

To configure SSH go to System > Services, find SSH, and click to open the basic settings General Options configuration screen.

Read full post gdoc_arrow_right_alt

SSH Service Screen

The System > Services > SSH screen allows you to set up SSH service on TrueNAS.

Click to open the Services > SSH configuration screen.

Allowing external connections to TrueNAS is a security vulnerability! Do not enable SSH unless you require external connections. See Security Recommendations for more security considerations when using SSH.

You must also configure SSH backup credentials to allow SSH access. See SSH Screens for more information.

Read full post gdoc_arrow_right_alt

Advanced Replication Tasks

TrueNAS advanced replication allows users to create one-time or regularly scheduled snapshots of data stored in pools, datasets, or zvols on their TrueNAS system as a way to back up stored data. When properly configured and scheduled, local or remote replication using the Advanced Replication Creation option takes regular snapshots of storage pools or datasets and saves them in the destination location on the same or another system.

Replication from one pool or dataset to another pool or dataset on the TrueNAS system is called local replication. Replication from the TrueNAS system to another TrueNAS or other backup server is called remote replication. Both local and remote replication can involve encrypted pools or datasets.

Read full post gdoc_arrow_right_alt

Replication Task Screens

The Replication Task widget on the Data Protection screen lists replication tasks configured on the TrueNAS system. The widget shows a definition of replication tasks before adding a task when none exist on the system.

Replication Task Widget without Tasks
Replication Task Widget with Tasks

Replication tasks work with periodic snapshot tasks to complete the replication. After scheduling a replication task, the Periodic Snapshot Task widget shows a new task for the newly added replication task.

Read full post gdoc_arrow_right_alt