S3 Storage

br\u016bhi Cloud can store and serve audio files from any S3-compatible object storage service. This allows you to maintain a large media library without worrying about the disk space on your server.

Supported Services

Service	S3-compatible	Notes
AWS S3	Yes (native)	Standard endpoint s3.amazonaws.com
Cloudflare R2	Yes	No egress fees; endpoint: https://{accountid}.r2.cloudflarestorage.com
MinIO	Yes	Self-hosted; endpoint: your MinIO URL
Backblaze B2	Yes	S3-compatible API; endpoint: https://s3.{region}.backblazeb2.com

Configuration

Set these environment variables before starting the Docker container:

S3_ENDPOINT_URL=https://your-endpoint.example.com
S3_ACCESS_KEY=your-access-key-id
S3_SECRET_KEY=your-secret-access-key
S3_BUCKET=bruhi-media
S3_REGION=us-east-1

For Cloudflare R2, the region is always auto:

S3_ENDPOINT_URL=https://ACCOUNT_ID.r2.cloudflarestorage.com
S3_REGION=auto

For MinIO (self-hosted):

S3_ENDPOINT_URL=http://minio.internal:9000
S3_REGION=us-east-1

MinIO ignores the region value but requires it to be present.

Browsing S3 Media

Once configured, the S3 Media Browser appears in the Content Library tab of the dashboard. You can:

• Navigate your bucket by folder prefix
• Filter by filename
• Preview file metadata (size, last modified, content type)
• Load files directly into the deck queue or soundboard pads

Presigned URLs

br\u016bhi Cloud generates presigned URLs when serving S3 files to the browser. This means:

• Files are served directly from S3 to the browser — the br\u016bhi server is not a proxy.
• Presigned URLs expire after 1 hour. The dashboard refreshes them automatically before expiry.
• Your S3 bucket does not need to be public.

Note

If you use a custom domain for your S3 bucket (e.g., via Cloudflare), make sure the CORS policy on your bucket allows the br\u016bhi dashboard origin:

[
  {
    "AllowedOrigins": ["https://bruhi.yourdomain.com"],
    "AllowedMethods": ["GET", "HEAD"],
    "AllowedHeaders": ["*"]
  }
]

Using S3 Files in Playlists

When you add an S3 file to a playlist or queue, br\u016bhi stores the S3 key (object path) rather than a presigned URL. A fresh presigned URL is generated at playback time.

You can mix local files (uploaded to the Docker volume) and S3 files in the same playlist with no special configuration.

Uploading Recordings to S3

After a recording session, you can upload the WAV file to S3:

POST /api/stations/{id}/recordings/{filename}/upload-to-s3

The file is uploaded to the configured bucket under a recordings/ prefix:

bruhi-media/recordings/station-1/bruhi-recording-2026-05-08-14-32-07.wav

S3 Not Configured

If S3 environment variables are not set, the S3 Media Browser does not appear in the dashboard. All media is served from the local Docker volume only. This is fine for small deployments or when using a network-attached storage volume.