Aller au contenu principal

Storage Setup

File storage configuration for production

Overview​

Synap uses object storage (S3-compatible) for file content, keeping metadata in PostgreSQL.

Providers​

Advantages:

  • Zero egress fees
  • S3-compatible API
  • Cost-effective
  • Global CDN

Setup:

  1. Create R2 bucket in Cloudflare dashboard
  2. Generate API tokens
  3. Configure in .env:
STORAGE_PROVIDER=r2
R2_ACCOUNT_ID=your_account_id
R2_ACCESS_KEY_ID=your_access_key
R2_SECRET_ACCESS_KEY=your_secret_key
R2_BUCKET_NAME=synap-storage
R2_PUBLIC_URL=https://pub-xxx.r2.dev

AWS S3​

STORAGE_PROVIDER=s3
AWS_ACCESS_KEY_ID=your_key
AWS_SECRET_ACCESS_KEY=your_secret
AWS_REGION=us-east-1
AWS_BUCKET_NAME=synap-storage

MinIO (Self-Hosted)​

STORAGE_PROVIDER=minio
MINIO_ENDPOINT=http://localhost:9000
MINIO_ACCESS_KEY=minioadmin
MINIO_SECRET_KEY=minioadmin
MINIO_BUCKET=synap-storage

Bucket Configuration​

CORS Setup​

[
  {
    "AllowedOrigins": ["https://yourdomain.com"],
    "AllowedMethods": ["GET", "PUT", "POST", "DELETE"],
    "AllowedHeaders": ["*"],
    "ExposeHeaders": ["ETag"]
  }
]

Lifecycle Policies​

Configure lifecycle policies for:

  • Old file cleanup
  • Cost optimization
  • Compliance requirements

Security​

Access Control​

  • Use IAM roles (AWS) or API tokens (R2)
  • Never expose credentials in code
  • Use presigned URLs for temporary access
  • Enable bucket versioning (optional)

Monitoring​

Key Metrics​

  • Storage usage
  • Request rates
  • Error rates
  • Cost tracking

Next: See Production Deployment for complete setup.