Deployment Overview & Architecture
RUSEON Core is an ultra-portable, single-binary video infrastructure engine with zero external runtime dependencies. Whether deploying on edge ARM64 gateways, standalone Linux servers, or scalable container clusters, RUSEON provides predictable resource consumption and minimal CPU footprint.
Deployment Methods Comparison
| Deployment Method | Best Suited For | Key Advantages | Considerations |
|---|---|---|---|
| Docker Compose | Homelab, single-server production, edge nodes | Declarative configuration, automated restart, isolated volumes | Requires Docker daemon |
| Standalone Docker | Kubernetes, Nomad, container clusters | Immutable images, standardized CI/CD deployment | Manual port & volume configuration |
| Systemd Binary | Bare-metal servers, embedded Linux, edge SBCs | Absolute lowest latency, direct kernel I/O access, 0 overhead | Requires manual systemd service configuration |
| Direct Exposure | Isolated appliances, direct IP setups | Zero reverse-proxy latency, simplified WebRTC ICE | Requires opening ports directly |
| Reverse Proxy | Multi-service hosts, enterprise DMZ | Automated Let's Encrypt TLS, domain routing, WAF | Must configure WebSocket & WHEP headers properly |
Persistent Storage Architecture
RUSEON Core maintains strict separation of storage concerns across three directories:
- State Store (
/app/data/db): Embedded BadgerDB v4 database storing camera configurations, users, JWT secrets, and archive metadata. Must be placed on fast SSD/NVMe storage. - Video Archive (
/app/recordings): Hierarchical fMP4 video files ({camera}/{YYYY}/{MM}/{DD}/{HH}/*.mp4). Can be mounted on high-capacity HDDs, SATA SSDs, or NAS/SAN arrays. - Backup Directory (
/app/backups): Scheduled daily BadgerDB snapshots for disaster recovery.
Deployment Guide Sections
- Docker Deployment: Running official container images with volume mounts and environment variables.
- Docker Compose Setup: Production compose recipes with healthchecks, logging, and restart policies.
- Standalone Binary & Systemd: Running native Go binaries as background Linux systemd services.
- Production Hardening Checklist: Kernel sysctl tuning, ulimits, firewall configuration, and TLS certificates.
- Storage Planning & IOPS: Calculating disk bandwidth, filesystem formatting, and mount parameters.
- Reverse Proxy Setup (Nginx/Caddy): Configuring HTTPS, WebSocket proxying, and WHEP endpoints.
- Direct Public Exposure: Securing standalone RUSEON instances directly on public IP addresses.
- Network Architecture & Ports: Complete port matrix, WebRTC ICE candidate range, and firewall rules.