Storage Configuration

Oopsie stores file attachments using Flysystem, supporting both local filesystem and S3-compatible storage.

Local storage (default)

Files are stored on the server filesystem. In Docker, use a named volume for persistence.

STORAGE_ADAPTER=local
STORAGE_LOCAL_PATH=/data/attachments

S3-compatible storage

Works with AWS S3, DigitalOcean Spaces, Scaleway Object Storage, MinIO, etc.

STORAGE_ADAPTER=s3
STORAGE_S3_BUCKET=oopsie-attachments
STORAGE_S3_REGION=eu-west-1
STORAGE_S3_KEY=your-access-key
STORAGE_S3_SECRET=your-secret-key
STORAGE_S3_ENDPOINT=https://s3.example.com  # Optional, for S3-compatible services

Limits

• Maximum file size: 10 MB per attachment
• Allowed MIME types: images (PNG, JPEG, GIF, WebP, SVG), PDF, text, CSV, JSON, video (MP4, WebM)
• Multiple attachments per report

Data retention

Attachments are automatically deleted when their parent report is purged. Configure retention per project in the dashboard (default: 90 days).