TrueNAS Apps: Tutorials
Application maintenance is independent from TrueNAS version release cycles.
App versions, features, options, and installation behavior at time of access might vary from documented tutorials and UI reference.
Remote Assist
3 minute read.
TrueNAS Enterprise
The Remote Assist app is intended for use by TrueNAS Enterprise customers with active support contracts and iXsystems support staff only. TrueNAS community use of Remote assist for any reason is outside of the intended purposes and not supported.
The Remote Assist app allows TrueNAS Enterprise support personnel remote access to customer systems to assist with deploying or troubleshooting an environment. Remote Assist uses Tailscale to create secure connections between support staff and customers. Authentication is established with a one-time use authentication key, provided by iXsystems support and used for the duration of the active deployment or support case.
We recommend that customers create a restricted admin account and enable auditing for remote assistance sessions. This ensures that production passwords are not shared with iXsystems and retains a log of the actions taken by the support personnel during the session. Support personnel can guide you through configuration.
After the remote assistance session completes, delete the Remote Assist application from the TrueNAS system. This fully deauthorizes the remote connection. It cannot be re-established without creating a new authentication key and redeploying Remote Assist at a later date, such as to resolve a future support case.
Go to Apps, click on Discover Apps, and locate the Remote Assist app widget by either scrolling down to it or begin typing the name into the search field. Select the widget to open the Remote Assist information screen. Click Install to open the app installation wizard.
Accept the default value or enter a name in Application Name field. In most cases use the default name, but if adding a second deployment of the application you must change this name.
Accept the default version number in Version. When a new version becomes available, the application shows an update badge and the Application Info widget on the Installed applications screen shows the Update button.
Enter the label provided by iXsystems support in System Identifier.
Enter the one-time authentication key provided by iXsystems support in Auth Key.
Click Install.