MUE SyncFeaturesHow It WorksSetupDocsFAQDownload

Relay + Server Setups

How the relay, introducer, and P2P mesh fit together (for admins).

This page is for the ECHO RUN server administrator. Artists do not usually need any of this, but if you host your own relay, here is how it fits together.

What the relay does

The MUE relay box has three services:

PortTypePurpose
6666UDPUE5 Multi-User Editing discovery relay (UDP Messaging).
6667TCP/HTTPRelay status / monitoring page and /status JSON endpoint.
6668TCPMUE Sync introducer: the channel agents use to discover each other.

Agent discovery flow

  1. Each agent connects to MUE_RELAY_HOST:MUE_RELAY_PORT (the introducer on 6668).
  2. It sends {"t":"hello","id":...,"port":6670,"host":<TailscaleIP>}.
  3. The introducer replies with {"t":"peers",...} and broadcasts announce frames so every peer learns about every other peer's Tailscale IP and P2P port.
  4. Agents then open direct TCP connections to each other's 6670 on the Tailscale network.

The relay is only involved in finding peers. Once peers know each other, file bytes travel directly between artists and never pass through the relay.

Status endpoint

The landing page fetches relay status from the relay. You can hit it directly:

curl http://100.123.2.61:6667/status

It returns JSON with the number of connected peers and a peer list. The landing page's Live Relay Status widget uses the same data via the /relay-status proxy.

P2P ports and firewall

On each artist machine, the agent listens on MUE_SYNC_PORT (6670). Peers connect to this port over Tailscale. Because Tailscale is a VPN, its own rules control access; the relay box's 6668 must accept incoming TCP on the tailnet, and each artist's 6670 must accept incoming TCP.

Port forwarding note

These services run on the edge gateway and are reachable over the team's Tailscale network. Public port forwarding for the landing site is handled by nginx proxy manager and the gateway's NAT rules (see ~/routes.sh on the server). UDP 6666 additionally needs the router to forward it to the gateway box so Unreal's built-in discovery works.