Skip to main content

Storage Providers

tagd-ai supports multiple storage providers for your file attachments. Configure external storage for more control and flexibility.

Default Storage​

By default, files are stored on tagd-ai's infrastructure:

  • Automatic optimization
  • CDN distribution
  • No configuration needed
  • Included in storage limits

Supported Providers​

Cloudflare R2​

Object storage with no egress fees.

Benefits:

  • No egress charges
  • S3-compatible API
  • Global distribution

Setup:

  1. Create R2 bucket in Cloudflare dashboard
  2. Generate API credentials
  3. In tagd-ai: Settings → Storage → Add Provider
  4. Enter credentials:
    • Account ID
    • Access Key ID
    • Secret Access Key
    • Bucket name

AWS S3​

Industry-standard object storage.

Benefits:

  • Proven reliability
  • Extensive features
  • IAM integration

Setup:

  1. Create S3 bucket in AWS
  2. Create IAM user with S3 access
  3. In tagd-ai: Settings → Storage → Add Provider
  4. Enter credentials:
    • Access Key ID
    • Secret Access Key
    • Bucket name
    • Region

IAM Policy:

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

Backblaze B2​

Cost-effective object storage.

Benefits:

  • Low cost
  • Simple pricing
  • S3-compatible

Setup:

  1. Create B2 bucket
  2. Generate application key
  3. In tagd-ai: Settings → Storage → Add Provider
  4. Enter:
    • Application Key ID
    • Application Key
    • Bucket name
    • Endpoint URL

Configuring Providers​

Add New Provider​

  1. Go to Settings → Storage
  2. Click Add Provider
  3. Select provider type
  4. Enter credentials
  5. Test connection
  6. Save

Set Default Provider​

Choose where new uploads go:

  1. Go to Settings → Storage
  2. Find provider
  3. Click Set as Default

Provider Priority​

Configure fallback order:

  1. Primary provider for new uploads
  2. Fallback if primary fails
  3. Keep original in tagd-ai storage as backup

Migrating Files​

To External Provider​

Move existing files to external storage:

  1. Go to Settings → Storage
  2. Click Migrate Files
  3. Select source (tagd-ai storage)
  4. Select destination provider
  5. Choose tags/files to migrate
  6. Start migration

From External Provider​

Return files to tagd-ai:

  1. Go to Settings → Storage
  2. Click Migrate Files
  3. Select external source
  4. Choose destination
  5. Start migration

Costs and Billing​

What tagd-ai Charges​

  • Storage management features
  • Not the actual storage space

What Providers Charge​

  • Storage space used
  • Data transfer (varies by provider)
  • API requests
  • Check provider pricing

Cost Comparison​

ProviderStorageEgress
tagd-aiIncluded in planIncluded
Cloudflare R2$0.015/GBFree
AWS S3$0.023/GB$0.09/GB
Backblaze B2$0.006/GB$0.01/GB

Best Practices​

Security​

  • Use least-privilege credentials
  • Rotate keys regularly
  • Enable bucket encryption
  • Restrict bucket access

Performance​

  • Choose provider near your users
  • Enable CDN when available
  • Configure appropriate caching

Reliability​

  • Enable versioning
  • Configure backups
  • Test regularly

Troubleshooting​

Connection Failed​

  • Verify credentials are correct
  • Check bucket exists
  • Verify permissions
  • Check network/firewall

Upload Errors​

  • Check storage quota
  • Verify file size limits
  • Check bucket policy

Files Not Loading​

  • Verify bucket is public or signed URLs work
  • Check CORS configuration
  • Verify CDN configuration

Next Steps​