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.

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

    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.
    RegionRegion IDHostname
    Newark, NJ,
    RegionRegion IDHostname
    Newark, NJ,
    Frankfurt, …
There is a known bug when configuring Frankfurt buckets that will cause failure unless the 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.
  1. 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.

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

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

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

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

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

This page was originally published on

Create a Linode account to try this guide with a $100 credit.
This credit will be applied to any valid services used during your first 60 days.

Your Feedback Is Important

Let us know if this guide made it easy to get the answer you needed.

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.