logoChakra
Storage

Configuration

Learn how to configure storage in Astra.

Currently, Astra supports all S3-compatible storage providers, including AWS S3, DigitalOcean Spaces, Cloudflare R2, and Supabase Storage.

For a concrete example using Supabase Storage as an S3-compatible provider, see the Supabase recipe.

The setup process is straightforward - you just need to configure a few environment variables in both your local environment and hosting provider:

S3_IMAGES_BUCKET=
S3_AGENTS_BUCKET=
S3_REGION=
S3_ENDPOINT=
S3_ACCESS_KEY_ID=
S3_SECRET_ACCESS_KEY=

Let's break down each required variable:

  • S3_IMAGES_BUCKET: The default name of your profiles storage bucket - you can pass different for each request
  • S3_AGENTS_BUCKET: The default name of your agents storage bucket - you can pass different for each request
  • S3_REGION: The AWS region where your storage is located - defaults to us-east-1
  • S3_ENDPOINT: The S3 endpoint URL for your storage provider - defaults to https://s3.amazonaws.com
  • S3_ACCESS_KEY_ID: Your storage provider's access key ID
  • S3_SECRET_ACCESS_KEY: Your storage provider's secret access key

You can learn more about S3 service configuration in the official AWS documentation or your specific storage provider's documentation.

Last updated on