TrueNAS SCALETrueNAS SCALE Documentation Archive
This content follows the TrueNAS SCALE 22.12 (Bluefin) releases. Archival documentation is provided for reference only and not actively maintained.
Use the Product and Version selectors above to view content specific to different TrueNAS software or major version.

Rsync Services Screen

SCALE 22.12.3 deprecates several built-in features. SCALE 23.10 replaces deprecated features with applications that perform their roles. See SCALE Feature Deprecations for more details about feature deprecation and replacement.
This service is not needed when rsync is configured externally with SSH or with the TrueNAS built-in rsync task in SSH mode. It is always recommended to use rsync with SSH as a security best practice.

Rsync is a utility that copies data across a network. This service configures and enables an rsync server that other remote systems can access as part of a remote sync operation. The Services > Rsync screen has two tabs: Configure and Rsync Module.

Configure Screen

The Rsync > Configure screen displays the TCP Port and Auxiliary Parameters settings.

Services Rsync Configure Screen
Figure 1: Services Rsync Configure Screen
SettingDescription
TCP PortEnter the port rsyncd listens on.
Auxiliary ParametersEnter any additional parameters from rsyncd.conf(5).

Rsync Module Screen

The Rsync Module screen displays a list of current rsync modules configured on the system.

Before an rsync module is configured, the No RSYNC Modules screen displays. Click Add to configure a module to use when the Rsync service is active.

Rsync Module No Rsync Module
Figure 2: Rsync Module No Rsync Module
Services Rsync Module
Figure 3: Services Rsync Module

Click the name of the module or the navigate_next arrow to display the details of the module.

Rsync Module Details Screen

The rsync module details screen displays connections, user, group, allow and deny host information, and any auxiliary parameters configured for that module.

Edit opens the Edit Rsync Module screen. Delete opens a confirmation dialog.

Add or Edit Rsync Module Screens

Rsync > Add and Rsync > Edit screens specify the general, access and other settings for the rsync module.

SettingDescription
NameEnter a module name that matches the name requested by the rsync client.
PathEnter or uses the arrow_right to the left of folder/mnt to browse to the pool or dataset to store received data.
CommentEnter a description for this module.
EnabledSelect to activate this module for use with Rsync. Leave clear to deactivate the module without completely removing it.
SettingDescription
Access ModeSelect the permission level for this rsync module from the dropdown list. Options are Read Only, Write Only, or Read and Write.
Max ConnectionsEnter the maximum number of connections to this module. 0 is unlimited.
UserEnter or select the TrueNAS user account that runs the rsync command during file transfers to and from this module from the dropdown list.
GroupEnter or select the TrueNAS group account that runs the rsync command during file transfers to and from this module from the dropdown list.
Hosts AllowEnter a list of patterns to match with the host name and IP address of a connecting client (from rsyncd.conf(5). The connection is rejected if no patterns match. Separate entries by pressing Enter.
Hosts DenyEnter a list of patterns to match with the hostname and IP address of a connecting client (from rsyncd.conf(5). The connection is rejected when the patterns match. Separate entries by pressing Enter.
SettingDescription
Auxiliary ParametersEnter any additional parameters from rsyncd.conf(5).

Related Content