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.

  1. Create R2 Bucket

    • Log in to Cloudflare Dashboard
    • Navigate to R2
    • Click "Create Bucket"
    • Choose a name (e.g., "ragaas-docs")
  2. 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
  3. 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

  1. Access Denied

    • Verify API token has correct permissions
    • Check bucket name is exact match
    • Confirm endpoint URL is correct
  2. Invalid Credentials

    • Double-check Access Key ID and Secret
    • Ensure credentials are active
    • Verify token permissions