Accessing external storage

nextcloudUsing the external storage support app, you can access FTP, S3 or Swift object stores. This article describes using Wasabi, the S3 compatible storage service, but the process will be similar for other types of storage.

Wasabi bucket

Create a bucket on Wasabi, and note the bucket name and user details.


External storage support app

Log on to your Nextcloud instance with an admin account.

  1. Go to your Avatar > Apps.
    1. Search for External storage support.
    2. Click the Download and enable button.
  2. Go to your Avatar > Settings.
  3. In the left pane, select Administration > External storages.
  4. Enter the following details: 
    1. Folder name: Wasabi storage
    2. Type: Amazon S3
    3. Bucket: wasabi-bucket-name
    4. Hostname:
    5. Port: 443
    6. Region: eu-central-1
    7. Enable SSL: enable
    8. Access key: ABCDEFGHIJ1234567890
    9. Secret key: ABCDEFGHIJ1234567890klmnopqrst1234567890
  5. Click the tick to save your settings.

This will create full access to your Wasabi bucket for all users.



Often you will want to assign specific permissions for different users and groups.

  1. Go to your Avatar > Settings.
  2. In the left pane, select External storages.
  3. Click 3dotsHorizontal next to your newly configured storage.
  4. Select any of the following options:
    1. Enable previews
    2. Enable sharing
    3. Read-only
  5. Add users and/or groups to the Available for field.

Using this method you can create multiple storage settings for the same Wasabi bucket. For example you could make it read-only for a group of users, and give full access to an admin. Note that where there is a conflict of permissions, the least privilege will prevail.


Users mounting their own storage

If you enable the Allow users to mount external storage option, you can also specify which type of external storage users can mount (e.g. S3 and Nextcloud instances). Users will then be able to go to their Avatar > Settings and click External storages in their Personal section on the left pane, to mount their own storage.

Note that mounting an external Nextcloud instance is much slower than accessing it directly.


Global credentials

Global credentials can be used when you are accessing multiple external storages that use the same credentials. Note that it is best practice to use different credentials for different services.


Thanks for visiting.