Skip to content

ADR-0005 Edge Media Synchronization

Accepted.

FreeSWITCH must play prompts/voicemail with low latency and no dependency on a central round-trip during a call, while recordings captured at the edge need to land in durable central storage.

Sync media to the edge with a manifest-driven process run by the node agent: pull needed/changed assets down to EDGE_MEDIA_ROOT, and upload recordings up to central storage. EDGE_MEDIA_ROOT must match the control plane’s expectation so asset paths resolve.

  • Local playback is fast and resilient to central hiccups.
  • Only needed assets transfer (manifest diff), saving bandwidth.
  • A mismatched EDGE_MEDIA_ROOT breaks path resolution; keep it in sync.