> ## Documentation Index
> Fetch the complete documentation index at: https://docs.biom.science/llms.txt
> Use this file to discover all available pages before exploring further.

# Relay Drive

> Cloud storage with managed S3, Google Drive, and BYOB support.

# Relay Drive

Relay Drive is the file management system in Relay. It provides managed cloud storage backed by S3 + CloudFront CDN, with integrations for Google Drive and bring-your-own-bucket (BYOB) options.

## Storage providers

### Relay Drive (default)

Managed cloud storage with:

* **CloudFront CDN** — fast global content delivery
* **Multipart upload** — files up to 50 GB with pause/resume
* **Folder management** — create, rename, move, and delete folders
* **Duplicate detection** — auto-detects duplicate files by name + size
* **Metadata extraction** — automatic metadata parsing on upload
* **Quota enforcement** — storage quotas per user

### Google Drive

Connect your Google Drive account to:

* Browse and list your Google Drive files
* Download files directly into Relay
* Upload files back to Google Drive
* Create folders in Google Drive
* Rate-limited API access to respect Google's quotas

### Bring Your Own Bucket (BYOB)

Connect your own cloud storage:

| Provider                 | Support                                 |
| ------------------------ | --------------------------------------- |
| **AWS S3**               | Full support with access key/secret key |
| **Google Cloud Storage** | Full support                            |
| **Azure Blob Storage**   | Full support                            |

BYOB features:

* Server-side credential encryption (AES-256-GCM)
* Multi-source copy (local → your bucket, Relay Drive → your bucket, Google Drive → your bucket)
* Range request support for efficient downloads
* Public and private bucket support

### Local storage (IndexedDB)

For fully offline usage:

* Files stored in browser IndexedDB
* 500 MB browser storage limit
* On-demand upload when sharing is triggered
* No cloud upload required

## File browser

The file browser in the sidebar provides:

* **Hierarchical folder tree** with expand/collapse
* **Multi-select** for batch operations
* **Batch actions** — upload, process, export, analyze multiple files
* **Drag and drop** — drop files or folders to upload
* **Search with filters** — search by name, type, size, date
* **Natural sort** — files sort as 1, 2, 10 (not 1, 10, 2)
* **File type icons** and thumbnail previews

## AI file organization

Let the AI agent organize your files automatically:

1. Right-click a folder and select **Organize with AI**
2. Choose a strategy: auto, by-date, by-type, by-experiment, or flatten
3. The AI analyzes file naming patterns and proposes a folder structure
4. Preview the proposed changes
5. Apply to move files into the new structure

The AI creates up to 15 folders and never renames files — it only moves them.

## Upload engine

Relay's upload system features:

* **Configurable concurrency** — up to 4 parallel uploads by default
* **Exponential backoff retry** — 3 attempts with increasing delay
* **Duplicate detection** — file hashing to prevent re-uploads
* **Global pause/resume** — pause all uploads at once
* **Per-batch cancel** — cancel specific upload batches
* **Stale recovery** — on page reload, stale uploads reset to queued state