Requirements

Required

• Runtime: Bun (recommended) or Node.js
• Database: PostgreSQL
• FFmpeg: required for media previews and HLS processing

Recommended

• S3-compatible storage for large libraries
• Redis only if you introduce custom workers or queues
• Reverse proxy (Caddy/Nginx) for TLS in production

Capacity planning

• Disk: enough space for uploads + preview/HLS assets
• CPU: FFmpeg uses CPU for transcoding
• RAM: plan for concurrent uploads and previews

Install dependencies

bun install

If you use Docker, runtime dependencies are handled in the containers.