How It Works - Standard
Install Client
Grab the client for your platform: iOS, Android, macOS, Windows, or Linux. To begin chatting quickly you only need an invite code. All chat spaces can be shared quickly from the app and all details (relays) are included.
Accept Invite Code
Someone shares an invite code with you and apply that inside the app. On iOS you can tap the invite code for a seamless experience.
Chat Securely
Participants join the chat space. Every chat space participant sets their own alias. There is no address book, phone numbers, usernames, etc; no PII data. Messages flow through RAM, then vanish.
Download a client
- A client for your OS: Android page, macOS page, Windows page, iOS (Testflight), Linux (TBD).
Deploy a Relay (Pro Feature)
How It Works - With Personal Relay
Install Client
Grab the client for your platform: iOS, Android, macOS, Windows, or Linux.
Deploy a Relay
Deploy the relay to a local server isolated from the public Internet, or deploy to any cloud server.
Add Relay
Within the app add a new Relay with the network details and select a Relay Pool (or create a new one).
Create Chat Space with Relay
Create a new chat space utilizing your new Relay. Share a chat space by invite code which includes all details for participants to access your Relay and converse in the new chat space.
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 (iOS, Android, macOS, Windows, Linux) connects to relay(s) for the ultimate private messaging experience. Create a new chat space and share with anyone using an invite code.
What You Need
- A relay you control: grab the latest build for your platform on the Relay page.
- A client for your OS: Android page, macOS page, Windows page, iOS (Testflight), Linux (TBD).
Quick Path
- Download the relay binary for your architecture from Relay.
- The relay is a simple binary, run in tmux for basic testing, run in a wrapped service for advanced users.
- 2a. (WIP) Start it with Docker or Kubernetes using the templates on the Relay page. Docker Compose coming soon.
- 2b. Do not forget to configure firewalls on server and your router if you want public access (access outside your internal network)
- Launch your client, enter the details of the new Relay, add finally add to a Relay Pool
- 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.