Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

PD-1618 / 25.04 / Pd 1618 rewrite solutions integrations nextcloud article #3325

Merged
merged 6 commits into from
Dec 9, 2024
Merged

PD-1618 / 25.04 / Pd 1618 rewrite solutions integrations nextcloud article #3325

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
6 commits
Select commit Hold shift + click to select a range
439d9fa
PD-1618 Rework Nextcloud Plugin Article Content
micjohnson777 Dec 2, 2024
54e6cc3
PD-1618 Minor Content Updates
micjohnson777 Dec 2, 2024
141f00c
PD-1618 Change Plugin EOL information
micjohnson777 Dec 3, 2024
4e9cdfe
Merge branch 'master' into PD-1618-Rewrite-Solutions-Integrations-Nex…
Mrt134 Dec 5, 2024
bc2e903
Update Nextcloud.md
tonyriv3 Dec 9, 2024
e41a99f
Merge branch 'master' into PD-1618-Rewrite-Solutions-Integrations-Nex…
tonyriv3 Dec 9, 2024
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
57 changes: 33 additions & 24 deletions content/Solutions/Integrations/Nextcloud.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,21 +1,30 @@
---
title: "Nextcloud"
description: "Guide for deploying the Nextcloud plugin with TrueNAS."
description: "Guide for deploying Nextcloud in TrueNAS."
weight: 26
aliases:
- /core/solutions/integrations/nextcloud/
---

## Nextcloud Plugin
## Nextcloud in TrueNAS

The [Nextcloud](https://nextcloud.com/) plugin is a suite of client-server software for creating and using file hosting services.
[Nextcloud](https://nextcloud.com/) is a suite of client-server software for creating and using file hosting services.

### Plugins Catalog
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]({{< relref "/content/TruenasApps/StableApps/InstallNextCloudMedia.md" >}}).

{{< expand "Before getting started..." "v" >}}
* You must have a [data pool]({{< relref "CORE/CORETutorials/Storage/Pools/_index.md" >}}) available for plugin storage.
* You must connect the system to the internet.
Go to **Network > Interfaces**, edit the intended plugin interface, and set **Disable Hardware Offloading**.
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

{{< expand "Before You Begin" "v" >}}
Before installing the Nextcloud plugin:
* Create a new or use an existing [data pool]({{< relref "CORE/CORETutorials/Storage/Pools/_index.md" >}}) 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**.
{{< /expand >}}

To see the plugin catalog, go to the **Plugins** screen.
Expand All @@ -24,10 +33,10 @@ To see the plugin catalog, go to the **Plugins** screen.
{{< /expand >}}

![PluginsList](/images/CORE/Plugins/PluginsList.png "Plugins Catalog")
{{< expand "I don't see anything!" "v" >}}
If the catalog doesn't load:
{{< expand "I do not see anything!" "v" >}}
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 `ping` an Internet address.
* Open the **Shell** and enter the `ping` command and an Internet address.
The output confirms the system is connected to the Internet.
{{< /expand >}}

Expand All @@ -39,19 +48,18 @@ TrueNAS organizes plugins into two **Collections**:
By default, TrueNAS shows the iXsystems-supported plugins.
To see the community plugins, open **Browse a Collection** and select **Community**.

### Installation

{{< tabs "Install Types" >}}
{{< tab "Basic Install" >}}
### Installing a Plugin
You have two plugin installation options:
{{< expand "Basic Install" "v" >}}
Go to **Plugins** and select **Nextcloud**, then click **INSTALL**.

![NextcloudInstall](/images/Solutions/SolutionsIntegrationsNextcloudInstall.png "Nextcloud Install")

Type a **Jail Name** and click **SAVE**.
Enter a name in **Jail Name** and click **SAVE**.

![NextcloudJailName](/images/Solutions/SolutionsIntegrationsNextcloudJailName.png "Nextcloud Jail Name")

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

![NextcloudPostInstall](/images/Solutions/SolutionsIntegrationsNextcloudPostInstall.png "Nextcloud Post Install")

Expand All @@ -63,14 +71,14 @@ 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.

![NextcloudHub](/images/Solutions/SolutionsIntegrationsNextcloudLogin.png "Nextcloud Hub")
{{< /tab >}}
{{< /expand >}}

{{< tab "Static IP Install" >}}
{{< expand "Static IP Install" "v" >}}
Go to **Plugins** and select **Nextcloud**, then click **INSTALL**.

![NextcloudInstall](/images/Solutions/SolutionsIntegrationsNextcloudInstall.png "Nextcloud Install")

Type a **Jail Name**, then disable the **NAT** checkbox and enter an available IP in the **IPv4 Address** field.
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**.

![NextcloudStatic1](/images/Solutions/NextcloudStatic1.png "Nextcloud Static Setup")
Expand All @@ -87,14 +95,15 @@ Scroll to the `trusted_domains` section and type your Nextcloud IP as a new line

Type <kdb>CTRL+C</kdb> 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.
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.

![NextcloudLogin](/images/Solutions/SolutionsIntegrationsNextcloudLogin.png "Nextcloud Login")

Enter the credentials from **POST INSTALL NOTES** and click **Log in**. You are directed to the Nextcloud Hub.
{{< /tab >}}
{{< /tabs >}}
{{< /expand >}}

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

Expand Down
9 changes: 5 additions & 4 deletions static/includes/JailsPluginsFirstTime.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,11 +1,12 @@
&NewLine;
Going to the **Jails** or **Plugins** screen for the first time prompts you to select a location on the system for storing Jail related data.

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.

![JailsPluginsStorage](/images/CORE/Jails/JailsPluginsStoragePool.png "Choosing a Storage Pool for Jails and Plugins")

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!*
* Make sure you back up any critical data or snapshots that are stored in a jail before changing the storage configuration.
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 <i class="fa fa-cog" aria-hidden="true" title="Settings"></i>, select a new pool, and click **CHOOSE**.
To change the jails and plugins storage location, click <i class="fa fa-cog" aria-hidden="true" title="Settings"></i>, select a new pool, and click **CHOOSE**.
Loading