Remote Storage

Overview

Remote storage is a feature that allows you to store your data in a remote location. This can be useful if you want to access your data from multiple devices or if you want to store backups elsewhere.

It currently support:

1Fichier, Akamai Netstorage, Amazon S3, Backblaze B2, Box, Citrix ShareFile, Dropbox, Enterprise File, Files.com, FTP, Gofile, Google Cloud, Google Drive, Google Photos, HDFS, HiDrive, HTTP, Internet Archive, Jottacloud, Koofr, Linkbox, Mail.ru, Mega, Memory, Microsoft Azure, Microsoft Azure, Microsoft OneDrive, OpenDrive, OpenStack Swift, Oracle Object, pCloud, PikPak, Pixeldrain, premiumize.me, put.io, Proton Drive, QingStor, Quatrix by, Seafile, SFTP, Sia, SMB, SugarSync, Storj, Uloz.to, Uptobox, WebDAV, Yandex Disk, Zoho WorkDrive

It also supports exporting storage as a "share" to other client via NFS, (S)FTP, WebDAV, SFTP. SMB support is planned.

Setup

Go to Storage > Remote Storage > New

You will see

Remote Storage Setup

Follow the steps in the modal, first select a remote storage provider. Then fill in the required fields. You can customize the options, but the default options are good for most users. "Name" is usually the important bit, find a simple name, avoid spaces, special characters, and uppercase.

One important point is the token field, for some provider you will require a token. In order to get the token, follow those steps:

  • Install RClone on your local machine at this link: https://rclone.org/install/
  • Run rclone authorize dropxbox (replace dropbox with the provider you want to use)
  • Follow the instructions on the screen
  • Copy the token and paste it in the token field
  • Enjoy!

Those steps are required because those providers require the use of a browser to authenticate, and it is not possible to do it in a remote web interface without creating a new client for each server (which would be a lot more annoying for you).

The way Cosmos works is by using RClone to mount the remote storage on the server, and then use it as a normal disk. You can either let Cosmos use your disks via the Rclone API (for example when using network share, that's what happens) or you can see the mounted storage in /mnt/cosmos-{storage-name}.