Skip to main content

Parameters

ParameterDescription
VIDEO_MAX_CONCURRENTMax simultaneous video jobs
VIDEO_JOB_RETRY_MAXMax retry attempts per job
VIDEO_JOB_CLEANUP_HOURSHours before completed jobs are purged
VIDEO_WORKER_POLL_INTERVAL_MSWorker polling interval

Parameter reference

VIDEO_MAX_CONCURRENT
integer
Maximum number of video jobs processed at the same time.When unset, auto-detected from available RAM (1 worker per 2 GB, max 16).
RAMAuto-detected workers
4 GB2
8 GB4
16 GB8
Each worker spawns an FFmpeg process. Setting this too high will exhaust CPU and memory.
VIDEO_JOB_RETRY_MAX
integer
default:"3"
Maximum retry attempts for a failed job before it is marked as permanently failed.3 (default) · 5 (unreliable network) · 1 (fail fast)
VIDEO_JOB_CLEANUP_HOURS
integer
default:"24"
Hours after which completed and failed jobs are deleted from the database.24 (default) · 168 (1 week, for debugging) · 1 (aggressive)
VIDEO_WORKER_POLL_INTERVAL_MS
integer
default:"1000"
How often the worker checks for new jobs, in milliseconds. Lower = faster pickup, higher CPU. Higher = slower pickup, lower CPU.1000 (default) · 500 (faster) · 2000 (lower resource use)

Configuration examples

VIDEO_MAX_CONCURRENT=2
VIDEO_JOB_RETRY_MAX=3
VIDEO_JOB_CLEANUP_HOURS=1
VIDEO_WORKER_POLL_INTERVAL_MS=1000

Video Transformations

URL parameters for resizing, trimming, and encoding videos.

Upload & Cache Warming

Pre-generate video variants at upload time.