Nextcloud

3 minute read.

Last Modified 2024-12-11 13:36 EST

Nextcloud in TrueNAS

Nextcloud is a suite of client-server software for creating and using file hosting services.

TrueNAS offers one deployment option for setting up Nextcloud, a Linux Debian-based TrueNAS version application available in TrueNAS releases 24.10 and later. For the Linux Debian-based app instructions, see Nextcloud.

TrueNAS offered a FreeBSD-based TrueNAS Nextcloud plugin in releases 13.0 and earlier, and 13.3, but it is no longer available in TrueNAS 13.0 because of changes in FreeBSD, and it is soon to be unavailable in 13.3. Refer to release notes for more information on upcoming and current changes.

This article provides instructions for the FreeBSD-based Nextcloud plugin.

Plugin Catalogs

Before You Begin

Before installing the Nextcloud plugin:

Create a new or use an existing data pool to use for plugin storage.
Connect the system to the Internet. Go to Network > Interfaces, edit the intended plugin interface, and set Disable Hardware Offloading.

To see the plugin catalog, go to the Plugins screen.

First time in this menu?

The first time you go to the Jails or Plugins screen TrueNAS prompts you to select a location on the system for storing jail-related data.

By default, this location stores all data related to jails and plugins, including downloaded applications, data managed by the jail or plugin, and any jail snapshots.

Disconnecting or deleting the pool that stores jail data can result in permanent data loss! Back up all critical data or snapshots stored in a jail before changing the storage configuration.

To change the jails and plugins storage location, click , select a new pool, and click CHOOSE.

PluginsList

I do not see anything!

If the catalog does not load:

Go to Network > Global Configuration and confirm the Default Gateway and DNS Servers addresses are correct.
Open the Shell and enter the ping command and an Internet address. The output confirms the system is connected to the Internet.

TrueNAS organizes plugins into two Collections:

iXsystems maintained plugins
Open source plugins created and maintained by TrueNAS users.

By default, TrueNAS shows the iXsystems-supported plugins. To see the community plugins, open Browse a Collection and select Community.

Installing a Plugin

You have two plugin installation options:

Basic Install

Go to Plugins and select Nextcloud, then click INSTALL.

Enter a name in Jail Name and click SAVE.

After Nextcloud installs successfully, you can manage your plugin instance.

Click POST INSTALL NOTES to obtain your Nextcloud admin user and Nextcloud admin password information. Click MANAGE to access the Nextcloud login page within your browser.

Enter the credentials from POST INSTALL NOTES and click Log in to access the Nextcloud Hub.

Static IP Install

Go to Plugins and select Nextcloud, then click INSTALL.

Enter a name in Jail Name, then select the NAT checkbox to clear it, and then enter an available IP in the IPv4 Address field. Select an IPv4 Netmask (iX recommends 24), then click SAVE.

After Nextcloud installs, you must add your Nextcloud IP to your Nextcloud jail trusted domains.

Go to Jails and expand your Nextcloud jail, then click > SHELL.

Enter ee /usr/local/www/nextcloud/config/config.php to edit your Nextcloud config file.

Scroll to the trusted_domains section and type your Nextcloud IP as a new line item. Use the image below for reference.

Type CTRL+C to close the editor, then type exit to close the config file.

Go back to Plugins and expand your Nextcloud instance.

Click POST INSTALL NOTES to obtain your Nextcloud admin user and Nextcloud admin password information. Click MANAGE to access the Nextcloud login page within your browser.

Enter the credentials from POST INSTALL NOTES and click Log in. You are directed to the Nextcloud Hub.

Refer to the Nextcloud documentation for details about using the Nextcloud platform: