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

# Amazon S3 Migration

> Connect your Amazon S3 bucket to easily import existing media assets into Dreep.

Dreep supports direct integration with your Amazon S3 buckets. By providing read-only credentials, you can seamlessly browse and import your legacy S3 objects directly into your Dreep folders without needing to manually download and re-upload them.

## Required Credentials

To connect your S3 bucket, you will need the following information:

* **Region:** The AWS region where your bucket is hosted (e.g., `us-east-1`, `eu-central-1`).
* **Bucket Name:** The exact name of your bucket.
* **Access Key ID:** An IAM Access Key with permissions to read from the bucket.
* **Secret Access Key:** The corresponding Secret Key.

<Card title="Security Best Practice" icon="shield-check" color="#10B981">
  We strongly recommend creating a dedicated IAM User specifically for Dreep with **read-only access** restricted only to the specific bucket you wish to import from.

  **Never use your AWS Root Account credentials.**
</Card>

## Connecting the Integration

Once you have gathered your credentials:

1. Open your Dreep project and navigate to the **Integrations** page.
2. Click **Connect** on the Amazon S3 card.
3. Enter your Access Key ID, Secret Access Key, Region, and Bucket Name into the connection modal.
4. Dreep securely encrypts these credentials (using AES-256-GCM) before storing them, and verifies the connection.

## Importing Assets

After successfully connecting, click **Import Assets** on the S3 card.

You can browse the objects in your bucket, select multiple files, choose a destination folder in Dreep, and start the import. Dreep runs the transfer entirely in the background, so you can safely close the window while it progresses!