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

Traducciones al Español
Estamos traduciendo nuestros guías y tutoriales al Español. Es posible que usted esté viendo una traducción generada automáticamente. Estamos trabajando con traductores profesionales para verificar las traducciones de nuestro sitio web. Este proyecto es un trabajo en curso.
Create a Linode account to try this guide with a $ credit.
This credit will be applied to any valid services used during your first  days.

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 Marketplace App for an easy and quick deployment.

  2. [Generate Object Storage access keys](/docs/products/storage/object-storage/guides/access-keys/.

  3. If you are not familiar with Linode Object Storage, review the Get Started with Object Storage guide or take a look through the available Object Storage guides.

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.

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

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

  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.

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.

Note
If you have not yet created an Object Storage access key, 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.

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

  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.

    Note
    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:

    ConfigurationDescription
    BucketThe name to assign to the Object Storage bucket. If this bucket name already exists in the data center region you select, an error occurs.
    HostnameThe 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.
    PortThe port number to use to access the Object Storage host. This value must be 443.
    RegionThe 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 SSLA configuration to enable secure sockets layer (SSL). This configuration must be enabled.
    Enable Path StyleThis configuration changes the default path format used by Nextcloud to access the Object Storage bucket. Do not enable this configuration.
    Legacy (v2) AuthenticationThis 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 KeyThe value of the Access Key you created using the Linode Cloud Manager.
    Secret KeyThe value of the Secret Key you created using the Linode Cloud Manager.
    Note
    To view Object Storage region IDs and hostname values, review the Access Buckets and Files through URLs guide.
    Note
    There is a known bug when configuring Frankfurt buckets that will cause failure unless the user enters us-east-1 as the Region ID, despite the correct ID being eu-central-1. The correct bucket will still be configured using the hostname. If you are hosting a bucket in Frankfurt and the Nextcloud configuration is not applying, this solution should be attempted.
  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.

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

  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.

  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.

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

This page was originally published on


Your Feedback Is Important

Let us know if this guide was helpful to you.


Join the conversation.
Read other comments or post your own below. Comments must be respectful, constructive, and relevant to the topic of the guide. Do not post external links or advertisements. Before posting, consider if your comment would be better addressed by contacting our Support team or asking on our Community Site.
The Disqus commenting system for Linode Docs requires the acceptance of Functional Cookies, which allow us to analyze site usage so we can measure and improve performance. To view and create comments for this article, please update your Cookie Preferences on this website and refresh this web page. Please note: You must have JavaScript enabled in your browser.