Storage

By default Openinary stores files on local disk. Set the STORAGE_* variables to switch to any S3-compatible provider.

The bundled Docker Compose file does not pass these variables through. Its service definitions list no STORAGE_* entries and declare no env_file, so putting them in the root .env has no effect: the container starts without them and silently falls back to local disk.For a Compose deployment, add them to the service’s environment: block yourself:

services:
  openinary:
    environment:
      - STORAGE_REGION=${STORAGE_REGION}
      - STORAGE_ACCESS_KEY_ID=${STORAGE_ACCESS_KEY_ID}
      - STORAGE_SECRET_ACCESS_KEY=${STORAGE_SECRET_ACCESS_KEY}
      - STORAGE_BUCKET_NAME=${STORAGE_BUCKET_NAME}
      - STORAGE_PUBLIC_URL=${STORAGE_PUBLIC_URL}

On a platform that injects environment variables directly (Railway, Coolify, Dokploy), set them there and nothing else is needed. Running from source, they are read from apps/api/.env.

There is no fallback to S3_-prefixed names. Only the exact STORAGE_* names below are read.

Parameters

Parameter	Description
`STORAGE_REGION`	S3 region
`STORAGE_ACCESS_KEY_ID`	Access key ID
`STORAGE_SECRET_ACCESS_KEY`	Secret access key
`STORAGE_BUCKET_NAME`	Bucket name
`STORAGE_ENDPOINT`	Custom endpoint (non-AWS providers)
`STORAGE_PUBLIC_URL`	Public URL or CDN domain
`STORAGE_MAX_SOCKETS`	Max concurrent HTTP connections
`STORAGE_CONNECTION_TIMEOUT`	Connection timeout (ms)
`STORAGE_REQUEST_TIMEOUT`	Request timeout (ms)
`STORAGE_SOCKET_TIMEOUT`	Socket timeout (ms)

Quick-start configs

AWS S3
Cloudflare R2
MinIO (self-hosted)
Other S3-compatible
Production (with timeouts)

STORAGE_REGION=us-east-1
STORAGE_ACCESS_KEY_ID=AKIAIOSFODNN7EXAMPLE
STORAGE_SECRET_ACCESS_KEY=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
STORAGE_BUCKET_NAME=my-openinary-bucket
STORAGE_PUBLIC_URL=https://my-openinary-bucket.s3.us-east-1.amazonaws.com

No STORAGE_ENDPOINT needed for AWS S3.

STORAGE_REGION=auto
STORAGE_ACCESS_KEY_ID=your_r2_access_key
STORAGE_SECRET_ACCESS_KEY=your_r2_secret_key
STORAGE_BUCKET_NAME=my-r2-bucket
STORAGE_ENDPOINT=https://your-account-id.r2.cloudflarestorage.com
STORAGE_PUBLIC_URL=https://cdn.example.com

STORAGE_REGION=us-east-1
STORAGE_ACCESS_KEY_ID=minioadmin
STORAGE_SECRET_ACCESS_KEY=minioadmin
STORAGE_BUCKET_NAME=openinary
STORAGE_ENDPOINT=http://minio.example.com:9000
STORAGE_PUBLIC_URL=http://minio.example.com:9000

Works with DigitalOcean Spaces, Wasabi, Backblaze B2, and any S3-compatible service:

STORAGE_REGION=us-east-1
STORAGE_ACCESS_KEY_ID=your_access_key
STORAGE_SECRET_ACCESS_KEY=your_secret_key
STORAGE_BUCKET_NAME=your-bucket-name
STORAGE_ENDPOINT=https://your-s3-compatible-endpoint.com
STORAGE_PUBLIC_URL=https://your-cdn-domain.com

STORAGE_REGION=us-east-1
STORAGE_ACCESS_KEY_ID=your_access_key
STORAGE_SECRET_ACCESS_KEY=your_secret_key
STORAGE_BUCKET_NAME=my-bucket
STORAGE_MAX_SOCKETS=100
STORAGE_CONNECTION_TIMEOUT=5000
STORAGE_REQUEST_TIMEOUT=30000
STORAGE_SOCKET_TIMEOUT=60000

The provider is detected automatically: set STORAGE_ENDPOINT for any non-AWS provider. Leave it unset for standard AWS S3.

Parameter reference

string

default:"auto"

S3 region identifier. Defaults to auto, which is what Cloudflare R2 expects, so AWS and other region-bound providers need this set explicitly.us-east-1 · eu-west-1 · auto (Cloudflare R2)

string

required

Access key ID for your storage provider.

Never commit credentials to version control.

string

required

Secret access key for your storage provider.

Never expose in logs or client-side code.

string

required

Name of the bucket where files are stored.

string

Custom endpoint for non-AWS S3-compatible providers. Omit for standard AWS S3.

Provider	Endpoint format
Cloudflare R2	`https://<account-id>.r2.cloudflarestorage.com`
MinIO	`http://minio.example.com:9000`
DigitalOcean Spaces	`https://nyc3.digitaloceanspaces.com`
Wasabi	`https://s3.wasabisys.com`

string

Public base URL used to construct file URLs. Set this to your CDN or custom domain when you don’t want to expose raw S3 URLs.https://cdn.example.com · https://my-bucket.s3.us-east-1.amazonaws.com

Advanced parameters

integer

default:"50"

Max simultaneous HTTP connections to the storage provider. Increase if you see connection pool exhaustion under load.50 (default) · 100 (high traffic) · 25 (low resource)

integer

default:"0"

Connection timeout in ms. 0 = no timeout.0 · 5000 (5 s) · 10000 (10 s)

integer

default:"0"

Request timeout in ms. 0 = no timeout. For large uploads, use 300000 (5 min) or higher.0 · 30000 (30 s) · 300000 (5 min)

integer

default:"0"

TCP socket timeout in ms. 0 = no timeout.0 · 60000 (1 min) · 120000 (2 min)

Quick Start

Run Openinary with local or S3 storage.

Upload & Cache Warming

Upload files and prewarm transformation cache.

Getting Started

Configuration

Media Transformations

Resources

Parameters

Quick-start configs

Parameter reference

Advanced parameters

Quick Start

Upload & Cache Warming

​Parameters

​Quick-start configs

​Parameter reference

​Advanced parameters

​Related

Quick Start

Upload & Cache Warming

Parameters

Quick-start configs

Parameter reference

Advanced parameters

Related