File Storage
Configure where RAGaaS stores your processed documents and content.
Overview
RAGaaS needs a place to store your processed documents and content. We support any S3-compatible storage service, with Cloudflare R2 being our recommended choice due to its simplicity and free egress.
File storage is configured at the namespace level, so you can use different storage configurations for different namespaces.
Setup with Cloudflare R2 (Recommended)
-
Create R2 Bucket
- Log in to Cloudflare Dashboard
- Navigate to R2
- Click "Create Bucket"
- Choose a name (e.g., "ragaas-docs")
-
Get API Credentials
- Go to R2 > API > Manage API Tokens
- Click "Create API Token"
- Select "Object Read & Write" permissions
- Click "Create API Token"
- Note down the endpoint URL, Access Key ID, and Secret Access Key
-
Configure Namespace
{
"fileStorageConfig": {
"provider": "S3_COMPATIBLE",
"bucket": "ragaas-docs",
"endpoint": "your-endpoint-url",
"credentials": {
"accessKeyId": "your-access-key-id",
"secretAccessKey": "your-secret-access-key"
},
"region": "auto"
}
}
Using Other S3-Compatible Storage
While we recommend R2, any S3-compatible storage will work. Just update the configuration with your provider's:
- Endpoint URL
- Region
- Credentials
- Bucket name
Common Issues
-
Access Denied
- Verify API token has correct permissions
- Check bucket name is exact match
- Confirm endpoint URL is correct
-
Invalid Credentials
- Double-check Access Key ID and Secret
- Ensure credentials are active
- Verify token permissions