Deploy a Relay and Connect Clients

LetUsMsg is built around ephemeral relays: lightweight binaries that live in memory, rotate often, and keep your data off disk. You host the relay you trust, and every client (macOS, iOS, Android, Windows, Linux) connects to it using your invite code and PIN.

What You Need

• A relay you control: grab the latest build for your platform on the Relay page.
• A client for your OS: macOS, iOS, Android, Windows, and Linux all connect to the same relay. Android users can download the beta on the Android page.

Quick Path

1. Download the relay binary for your architecture from Relay.
2. Start it with (WIP) Docker Compose or Kubernetes using the templates on the Relay page.
3. Launch your client, enter the details of the new Relay, add finally add to a Relay Pool
4. Create a new Chat Space, share the invite code, and begin chatting.

How Clients Use Relays

• Clients mutually authenticate to your relay over HTTP/2 + mTLS.
• Messages live in memory only; relay TTLs rotate on default schedules.
• All platforms share the same pairing flow (invite + PIN) against the relay you run.

Relay Lifecycle at a Glance

• Default relay TTL: 7 days (auto-rotates).
• Grace period: 48 hours for overlapping pulls.
• Message TTL: 72 hours.
• Cipher rounds: 100 by default.

Next Steps

• Download binaries and deployment manifests: visit the Relay page.
• Compare LUM with alternatives: see Compare.
• Install the Android beta: go to the Android page.