Configuring Nextcloud to use Linode Object Storage as an External Storage Mount

Updated by Linode Contributed by Linode

Contribute on GitHub

Report an Issue | View File | Edit File

Marquee image for How to Configure Nextcloud to use Linode Object Storage as an External Storage Mount

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

  1. Deploy a Nextcloud server instance. You can use the Linode Nextcloud One-Click App for an easy and quick deployment.

  2. Enable the Object Storage service on your Linode account.

  3. Generate Object Storage access keys.

  4. If you are not familiar with Linode Object Storage, review the How to Use Linode Object Storage guide.

In This Guide

Nextcloud Configurations

Enable the External Storage App

In this section you enable the External Storage Support Nextcloud app in order to use external storage sources.

You must belong to the admin user group in order to install the External storage support app.
  1. Log into your Nextcloud instance.

  2. Click the user icon (or cog wheel) in the top navigation menu and select Apps.

    Access Nextcloud App settings.

  3. Click Files to access all Nextcloud apps related to file management, in the left-hand navigation menu.

    Access the Files App settings.

  4. Use the search field in the top navigation to narrow down the visible apps. You can enter external as your search term.

  5. Viewing the External storage support app, click the Enable button in order to install it to the Nextcloud instance.

    Enable the external storage support app.

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.

If you have not yet enabled Object Storage on your Linode account and created Object Storage access keys, you should do so now before proceeding with this section.
  1. Click the user icon (or cog wheel) in the top navigation menu and select Settings.

    Access Nextcloud settings.

  2. In the left-hand navigation menu, under the Administration heading, click External Storages. The External Storages administration page appears.

    Access external storage configurations.

  3. In the Folder name text entry box, provide a name for the external storage directory.

  4. From the External Storage dropdown menu, select the Amazon S3 option.

    Linode 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.
  5. Select Access Key from the Authentication dropdown menu.

  6. 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 443.
    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
    Frankfurt, Germany eu-central-1
    Singapore, Singapore ap-south-1
  7. 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.

  8. 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.

    Save your external storage configurations.

  9. Using the top navigation menu, click the Files menu item. The external storage folder appears in the list of folders.

    Access all your Nextcloud files.

  10. Click the external storage folder to view its contents. You should not see anything stored there yet.

  11. 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.

    Upload a file to your Linode Object Storage bucket.

  12. 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.

    Your should see your uploaded file appear in the folder.

    The 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.

More Information

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

Find answers, ask questions, and help others.

comments powered by Disqus

This guide is published under a CC BY-ND 4.0 license.