# Rclone mount add-on

[Rclone](https://rclone.org) is a command-line utility for managing and syncing files and directories between various cloud storage providers, as well as local filesystems. It supports a wide range of cloud storage services such as Google Drive, Dropbox, Amazon S3, Microsoft OneDrive, and many others.

### Prerequisites

Before adding a Rclone mount add-on to your application, a Rclone remote must be configured.

You can configure a Rclone remote either via the command line in a terminal inside a Nuvolos application, or using the Rclone GUI Nuvolos application.

{% hint style="info" %}
Rclone stores configuration files in the Personal area of your Nuvolos instance, so the configured remote will be only visible to your user. If other users wish to use the same Nuvolos application with a Rclone mount add-on configured, they will also need to configure a Rclone remote.
{% endhint %}

#### Use existing configuration file

If you have already configured Rclone on another machine, you can migrate your existing configuration file to Nuvolos:

1. Upload the configuration file to Nuvolos
2. Copy it to `~/.config/rclone/rclone.conf` in your instance

The Nuvolos addon uses Rclone v1.62.2, make sure to only use remotes compatible with this version.

#### Command line configuration on Nuvolos

To configure a remote via the command line on Nuvolos, we recommend using a terminal in a JupyterLab application. You can install the Rclone utility with the following command:

`mamba install -y -c conda-forge rclone`

Once Rclone is installed in your application, you can configure a remote with the `rclone configure` command. Please refer to the [Rclone documentation](https://rclone.org/overview/) on how to configure the remote service of your choice.

#### Configuration using the Rclone GUI Nuvolos application

To begin, add a Rclone GUI Nuvolos application to your working instance. You can find this application under the Data Operations category.

Start the application and click the Login button to navigate to the Rclone dashboard. Note that no username or password is required.

Click on *Configs* and *Create a New Config*. Give a name to your remote configuration and select the cloud storage provider of your choice, then proceed with the configuration options displayed.

{% hint style="info" %}
The Rclone GUI does not support all configuration options available in the `rclone` command line utility.
{% endhint %}

### Using the configuration

Once your Rclone remote has been configured, navigate to your application's settings to add the Rclone mount add-on.

After adding the add-on, start or restart your application. If the remote was successfully configured, you will be able to access the files stored in your cloud storage account under the /rclone path in your Nuvolos application.

{% hint style="info" %}
If there are multiple remotes defined in the Rclone configuration file, only the first remote will be mounted under the `/rclone` path.
{% endhint %}

### Configuration walkthroughs

We have examples for some of the most common remote types:

* [AWS S3](/features/file-system-and-storage/access-s3-buckets-with-rclone.md)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.nuvolos.com/features/applications/add-ons/rclone-mount-add-on.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.