# rclone

> Available S3 endpoint: `a-s3.aur.lu` (France, Albi).

Configure an rclone remote for Aurora's S3-compatible storage.

- rclone: [Homepage](https://rclone.org/) · [Docs](https://rclone.org/docs/)

## Installation

If you don't have rclone installed, follow the [official installation guide](https://rclone.org/install/).

## Configuration

Your selected endpoint is: **a-s3.aur.lu**

Create a remote in `~/.config/rclone/rclone.conf`:

```ini
[aurora]
type = s3
provider = Other
env_auth = false
access_key_id = <YOUR_ACCESS_KEY>
secret_access_key = <YOUR_SECRET_KEY>
endpoint = https://a-s3.aur.lu
region = us-east-1
```

Alternatively, configure interactively:

```bash
rclone config
# Choose: n (New remote)
# Name: aurora
# Storage: s3
# Provider: Other
# env_auth: false
# access_key_id: <YOUR_ACCESS_KEY>
# secret_access_key: <YOUR_SECRET_KEY>
# endpoint: https://a-s3.aur.lu
# region: us-east-1
# (Accept defaults for remaining options)
```

## Usage

### List buckets

```bash
rclone lsd aurora:
```

### List files in a bucket

```bash
rclone ls aurora:my-bucket
```

### Copy files to Aurora

```bash
rclone copy ./local-folder aurora:my-bucket --progress --s3-no-check-bucket
```

### Copy files from Aurora

```bash
rclone copy aurora:my-bucket ./local-folder --progress --s3-no-check-bucket
```

### Sync folders

```bash
rclone sync ./local-folder aurora:my-bucket --progress --s3-no-check-bucket
```
