Skip to content

How to install Agent on TrueNAS CORE in the jail

Starting from Resilio Connect 2.12, the Agent can be installed on a TrueNAS CORE system using a standalone jail.

TrueNAS CORE Version

This method is compatible with TrueNAS CORE 12.0 and newer.

Connect Agent Version

This method installs Resilio Connect Agent version 3.8.3.2313. To install a different version, contact support.

TrueNAS SCALE Warning

While TrueNAS SCALE is based on Debian and allows command-line access via SSH or local console, installing packages using apt or dpkg can:

  • Disrupt system stability and functionality
  • Be overwritten during routine updates or upgrades
  • Break compatibility with the TrueNAS web interface and middleware
  • Lead to unsupported system states or data integrity risks

Important: These actions are not supported by iXsystems and should be avoided in production environments.

Requirements for Installation

  • TrueNAS CORE version 12.0 or newer
  • Shell access with root permissions
  • Internet access from the TrueNAS CORE system

To install the Resilio Active Everywhere Agent on TrueNAS CORE:

  1. Open a shell and run the install script as root. Optionally specify a ZFS pool name for jail placement.

     wget https://internal.resilio.com/support/freenas/install_v3.sh
 chmod +x ./install_v3.sh
 ./install_v3.sh -s resilio-connect-mc-address-or-ip:8444 [-p <zfspoolname>]

    install1.png

    1X.X-RELEASE Was Not Found

    The script uses 12.2-RELEASE by default. If you encounter an error such as "1X.X-RELEASE was not found!", run the following:

    iocage list  iocage fetch

    Then, edit the script and replace the FREEBSD_VERSION=12.2-RELEASE line with the release version that is installed or fetched.

    If successful, the Agent will start and connect to the Management Console. You will need to approve the Agent in the MC interface.

    install2.png approve.png

  2. A new jail named resilioagentjail will be created. To access data inside the jail, create a mount point:

    1. Stop the jail.
    2. Open the jail details, then go to Mount Points.
    3. Click Actions → Add.
    4. Select a source folder from the ZFS pool and set the destination path inside the jail. mount1.png mount2.png mount3.png

    Start the jail once the mount point is configured.

  3. The jail is now running, and you can add mapped folders to your Resilio Job.

    You can start or stop the Resilio Connect Agent by starting or stopping the jail.

    All settings, logs, and the Agent database are stored in /var/rslagent/ inside the jail. The jail path on disk may vary.