> For the complete documentation index, see [llms.txt](https://docs.telm.ai/telmai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.telm.ai/telmai/connect-to-data/data-connections/aws-s3.md).

# AWS S3

Connect Telmai to AWS S3.

Telmai reads files from an S3 bucket with an IAM user's access key or, on AWS deployments, an IAM role.

## Before you connect

Give the IAM user whose access key Telmai uses read access to the bucket. With **IAM Role**, give the same access to the role Telmai uses instead. Replace `your-bucket` with your bucket name:

```json
{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": ["s3:GetBucketLocation", "s3:ListBucket"],
      "Resource": "arn:aws:s3:::your-bucket"
    },
    {
      "Effect": "Allow",
      "Action": "s3:GetObject",
      "Resource": "arn:aws:s3:::your-bucket/*"
    }
  ]
}
```

See [Creating IAM policies](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_create.html).

## Connection fields

On the **Connections** page, click **Add connection** and choose **AWS S3**. See [Add a connection](https://docs.telm.ai/telmai/connect-to-data.md#add-a-connection) for the full flow.

| Field          | Description                                            |
| -------------- | ------------------------------------------------------ |
| **Region**     | The AWS region of the bucket, for example `us-east-1`. |
| **Bucket**     | The bucket name, for example `your-bucket`.            |
| **Access key** | The IAM user's access key ID.                          |
| **Secret key** | The IAM user's secret access key.                      |

On Telmai deployments in AWS, **Credentials** offers **Access key** or **IAM Role**. With **IAM Role**, Telmai uses the role attached to the deployment (shown next to **Using role:**, if set) and there are no keys to fill in.

## Asset fields

Click **Add assets** on the connection. See [Add assets](https://docs.telm.ai/telmai/connect-to-data.md#list-of-connectors-enabled-by-default).

| Field                                      | Description                                                                                                                                                               |
| ------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Path**                                   | The path of a file in the bucket, or of a folder whose files all have the same format, for example `sales/2026/orders.csv` or `sales/2026/`. Wildcards (`*`) are allowed. |
| **File type**                              | **Automatic**, or the file format.                                                                                                                                        |
| **Delimiter**                              | For CSV files, **Automatic** or **Comma**, **Semicolon**, **Tab**, **Space** or **Pipe**.                                                                                 |
| **Resolve wildcards (\*) to folder names** | Check it when a wildcard in **Path** should match folders, for example `sales/*/orders.csv`.                                                                              |

For paths, wildcards and file types, see [File Path Options](https://docs.telm.ai/telmai/connect-to-data/file-path-options.md) and [Supported File Types](https://docs.telm.ai/telmai/connect-to-data/supported-file-types.md).
