Overview

The system uses distributed workers to process video rendering (FFmpeg) tasks. These agents run on separate Linux servers and communicate via HTTP callbacks.

---

Installation

1. Provision a Ubuntu 20.04/22.04 Server (2 vCPU, 4GB RAM minimum).
2. Go to Admin > Infrastructure > Workers.
3. Click Deploy Worker.
4. Enter the SSH Credentials (Host, Port, User, Private Key).
   Note: SSH Keys are used transiently to run the install script and are NOT stored.
5. The system will SSH into the server, install FFmpeg, Python3, and the Worker Agent service.

---

Security

• Communication: Workers receive tasks via encrypted payloads or direct download URLs.
• Callbacks: Workers post status updates to `/api/worker/video/{video}/complete` signed with a dedicated secret_key.
• SSH: SSH access is only needed for initial setup and updates. Credentials must be re-supplied for updates.

---

Troubleshooting

If a worker goes offline:

• Check Worker Logs in Admin > Logs.
• Verify the video-worker service on the node: systemctl status video-worker.
• Ensure the worker can reach the Main Application URL (check firewalls).