Using Plugins

How to install or configure application plugins.

  5 minute read

Plugins allow you to extend the built-in NAS services by installing additional software. A plugin is a pre-packaged application that is installed into a FreeBSD Jail. The plugin jail is limited to installing and using only the plugin software.

To begin using plugins, you need to have a data pool available for plugin storage and the system needs to be connected to the Internet. It is also recommended to go to Network > Interfaces and set Disable Hardware Offloading for the interface that you want to use for plugins.

Installing a Plugin

Open the Plugins menu to find the plugins that are available to download. If no options appear, verify the system can ping an Internet address and confirm the default gateway address and DNS server address are correct in Network > Global Configuration.

Plugins are organized by those supported by iXsystems and open source plugins created and maintained by the TrueNAS community. By default, the iXsystems-supported plugins are shown. To view the community-supported plugins, open Browse a Collection and select Community.

To install a plugin, click the plugin icon then Install.

Enter a name for the plugin jail and adjust the networking settings as needed. Most plugins default to using Network Address Translation (NAT) for their Internet connection, but you can choose to use a dynamically-generated address with DHCP or define static IP addresses for the plugin jail. Using NAT is recommended as it does not require manual configuration of multiple available IP addresses and prevents addressing conflicts on the network. Some plugins default to DHCP as their management utility conflicts with NAT. Keep these plugins set to DHCP unless a manually configured IP address is preferred.

Plugins can take several minutes to download and install. A dialog confirms when the installation is complete and shows any post-install notes. You can view the post-install notes later by expanding the entry for the installed plugin in Plugins and clicking   Post Install Notes.


If a plugin download or update fails with an error about being unable to fetch an artifact or download a package, you might need to investigate your networking environment. Some home routers can have a security feature that prevent DHCP enabled plugins (or bridged devices with virtual MAC addresses) from resolving addresses. Also, sometimes additional DNS validation is required that is not supported by the router or the router has a caching resolver that is holding on to a stale record. A couple of possible solutions are to hard reset your router to clear any stale records or try using an alternate DNS server for the plugin.

Plugin Configuration

After a plugin is installed, an entry is added to the Plugins screen.

You can manage the plugin state, update the plugin application, configure the plugin jail mount points to storage datasets, and, when supported, open a link to the management portal for the plugin application.

Plugin jails are preconfigured and typically require very little tuning, but you can reconfigure the jail properties in the event that a setting needs to change (updating the network configuration, for example). To update or reconfigure the plugin jail, go to the Jails screen and expand the entry for one of the plugin jails. You need to