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:
| Port | Type | Purpose |
|---|---|---|
6666 | UDP | UE5 Multi-User Editing discovery relay (UDP Messaging). |
6667 | TCP/HTTP | Relay status / monitoring page and /status JSON endpoint. |
6668 | TCP | MUE Sync introducer: the channel agents use to discover each other. |
Agent discovery flow
- Each agent connects to
MUE_RELAY_HOST:MUE_RELAY_PORT(the introducer on 6668). - It sends
{"t":"hello","id":...,"port":6670,"host":<TailscaleIP>}. - The introducer replies with
{"t":"peers",...}and broadcastsannounceframes so every peer learns about every other peer's Tailscale IP and P2P port. - Agents then open direct TCP connections to each other's
6670on 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.