Closed Alpha
FluxPlay is currently in Closed Alpha. This documentation is a work in progress and may be incomplete or out of date. Features, UI, and APIs are subject to change without notice. For access inquiries, please contact [email protected].
SYSTEM REQUIREMENTS
Hardware and software requirements for running FluxPlay. Choose your setup based on library size and streaming needs.
Server Requirements
Software Dependencies
PostgreSQL
RequiredPrimary data store for all metadata, users, and configuration
FFmpeg
RequiredRequired for playback, transcoding, and media analysis
Redis
OptionalOptional but recommended for better performance
yt-dlp
OptionalRequired only if using download features
Meilisearch
OptionalOptional. Enhances search for large libraries
Docker
OptionalRecommended installation method
Hardware Transcoding Requirements
Hardware transcoding dramatically reduces CPU load and enables more simultaneous streams. Choose based on your GPU.
| Technology | Vendor | Minimum GPU | Recommended | Features |
|---|---|---|---|---|
| NVENC | NVIDIA | GTX 600 series | GTX 1650+ / RTX series | HDR tone mapping, 4K HEVC, AV1 (RTX 40+) |
| Quick Sync (QSV) | Intel | 6th gen Core (Skylake) | 10th gen+ / Arc GPUs | Excellent efficiency, HDR (11th gen+) |
| AMF/VCN | AMD | RX 400 series | RX 6000+ series | Good Linux support, HEVC |
| VAAPI | Linux (Intel/AMD) | Any supported iGPU/dGPU | Recent Intel/AMD | Universal Linux solution |
NVIDIA Driver Requirements
- • Windows: 471.41+ (GeForce) or 472.50+ (Quadro)
- • Linux: 470.57+ with CUDA support
- • Docker: nvidia-container-toolkit installed
Intel Driver Requirements
- • Windows: Latest Intel Graphics Driver
- • Linux: intel-media-va-driver or intel-media-driver
- • Docker: Pass /dev/dri to container
Transcoding Capacity Guide
| Hardware | 1080p Streams | 4K Streams | Notes |
|---|---|---|---|
| CPU Only (4 cores) | 1-2 | 0-1 | Not recommended for regular transcoding |
| Intel i5 + iGPU (QSV) | 3-5 | 1-2 | Great budget option |
| Intel i7 + iGPU (QSV) | 5-8 | 2-3 | Good for families |
| GTX 1650 (NVENC) | 3-4 | 1-2 | Consumer card limits apply |
| RTX 3060 (NVENC) | 8-10+ | 3-5 | Unlimited NVENC sessions |
| RTX 4090 (NVENC) | 15-20+ | 8-10+ | AV1 encoding support |
| Intel Arc A380 (QSV) | 8-10 | 4-5 | AV1 support, good value |
Storage Requirements
Application
FluxPlay application files. SSD recommended for faster startup.
Database
PostgreSQL data. Grows with library size. ~100MB per 1000 items.
Metadata Cache
Posters, backdrops, thumbnails. ~50MB per 100 items with full artwork.
Transcode Cache
Temporary transcoding files. SSD strongly recommended. Auto-cleaned.
Downloads
Based on usage. Videos: 500MB-5GB each. Music: 5-50MB per track.
Logs
Application logs with rotation. Configurable retention period.
Network Requirements
Bandwidth Requirements by Quality
| Quality | Min Bandwidth | Recommended |
|---|---|---|
| 480p SD | 3 Mbps | 5 Mbps |
| 720p HD | 5 Mbps | 10 Mbps |
| 1080p Full HD | 10 Mbps | 20 Mbps |
| 4K SDR | 25 Mbps | 50 Mbps |
| 4K HDR | 40 Mbps | 80 Mbps |
Required Ports
5171FluxPlay web interface (HTTP)5172FluxPlay web interface (HTTPS)5432PostgreSQL (internal only)6379Redis (internal only)9090Metrics endpoint (optional)Network Recommendations
- Wired Ethernet preferred over WiFi
- Gigabit LAN for multiple 4K streams
- Low latency connection to storage
- Stable upload speed for remote access
Client Requirements
Web Browser
- Chrome 90+
- Firefox 88+
- Safari 14+
- Edge 90+
Android
- Android 8.0+
- 2GB RAM
- ARMv8 or x86_64
iOS / iPadOS
- iOS 14.0+
- iPhone 7 or newer
- iPad Air 2 or newer
TV / Streaming
- Android TV 9+
- Fire TV 2nd gen+
- Roku (coming soon)
Quick Sizing Guide
Personal Use
Any modern PC, 4GB RAM, integrated graphics
Family Server
i5/Ryzen 5, 8GB RAM, GTX 1650 or Intel iGPU
Power User / Sharing
i7/Ryzen 7, 16GB RAM, RTX 3060 or better