Configuring Nextcloud to use Linode Object Storage as an External Storage Mount
Updated by Linode Contributed by Linode
Nextcloud is an open source solution for file hosting and sharing. With Nextcloud, you can synchronize files from a local computer to the Linode server and share them with collaborators. Nextcloud’s customizable security features and intuitive user interface keeps the files safe and easy to manage.
You can configure Nextcloud to enable external storage devices and services, like Linode Object Storage, to use as a secondary place to store files. Using Linode Object Storage to store files prevents you from running out of storage space limited by the Linode’s plan size. When using Nextcloud’s graphical user interface (GUI) to manage files, the external storage device shows up just like any other folder.
Before You Begin
Deploy a Nextcloud server instance. You can use the Linode Nextcloud One-Click App for an easy and quick deployment.
If you are not familiar with Linode Object Storage, review the How to Use Linode Object Storage guide.
In This Guide
Nextcloud provides an app that makes it easy to configure an external storage device or service. You first enable this app in Nextcloud’s app settings.
After the External Storage app is enabled, you can provide the necessary configurations to connect Nextcloud to a Linode Object Storage bucket as documented in the Create a New Linode Object Storage External Storage Mount section.
Enable the External Storage App
In this section you enable the External Storage Support Nextcloud app in order to use external storage sources.
NoteYou must belong to the
adminuser group in order to install the External storage support app.
Log into your Nextcloud instance.
Click the user icon (or cog wheel) in the top navigation menu and select Apps.
Click Files to access all Nextcloud apps related to file management, in the left-hand navigation menu.
Use the search field in the top navigation to narrow down the visible apps. You can enter external as your search term.
Viewing the External storage support app, click the Enable button in order to install it to the Nextcloud instance.
Create a New Linode Object Storage External Storage Mount
After enabling the External Storage Support app, you are now ready to add a new external storage mount. You configure the new external storage mount to use the Linode Object Storage service.
Click the user icon (or cog wheel) in the top navigation menu and select Settings.
In the left-hand navigation menu, under the Administration heading, click External Storages. The External Storages administration page appears.
In the Folder name text entry box, provide a name for the external storage directory.
From the External Storage dropdown menu, select the Amazon S3 option.
NoteLinode Object Storage is S3-compatible. Nextcloud connects to Amazon’s Object Storage service by default, however, in the next step you override the default behavior to use Linode Object Storage hosts instead.
Select Access Key from the Authentication dropdown menu.
Under the Configuration heading, provide the following configurations:
Configuration Description Bucket The name to assign to the Object Storage bucket. If this bucket name already exists in the data center region you select, an error occurs. Hostname The hostname used for the Object Storage region where the bucket is be stored. Refer to the Linode Object Storage Region and Hostname Values note located below this table for available hostname values. Port The port number to use to access the Object Storage host. This value must be
Region The data center region to store your Object Storage bucket. Refer to the Linode Object Storage Region and Hostname Values note located below this table for available data center region IDs. Enable SSL A configuration to enable secure sockets layer (SSL). This configuration must be enabled. Enable Path Style This configuration changes the default path format used by Nextcloud to access the Object Storage bucket. Do not enable this configuration. Legacy (v2) Authentication This configuration enables version 2 authentication to the Object Storage service. By default Nextcloud uses version 4 authentication that is compatible with Linode Object Storage. Do not enable this configuration. Access Key The value of the Access Key you created using the Linode Cloud Manager. Secret Key The value of the Secret Key you created using the Linode Cloud Manager.
Linode Object Storage Region and Hostname Values
Region Region ID Hostname Newark, NJ, USA
us-east-1.linodeobjects.com Frankfurt, Germany
eu-central-1.linodeobjects.com Singapore, Singapore
In the Available for text entry box, enter the group name(s) you would like to give access to the Linode Object Storage external storage. To learn more about user and group permissions related to external storage, see Nextcloud’s documentation.
Click the check icon to save the configurations. If all your configurations are valid, you should see a green check box appear next to the external storage entry.
Using the top navigation menu, click the Files menu item. The external storage folder appears in the list of folders.
Click the external storage folder to view its contents. You should not see anything stored there yet.
Test out the external storage mount by adding a file to the folder. Click the + button in the top breadcrumbs area of the screen and select Upload file.
The local file browser appears. Select a test file to add to the external storage folder and click Open. The file appears in the folder.
NoteThe file you uploaded is also be available through the Linode Cloud Manager. You can verify this by following the steps in the View Bucket Objects section of How to Use Linode Object Storage guide. You should not use the Linode Cloud Manager to remove or add files from your Nextcloud external storage Object Storage bucket.
You may wish to consult the following resources for additional information on this topic. While these are provided in the hope that they will be useful, please note that we cannot vouch for the accuracy or timeliness of externally hosted materials.
Join our Community
This guide is published under a CC BY-ND 4.0 license.